cambrian-api

Cambrian API MCP

Cambrian API 的 Model Context Protocol 服务。它为需要实时 DeFi、社交情报、风险和 API 文档工具的 Agent 提供与 cambrian CLI 相同的产品功能。

每次调用都需要调用方提供 Cambrian API 密钥。托管服务和本地包都需要密钥；服务绝不会提供或代理共享密钥。 请在 https://console.cambrian.org/ 创建密钥。若要在没有 API 密钥的情况下使用 x402 按次付费访问， 请运行 cambrian pay --help；MCP 传输仍需要调用方提供密钥。

你将获得

• 渐进式默认配置，为每个公开的 Cambrian API 端点提供一个简洁工具
• 适用于不同工具加载行为客户端的精简和完整配置
• 用于 Solana 代币快照的组合工作流工具
• cambrian_docs，可获取来自 https://docs.cambrian.org/llms.txt 的实时端点和指南文档
• 面向本地 MCP 客户端的 stdio 传输
• 面向托管和可自托管部署的 Streamable HTTP 传输

工具配置

配置	stdio	HTTP	工具元数据
渐进式（默认）	不带标志，或 --profile progressive	/mcp	直接端点工具，包含类型、必填字段、标量枚举、OpenAPI 默认值、数值范围和数组项类型。
精简	--profile compact	/mcp/compact	三个工具：cambrian_docs、cambrian_call 和 cambrian_solana_token_snapshot。
完整	--profile full	/mcp/full	直接端点工具，包含完整请求说明、默认值、约束和响应大小控制。

所有配置都采用相同的渐进式文档流程。默认情况下，cambrian_docs 会返回请求架构。将 detail 设为 response 可获取响应字段。响应视图也包含请求 架构。只有在需要示例和所有端点说明时，才将 detail 设为 full。完整配置不会预加载每个端点的响应文档。

渐进式配置会省略重复的端点说明、较长的模式、大型数组枚举和参数说明。 如需这些详细信息，请调用 cambrian_docs。

渐进式配置还会省略 offset、order_asc 和 order_desc。所有包含这三个参数的端点都使用相同定义；而且渐进式配置已移除各端点的可排序列枚举，因此重复这些参数会让工具列表增加约 10 kB，却不会为 Agent 提供任何新信息。服务说明中会统一列出这些参数，每个端点仍接受它们。limit 会保留及其最大值，因为 Agent 可用它限制响应大小。

工具集

整个目录共有 159 个工具。只询问 Solana 的 Agent 仍要加载 116 个永远不会调用的 EVM 工具。使用 --toolsets 仅加载所需工具。

工具集	工具
solana	cambrian_solana_* 和 Solana 代币快照
evm	cambrian_base_*、cambrian_ethereum_*、cambrian_arbitrum_* 和 cambrian_robinhood_*
deep42	cambrian_deep42_*
risk	cambrian_risk_*

npx -y cambrian-api-mcp --toolsets solana,risk
CAMBRIAN_TOOLSETS=solana npx -y cambrian-api-mcp

通过 HTTP 可按请求选择：https://mcp.cambrian.org/mcp?toolsets=solana。

省略该选项或传入 all，即可获取所有工具。cambrian_docs 始终可用，因此即使客户端缩小了工具范围，仍可发现并阅读任何端点的相关信息。

渐进式配置的 tools/list 大小：

选择	工具	字节
默认（全部）	159	39,571
evm	117	28,158
solana	37	10,904
deep42	6	3,663
risk	2	2,093

MCP 客户端如何加载工具

MCP 客户端会接收所选配置的完整 tools/list 结果。MCP 不会控制该结果有多少内容会进入模型上下文。

Claude Code 通常会先加载工具名称和服务端说明。使用 Tool Search 后，它会加载完整的所选工具定义。Tool Search 功能可用时，Codex 也可以采用相同方式。其他客户端可以在启动时加载所有工具定义。

客户端会从所选配置加载定义。Progressive 省略的字段不会被恢复。使用 cambrian_docs 加载完整的请求架构、响应字段和示例。

Agent 技能

新用户和 Agent 运行时应从这里开始：skills/cambrian-mcp/SKILL.md。本文档涵盖 Cambrian API 密钥身份验证、托管和本地客户端配置、工具命名、cambrian_docs 查找、组合工具、响应限制和错误处理。

如需使用 CLI 而非 MCP，请参阅 cambrian CLI 技能。

通过 CLI 推荐的设置方式

cambrian CLI 可以输出并测试可直接使用的 MCP 客户端配置：

npm install -g cambrian
cambrian mcp config --mode hosted
cambrian mcp config --mode local
cambrian mcp install --client claude --mode hosted
cambrian mcp test --mode hosted

本地 stdio

直接运行已发布的软件包：

export CAMBRIAN_API_KEY=<your-api-key>
npx -y cambrian-api-mcp

仅当 MCP 客户端需要时，才选择其他配置：

npx -y cambrian-api-mcp --profile compact
npx -y cambrian-api-mcp --profile full

将目录范围缩小到所需的工具集：

npx -y cambrian-api-mcp --toolsets solana,risk

或者全局安装：

npm install -g cambrian-api-mcp
export CAMBRIAN_API_KEY=<your-api-key>
cambrian-api-mcp

