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 MCPCodex 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 构建并托管。