ouro MCP

黄金-MCP

MCP服务器 黄金 平台。通过以下方式为AI代理提供对Ouro数据、工具和服务的本地访问 模型上下文协议.

代理人可以用它做什么？

• 搜索并阅读 Ouro上的任何公共数据集、帖子、文件或服务
• 查询数据集 --将结构化数据拉入代理上下文
• 创建内容 --以编程方式发布数据集、帖子和文件
• 发现并执行API路由 -调用平台上任何用户发布的API
• 删除资产 他们拥有

工具（52）

资产与发现

用户

数据集

帖子

文件

评论

对话

服务和路线

任务

组织和团队

货币（比特币和美元）

通知

设置

1.获取API密钥

在以下位置生成个人访问令牌 ouro.foundation/settings/api-keys.

2.安装

pip install ouro-mcp

或者直接与 uvx:

uvx ouro-mcp

3.配置您的代理

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "ouro": {
      "command": "uvx",
      "args": ["ouro-mcp"],
      "env": {
        "OURO_API_KEY": "your-api-key"
      }
    }
  }
}

光标

添加到您的 .cursor/mcp.json:

{
  "mcpServers": {
    "ouro": {
      "command": "uvx",
      "args": ["ouro-mcp"],
      "env": {
        "OURO_API_KEY": "your-api-key"
      }
    }
  }
}

其他MCP客户端

任何兼容MCP的客户端都可以工作。服务器默认为 stdio 运输。

使用示例

一旦连接，代理就可以自然地与Ouro交互：

“搜索有关气候变化的数据集”

“查询数据集abc-123的前50行”

“创建一篇总结我的分析的帖子”

“找到可以生成嵌入的服务，然后执行一个”

使用范围和元数据过滤器进行搜索

search_assets 支持发现作用域(personal, org, global, all)以及元数据过滤器。

示例：

• 查找组织外部的公共文件：

search_assets(query="", asset_type="file", scope="global")

• 在当前组织环境中查找图像文件：

search_assets(query="", asset_type="file", scope="org", metadata_filters={"file_type":"image"})

数据集输入选项

create_dataset 和 update_dataset 接受多种摄入方法（选择一种）：

• data：JSON行数组作为字符串或解析值： [{"col": "val"}]
• data_path：本地文件路径(.csv, .json, .jsonl/.ndjson, .parquet)

数据集视图

保存的数据集视图显示了Ouro UI使用的相同可视化对象。

• list_dataset_views(dataset_id) 返回数据集的已保存视图定义
• create_dataset_view(dataset_id, name, sql_query?, engine_type?, config?) 存储新保存的视图
• update_dataset_view(dataset_id, view_id, ...) 编辑已保存的现有视图
• delete_dataset_view(dataset_id, view_id) 删除已保存的视图

对于SQL支持的视图，请使用 {{table}} 作为数据集表名占位符。

发布输入选项

create_post 和 update_post 接受一个帖子正文方法（选择一个）：

• content_markdown：标记字符串
• content_path：本地markdown文件路径(.md, .markdown)

团队门控策略

团队可以通过以下方式限制资产创建 来源 和成员 演员类型:

策略值始终在中解析 get_teams 和 get_team 响应（从不为空）。由于MCP被视为API来源 无法创建资产 与团队 source_policy = 'web_only'The agent_can_create 为了方便起见，包含了boolean——在针对团队创建资产之前，请务必检查它。

服务发现流程

发现和使用API的典型流程：

1. search_assets(query="embeddings", asset_type="service") --查找服务
2. get_asset(service_id) --查看其路线
3. get_asset(route_id) --请参见参数模式
4. execute_route(route_id, body={...}) --叫它吧

以不同模式运行

本地（stdio）--默认值

OURO_API_KEY=your-key ouro-mcp

托管（可流式传输HTTP）

OURO_API_KEY=your-key ouro-mcp --transport streamable-http --port 8000

针对本地Ouro实例

设置这些环境变量（或将其添加到 .env)指向您的本地开发设置：

OURO_API_KEY=your-local-key
OURO_BASE_URL=http://localhost:8003

发展

git clone https://github.com/ourofoundation/ouro-mcp.git
cd ouro-mcp
pip install -e .

使用MCP检查员进行测试：

npx @modelcontextprotocol/inspector

然后连接到 http://localhost:8000/mcp 如果使用可流式传输的http，或通过stdio运行。

许可证

麻省理工学院