Codex.io Docs MCP
官方用于读取Codex加密数据API的MCP,使代理能够编写GraphQL查询。
你可以用 Codex Io Docs MCP 做什么?
- 搜索 Codex API 文档 — 编写代码时,让助手从 Codex 文档中查找查询、订阅、类型和指南。
- 编写 GraphQL 查询 — 描述你需要的数据,让助手参考文档起草相应的 Codex GraphQL 查询。
- 查找字段和类型 — 让助手在 Codex API 文档中查找特定字段、参数或类型定义。
- 按需参考指南 — 执行任务时,让助手从文档中调取相关的 Codex 指南或示例。
文档
Codex Docs MCP
将 Codex 文档 MCP 服务器添加到 Claude Code、Cursor 和其他 AI 编程工具中,让它们在你开发时搜索 Codex API 文档。
Codex 文档可通过 Model Context Protocol (MCP) 服务器访问。将它添加到你的 AI 编程工具后,工具便可直接搜索和引用 Codex API 文档,让你无需离开编辑器即可获得准确的答案。
https://docs.codex.io/mcp
功能介绍
连接后,你的 AI 工具便可搜索完整的 Codex API 文档,包括查询、订阅、类型和指南。当你询问 Codex API 相关问题或需要编写查询时,它会自动引用文档。
[!NOTE]
此 MCP 服务器用于搜索文档并帮助 AI 编写查询。它不会直接与 Codex API 交互——你仍需使用 API 密钥,通过 GraphQL endpoint 或 SDK 执行查询。
Docs MCP 与 Codex Skills
Codex Skills 会为你的 AI 代理预加载 API 知识,让它能够直接与 API 交互。Docs MCP 则让它搜索文档,从而帮助它编写 GraphQL 查询。
| Docs MCP | Codex Skills | |
|---|---|---|
| 工作方式 | 通过 MCP 协议按需搜索文档 | 预加载 API 知识——操作、身份验证、模板 |
| 最适合 | 查找特定字段、类型或指南 | 直接与 Codex API 交互 |
| 需要网络连接? | 是——查询 MCP 服务器 | 可离线编写查询(调用 API 时仍需连接) |
同时使用两者可获得最佳体验:skill 负责生成查询,MCP 则在需要时补充详细信息。
设置
[!NOTE]
Codex (codex.io) 是一个区块链数据 API,不是 OpenAI Codex 编程代理。你仍可将此 MCP 服务器添加到 OpenAI Codex,如下所示。
[tab] Cursor
使用
Cmd+Shift+P(Mac)或Ctrl+Shift+P(Windows/Linux)打开 MCP 设置,然后选择 Cursor Settings: Open MCP Settings。添加以下内容:{ "mcpServers": { "codex-docs": { "url": "https://docs.codex.io/mcp" } } }
[tab] VS Code
在项目根目录中创建
.vscode/mcp.json文件:{ "servers": { "codex-docs": { "type": "http", "url": "https://docs.codex.io/mcp" } } }
[tab] Windsurf
打开位于
~/.codeium/windsurf/mcp_config.json的 MCP 配置文件,并添加以下内容:{ "mcpServers": { "codex-docs": { "serverUrl": "https://docs.codex.io/mcp" } } }
[tab] Claude Desktop
前往 Settings > Connectors,选择 Add custom connector,然后输入:
- Name: Codex Docs
- URL:
https://docs.codex.io/mcp
[tab] Claude Code
运行以下命令:
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
[tab] OpenAI Codex
运行:
codex mcp add codex-docs --url https://docs.codex.io/mcp或将以下内容添加到
~/.codex/config.toml:[mcp_servers.codex-docs] url = "https://docs.codex.io/mcp"
示例提示词
连接 MCP 后,你可以让 AI 助手使用 Codex API 构建功能。以下是一些入门示例。
获取代币价格
“使用 Codex API 获取 WETH 在 Ethereum 上当前的 USD 价格。”
你的助手会查找 getTokenPrices 查询,并编写类似以下内容:
query {
getTokenPrices(
inputs: [
{
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
}
]
) {
address
priceUsd
}
}
构建热门代币动态
“告诉我如何获取 Base 上按 24 小时交易量排序的前 10 个热门代币。”
query {
filterTokens(
filters: { network: [8453] }
rankings: [{ attribute: volume24, direction: DESC }]
limit: 10
) {
results {
token {
name
symbol
address
}
volume24
priceUSD
change24
}
}
}
绘制价格图表
“获取此 Solana 代币过去 24 小时的 1 小时 OHLCV 蜡烛图:
So11111111111111111111111111111111111111112。”
query {
getBars(
symbol: "So11111111111111111111111111111111111111112:1399811149"
from: 1719792000
to: 1719878400
resolution: "60"
) {
o
h
l
c
volume
t
}
}
实时推送交易
“设置 WebSocket 订阅,以实时推送 Ethereum 上某个代币的兑换事件。”
subscription {
onEventsCreated(
address: "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
networkId: 1
) {
address
networkId
events {
eventDisplayType
timestamp
maker
token0SwapValueUsd
token1SwapValueUsd
transactionHash
}
}
}
跟踪钱包持仓
“获取 Base 上某个钱包的所有代币余额。”
query {
balances(
input: {
walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
networks: [8453]
}
) {
items {
tokenAddress
balance
shiftedBalance
token {
name
symbol
}
}
}
}
发现新上线代币
“查找过去一小时内在 Solana 上线且流动性至少为 $10k 的代币。”
query {
filterTokens(
filters: {
network: [1399811149]
liquidity: { gte: 10000 }
createdAt: { gte: 1719874800 }
}
rankings: [{ attribute: createdAt, direction: DESC }]
limit: 20
) {
results {
token {
name
symbol
address
}
liquidity
priceUSD
createdAt
}
}
}
[!TIP]
无需记住这些内容——只需描述你的需求,AI 助手就会从文档中查找合适的查询。以上示例仅用于展示可实现的功能。
本文档使用面向开发者的文档平台 Mintlify 构建并托管。