Codex.io Docs MCP Server

官方

用於讀取 Codex 加密數據 API 的 MCP,讓代理能撰寫 GraphQL 查詢。

文件

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 互動——您仍需透過 [GraphQL 端點](/learn-graphql)或 [SDK](/sdk) 使用 API 金鑰來執行查詢。

Docs MCP 與 Codex Skills 的比較

Codex Skills 為您的 AI 代理提供預先載入的 API 知識,使其能直接與 API 互動。Docs MCP 則讓它搜尋文件,從而能夠撰寫 GraphQL 查詢。

Docs MCPCodex 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"
    }
  }
}
```
在專案根目錄建立一個 `.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**,然後輸入:
* **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
    }
  }
}
您無需記住任何內容——只需描述您的需求,AI 助理就會從文件中找出正確的查詢。上述範例僅用於展示可能性。