Codex.io Docs MCP

官方

用于读取Codex加密数据API的MCP，使代理能够编写GraphQL查询。

访问 codex.io试用此 MCP赞助

你可以用 Codex Io Docs MCP 做什么？

  • 搜索 Codex API 文档 — 让您的助手通过 https://docs.codex.io/mcp 查阅完整的 Codex 文档中的查询、订阅、类型或指南。
  • 生成 GraphQL 查询 — 让您的助手用自然语言描述需求，即可编写查询，例如获取代币价格、热门代币或钱包余额。
  • 构建实时数据功能 — 请求 WebSocket 订阅以流式传输实时交换事件，或使用 OHLCV 蜡烛图数据跟踪代币价格图表。
  • 发现新代币 — 直接从文档中根据启动时间、流动性或交易量等条件请求筛选后的代币列表。

文档

Codex Docs MCP

将 Codex 文档 MCP 服务器添加到你的 AI 编码工具中，即可即时访问 API 文档。

Codex 文档以 Model Context Protocol（MCP）服务器的形式提供。将其添加到你的 AI 编码工具中，它就可以直接搜索并引用 Codex API 文档，让你无需离开编辑器即可获得准确答案。

https://docs.codex.io/mcp

功能说明

连接后，你的 AI 工具可以搜索完整的 Codex API 文档——包括查询、订阅、类型和指南。当你询问有关 Codex API 的问题或需要帮助编写查询时，它会自动引用文档。

信息

此 MCP 服务器用于搜索文档并帮助你的 AI 编写查询。它不直接与 Codex API 交互——你仍然需要使用你的 API 密钥通过 GraphQL 端点 或 SDK 执行查询。

Docs MCP 与 Codex Skills 的对比

Codex Skills 为你的 AI 代理提供预加载的 API 知识，使其能够直接与 API 交互。Docs MCP 则允许它搜索文档，从而帮助它编写 GraphQL 查询。

Docs MCPCodex Skills
工作原理通过 MCP 协议按需搜索文档预加载的 API 知识——操作、认证、模板
最适合查找特定字段、类型或指南直接与 Codex API 交互
需要网络？是——查询 MCP 服务器可离线编写查询（调用 API 时仍需网络连接）

建议两者结合使用以获得最佳体验：Skills 负责查询生成，MCP 在需要时补充细节。

设置

注意

Codex（codex.io）是一个区块链数据 API。它不是 OpenAI Codex（编码代理）。你仍然可以将此 MCP 服务器添加到 OpenAI Codex 中，如下所示。

使用 `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"
    }
  }
}
```
在项目根目录创建 `.vscode/mcp.json` 文件： 
```json theme={null}
{
  "servers": {
    "codex-docs": {
      "type": "http",
      "url": "https://docs.codex.io/mcp"
    }
  }
}
```
打开位于 `~/.codeium/windsurf/mcp_config.json` 的 MCP 配置文件并添加以下内容： 
```json theme={null}
{
  "mcpServers": {
    "codex-docs": {
      "serverUrl": "https://docs.codex.io/mcp"
    }
  }
}
```
前往 **Settings > Connectors**，选择 **Add custom connector**，然后输入： 
* **名称：** Codex Docs
* **URL：** `https://docs.codex.io/mcp`
运行以下命令： 
```bash theme={null}
claude mcp add --transport http codex-docs https://docs.codex.io/mcp
```
运行： 
```bash theme={null}
codex mcp add codex-docs --url https://docs.codex.io/mcp
```

或者将其添加到 `~/.codex/config.toml`：

```toml theme={null}
[mcp_servers.codex-docs]
url = "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 蜡烛图数据：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
    }
  }
}

提示

你无需记住任何这些内容——只需描述你的需求，你的 AI 助手就会从文档中查找正确的查询。以上示例仅用于展示可能的功能。

本文档由 Mintlify 构建和托管，这是一个开发者文档平台。