Codex.io Docs MCP Server
官方用于读取Codex加密数据API的MCP，使代理能够编写GraphQL查询。
文档
Codex Docs MCP
将 Codex 文档 MCP 服务器添加到你的 AI 编码工具中，即可即时访问 API 文档。
Codex 文档以 模型上下文协议 (MCP) 服务器的形式提供。将其添加到你的 AI 编码工具后，它可以直接搜索和引用 Codex API 文档，让你无需离开编辑器就能获得准确的答案。
https://docs.codex.io/mcp
它能做什么
连接后，你的 AI 工具可以搜索完整的 Codex API 文档——包括查询、订阅、类型和指南。当你询问有关 Codex API 的问题或需要帮助编写查询时，它会自动引用文档。
此 MCP 服务器用于搜索文档并帮助你的 AI 编写查询。它不直接与 Codex API 交互——你仍然需要通过 [GraphQL 端点](/learn-graphql) 或 [SDK](/sdk) 使用你的 API 密钥来执行查询。Docs MCP 与 Codex Skills 的对比
Codex Skills 为你的 AI 代理提供预加载的 API 知识，使其能够直接与 API 交互。Docs MCP 则让它能够搜索文档，从而可以编写 GraphQL 查询。
| Docs MCP | Codex Skills | |
|---|---|---|
| 工作原理 | 通过 MCP 协议按需搜索文档 | 预加载的 API 知识——操作、认证、模板 |
| 最适合 | 查找特定字段、类型或指南 | 直接与 Codex API 交互 |
| 需要网络？ | 是——查询 MCP 服务器 | 离线编写查询（调用 API 时仍需网络连接） |
同时使用两者可获得最佳体验：Skill 处理查询生成，MCP 在需要时补充细节。
设置
使用 `Cmd+Shift+P` (Mac) 或 `Ctrl+Shift+P` (Windows/Linux) 打开 MCP 设置，然后选择 **Cursor Settings: Open MCP Settings**。添加以下内容：```json theme={null}
{
"mcpServers": {
"codex-docs": {
"url": "https://docs.codex.io/mcp"
}
}
}
```
```json theme={null}
{
"servers": {
"codex-docs": {
"type": "http",
"url": "https://docs.codex.io/mcp"
}
}
}
```
```json theme={null}
{
"mcpServers": {
"codex-docs": {
"serverUrl": "https://docs.codex.io/mcp"
}
}
}
```
* **Name:** Codex Docs
* **URL:** `https://docs.codex.io/mcp`
```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```
示例提示
一旦 MCP 连接成功，你可以要求你的 AI 助手使用 Codex API 构建功能。以下是一些入门示例。
获取代币价格
"使用 Codex API 获取以太坊上 WETH 的当前美元价格。"
你的助手将查找 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 K 线数据：
So11111111111111111111111111111111111111112。"
query {
getBars(
symbol: "So11111111111111111111111111111111111111112:1399811149"
from: 1719792000
to: 1719878400
resolution: "60"
) {
o
h
l
c
volume
t
}
}
流式传输实时交易
"设置一个 WebSocket 订阅，以流式传输以太坊上某个代币的实时交换事件。"
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 上过去一小时内发行且流动性至少为 1 万美元的代币。"
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
}
}
}