托管式 Streamable HTTP

使用 CLI 输出当前托管 URL 和特定客户端的配置：

cambrian mcp config --mode hosted

直接配置 Claude：

claude mcp add --transport http cambrian \
  https://mcp.cambrian.org/mcp \
  --header "Authorization: Bearer YOUR_CAMBRIAN_API_KEY"

Codex 配置使用 TOML：

[mcp_servers.cambrian]
url = "https://mcp.cambrian.org/mcp"
bearer_token_env_var = "CAMBRIAN_API_KEY"

默认 URL 使用 progressive 配置。如需其他配置，请使用 https://mcp.cambrian.org/mcp/compact 或 https://mcp.cambrian.org/mcp/full。

HTTP 请求必须包含以下其中一项：

Authorization: Bearer <CAMBRIAN_API_KEY>
X-Cambrian-Api-Key: <CAMBRIAN_API_KEY>

自托管 HTTP

npm install
npm run build
node dist/index.js --transport http --host 127.0.0.1 --port 8080

健康检查端点：

curl http://127.0.0.1:8080/health

对于托管部署，请绑定到 0.0.0.0：

node dist/index.js --transport http --host 0.0.0.0 --port 8080

工具名称

工具名称为规范名称，并以 cambrian_ 为前缀。

示例：

• cambrian_base_dexes
• cambrian_ethereum_dexes
• cambrian_arbitrum_dexes
• cambrian_robinhood_dexes
• cambrian_solana_price_current
• cambrian_deep42_social_data_alpha_tweet_detection
• cambrian_risk_perp_risk_engine
• cambrian_docs
• cambrian_solana_token_snapshot

不带路径调用 cambrian_docs，即可发现实时根索引；也可以使用 guides/<slug>（例如 guides/x402）访问其中列出的任意指南。对于端点路径，省略 detail 即可获取其请求架构。使用 detail: "response" 获取响应字段，使用 detail: "full" 获取示例和所有端点说明。

端点工具来自与 CLI 相同的、经过验证的运行时注册表。MCP 会在每次工具列表或工具调用请求时重新检查本地缓存；对 OpenAPI 的网络尝试会合并处理，并限制为每个来源每 15 分钟最多一次。如果无法进行运行时发现，服务会使用随已安装的 cambrian 包一同提供的端点元数据（cambrian/metadata）。工具名称、架构和参数验证均来自 cambrian/tools，因此每个工具发送的请求都与对应的 cambrian CLI 命令相同。

API 提供一个通用的 /api/v1/evm/* 接口，其 chain_id 参数列出各端点支持的链。MCP 会将其转换为每条受支持链对应的固定链工具，因此 Agent 无需记住特定数字，也无法将端点指向其不支持的链：

链	Id	工具前缀
Base	8453	cambrian_base_*
Ethereum	1	cambrian_ethereum_*
Arbitrum	42161	cambrian_arbitrum_*
Robinhood Chain	4663	cambrian_robinhood_*

当且仅当端点自身的 chain_id 架构允许某条链时，该链才会显示对应工具——依据可以是其 enum、固定的 minimum/maximum 数值对，或排他边界。没有允许列表，也没有针对单个端点的特殊处理：如果 API 扩展某个端点，使其支持另一个已注册的链 ID，那么在下次加载元数据时，该端点就会获得对应链的工具。Base 工具将 chain_id 固定为 8453，Ethereum 工具固定为 1，Arbitrum 工具固定为 42161，Robinhood 工具固定为 4663。

cambrian_docs 支持在 EVM 路径中使用可选的链段，可填写 ID 或别名：evm/42161/dexes、evm/arbitrum/dexes 和 evm/dexes 都会解析到同一端点，其中带链范围的路径会返回该链固定的架构。Robinhood 路径也接受 evm/4663/dexes 和 evm/robinhood/dexes。

链表来自 cambrian CLI（cambrian/tools 中的 EVM_CHAINS）。src/server.ts 仅添加 cambrian_docs 路径别名。若要添加一条链，请将其添加到 CLI，发布 CLI，然后在此处升级 cambrian。

开发

npm ci
npm test
npm run build
npm pack --dry-run

该软件包依赖已发布的 cambrian 包，以共享元数据和 API 客户端。若同时更改两个软件包，请先发布 cambrian，然后刷新此软件包的锁文件，并通过 CI/CD 部署 MCP 服务。

部署

部署通过 GitHub Actions 和 Cloud Run 从私有源代码仓库执行。请勿手动部署。

工作流：

1. 安装依赖
2. 验证 package.json#mcpName 与 server.json#name 是否一致
3. 验证 package.json#version 与 server.json#version 是否一致
4. 构建并测试
5. 构建 Docker 镜像
6. 部署到 Cloud Run
7. 直接对暂存环境进行冒烟测试；生产环境则在 DNS 和证书激活后，通过公共边缘 URL 进行冒烟测试

注册表

官方 MCP Registry 以下列名称发布此服务：

io.github.cambriannetwork/cambrian-api

清单使用 https://mcp.cambrian.org/mcp，与生产环境的边缘 URL 一致。公共发布工作流会在 npm 发布后发布每个新的 Registry 版本。