指南

MCP server#

MCP Server 通过 Model Context Protocol 将全部 Market 能力暴露为可直接调用的工具(index-current-price、market-token-ranking、balance-total-value 等),Claude Desktop、Cursor 等任何支持 MCP 的客户端均可自动发现并原生调用,无需任何额外接入代码。Agent 只需一句"查一下以太坊上今天涨幅最大的代币",MCP Server 即可自动完成代币解析、行情拉取、结果汇总的完整链路。

MCP Server 的工具#

  • 行情价格工具dex-okx-index-current-pricedex-okx-index-historical-pricedex-okx-market-pricedex-okx-market-price-chains,跨 20+ 条链的实时与历史指数/DEX 价格。
  • K 线工具dex-okx-market-candlesticksdex-okx-market-candlesticks-history,从 1 分钟到日线的 OHLCV 数据,支持扩展回溯窗口。
  • 代币情报工具dex-okx-market-token-searchdex-okx-market-token-price-infodex-okx-market-token-rankingdex-okx-market-token-holder ,代币发现、元数据、实时指标与持仓集中度分析。
  • 交易数据工具dex-okx-market-trades,任意代币的最新链上交易记录。
  • 余额工具dex-okx-balance-chainsdex-okx-balance-total-token-balancesdex-okx-balance-specific-token-balancedex-okx-balance-total-value,多链钱包余额与 USD 资产组合估值。

快速开始#

for General Claude code#

Markdown
claude mcp add onchainos-mcp https://web3.okx.com/api/v1/onchainos-mcp -t http -H
"OK-ACCESS-KEY: d573a84c-8e79-4a35-b0c6-427e9ad2478d"

for Claude code MCP settings#

Markdown
claude mcp add-json onchainos-mcp '{
"type": "http",
"url": "https://web3.okx.com/api/v1/onchainos-mcp",
"headers": {
"OK-ACCESS-KEY": "d573a84c-8e79-4a35-b0c6-427e9ad2478d"
}
}'

示例交互#

MCP Server 激活后,Agent 可响应以下自然语言查询:

Markdown
OKB 现在多少钱?

# 调用 index-current-price
Markdown
给我 OKB 最近一周的 4 小时 K 线

# 调用 market-candlesticks
Markdown
X-layer 链上现在最热的代币是什么?

# 调用 market-token-ranking
Markdown
X-layer 上持有 USDT 最多的地址是谁?

# 调用 market-token-holder
Markdown
0xd8dA... 这个钱包的总资产价值是多少?

# 调用 balance-total-value