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 會預先載入 API 知識,讓 AI 代理程式能直接與 API 互動。Docs MCP 則可讓它搜尋文件,進而協助撰寫 GraphQL 查詢。

Docs MCPCodex Skills
運作方式透過 MCP protocol 隨需搜尋文件預先載入 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 上交易量排名前 10 的熱門代幣,並依 24 小時交易量排序。」

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 訂閱,串流 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 建置並託管;Mintlify 是一個開發者文件平台。