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 MCP | Codex 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 是一個開發者文件平台。