Onchain Data MCP

onchain-data-mcp

为你的 AI 助手提供实时区块链数据：钱包余额、支付、价格、诈骗检查等。免费起步，无需注册。

Claude Desktop 按钮会下载一个双击即可打开的文件，所需内容都已包含在内。 Cursor 和 VS Code 按钮只会添加设置，因此请先安装程序。

onchain-data-mcp 是一个小型程序，可让 Claude、Cursor 和 VS Code 等 AI 应用读取区块链数据。它支持 Ethereum、Base、Arbitrum、Optimism、Polygon、Avalanche、BNB Chain、Robinhood Chain 和 Solana。

它会在幕后为你向约 30 个数据服务（称为“提供方”）请求数据。如果某个服务响应缓慢、繁忙或宕机，它会悄悄改向下一个服务请求。优先使用免费服务，因此你可以免费开始，也无需注册。

这里会用到几个术语：

• MCP 是一种标准，让 Claude 等 AI 应用可以使用外部工具。这个程序是一个“MCP 服务”，也就是 AI 应用可以使用的工具。
• API key 是数据提供方在你注册后提供的一种免费密码。开始使用时不需要它。添加几个 API key 可以让回答更快、更完整。
• 钱包地址是加密货币钱包的公开“账号”，例如 0xd8dA…6045 或 7xKX…9sHc。

目录

• 你可以做什么
• 快速开始
• 连接 AI 应用
• 仪表板
• 密码和密钥
• 数据提供方
• 可用工具
• 实际示例
• 为他人运行
• 故障排除
• 常见问题
• 面向开发者 · 安全性 · 许可证

可执行的操作

用通俗语言向 AI 助手提问。它会选取合适的工具并获取答案。

• 查看钱包。 查看某个钱包持有哪些币和代币，一次性覆盖所有链。 “钱包 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 持有哪些资产？”
• 确认付款。 检查客户是否确实向正确地址支付了正确金额的 USDC。 “交易 0xabc… 是否在 Base 上向我的店铺地址支付了 25 USDC？”
• 保障安全。 检查代币是否是骗局、地址是否列入制裁名单，或稳定币是否正在贬值。 “Solana 上的这个代币是蜜罐吗？” · “USDT 现在还值 1 美元吗？”
• 追踪资金。 获取钱包的交易详情、费用和银行式账单。 “显示我钱包上周收到的款项，以及它们的美元价值。”
• 价格和兑换。 获取多个来源的代币价格、历史价格和兑换报价。 “现在在 Arbitrum 上将 1 ETH 兑换成 USDC，最优价格是多少？”
• 代币化股票。 查询 Robinhood Chain 上的股票代币及其价格。 “Robinhood Chain 上的 Tesla 股票代币价格是多少？”

它只读取数据，只有一种例外：它可以发送由你在自己的钱包中亲自签名的交易。它绝不会持有你的密钥，也绝不会自行转移你的资金。

快速开始

三个步骤，大约五分钟。

1. 安装程序

任选一种。只需安装一次。

Mac 或 Linux（打开 Terminal 应用并粘贴）：

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/madlabs-tech/onchain-data-mcp/releases/latest/download/onchain-data-mcp-installer.sh | sh

Windows（打开 PowerShell 并粘贴）：

powershell -ExecutionPolicy Bypass -c "irm https://github.com/madlabs-tech/onchain-data-mcp/releases/latest/download/onchain-data-mcp-installer.ps1 | iex"

Homebrew（Mac 或 Linux）：

brew install madlabs-tech/tap/onchain-data-mcp

仅适用于 Claude Desktop，无需 Terminal（Mac 和 Windows）：下载 onchain-data-mcp.mcpb 并双击。Claude Desktop 会询问是否设置可选的仪表板密码和提供商密钥。你可以全部留空。然后跳到第 3 步。

docker run -i --rm -v onchain-data-mcp-data:/data ghcr.io/madlabs-tech/onchain-data-mcp:latest --config-dir /config

docker run -d --name onchain-data-mcp -p 127.0.0.1:8787:8787 -v onchain-data-mcp-data:/data -v onchain-data-mcp-config:/config ghcr.io/madlabs-tech/onchain-data-mcp:latest
docker exec onchain-data-mcp onchain-data-mcp password --config-dir /config

cargo build --release -p onchain-data-mcp
# the program is now at target/release/onchain-data-mcp

完成后，打开一个新的 Terminal 窗口并检查是否正常运行：

onchain-data-mcp --version

安装程序会将程序放在主文件夹中的 .cargo/bin 文件夹内（例如 /Users/you/.cargo/bin/onchain-data-mcp，或 Windows 上的 C:\Users\you\.cargo\bin\onchain-data-mcp.exe）。

2. 连接 AI 应用

按照下方连接 AI 应用中适用于你的应用的步骤操作。然后重启应用并向它提问，例如 “你可以读取哪些链？”

3. 打开仪表板

仪表板是 Web 浏览器中的控制面板。打开 AI 应用时，它会在 http://127.0.0.1:8787/dashboard 运行。仪表板受专为你生成的密码保护。 若要查看，请在 Terminal 中运行以下命令（使用第 2 步中使用的同一文件夹）：

onchain-data-mcp password --config-dir ~/.onchain-data-mcp

你会看到类似这样的内容：

Dashboard: http://127.0.0.1:8787/dashboard
Password:  f8460762fe006afc…
One-click login: http://127.0.0.1:8787/dashboard#login=f8460762fe006afc…
Config folder: /Users/you/.onchain-data-mcp
Source: /Users/you/.onchain-data-mcp/dashboard_password

打开一键登录链接即可进入。设置指南会引导你完成其余步骤： 添加密钥、选择工具并连接。

如果你使用的是 Claude Desktop 安装包，文件夹为 ~/.onchain-data-mcp，除非你选择了其他文件夹。

连接 AI 应用

为设置选择一个文件夹，并在所有地方使用它。此处使用 ~/.onchain-data-mcp（主文件夹中名为 .onchain-data-mcp 的文件夹）。将 you 替换为你的用户名。

为什么要使用完整路径？有些应用会从其他位置启动程序，因此像 config 这样的短路径会指向错误的文件夹。完整路径始终有效。

Claude Desktop

1. 打开 Claude Desktop，前往 Settings → Developer → Edit Config。这会打开 claude_desktop_config.json：

   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 将以下内容粘贴进去（保留 "mcpServers" 中已有的其他服务）：

   {
     "mcpServers": {
       "onchain-data": {
         "command": "/Users/you/.cargo/bin/onchain-data-mcp",
         "args": ["--config-dir", "/Users/you/.onchain-data-mcp"],
         "env": {
           "ODM__SERVER__DATA_DIR": "/Users/you/.onchain-data-mcp/data",
           "ALCHEMY_API_KEY": "",
           "HELIUS_API_KEY": ""
         }
       }
     }
   }
   

   • command 是程序所在的位置。使用 which onchain-data-mcp（Mac/Linux）或 where onchain-data-mcp（Windows）查找。Homebrew 会将其放在 /opt/homebrew/bin/onchain-data-mcp。
   • 在 Windows 上，使用类似 "C:\\Users\\you\\.cargo\\bin\\onchain-data-mcp.exe" 的路径（双反斜杠）。
   • 这些密钥为可选项。可以留空、删除，或稍后在控制面板中添加。

3. 完全退出 Claude Desktop，然后重新打开。

Claude Code

claude mcp add onchain-data -e ODM__SERVER__DATA_DIR=$HOME/.onchain-data-mcp/data -- onchain-data-mcp --config-dir $HOME/.onchain-data-mcp

Cursor

点击顶部的 Install in Cursor 按钮，或将以下内容粘贴到 ~/.cursor/mcp.json （也可以放在某个项目内的 .cursor/mcp.json），然后在 Cursor Settings → MCP 中启用：

{
  "mcpServers": {
    "onchain-data": {
      "command": "/Users/you/.cargo/bin/onchain-data-mcp",
      "args": ["--config-dir", "/Users/you/.onchain-data-mcp"],
      "env": { "ODM__SERVER__DATA_DIR": "/Users/you/.onchain-data-mcp/data" }
    }
  }
}

VS Code

点击顶部的 Install in VS Code 按钮。若要使用你的设置文件夹，请在 VS Code 中打开 MCP 设置，并添加 "args": ["--config-dir", "/Users/you/.onchain-data-mcp"]。

其他应用（通过 Web 地址）

如果程序已经在运行（例如由其他应用启动，或通过 onchain-data-mcp serve 启动），任何支持通过 HTTP 使用 MCP 的应用都可以连接到：

http://127.0.0.1:8787/mcp

控制面板的 Connect 页面会显示可直接复制的设置，并自动填入你的实际路径。

控制面板

你的控制面板位于 http://127.0.0.1:8787/dashboard。只有你自己的计算机可以打开它。

	登录。 输入控制面板密码，或使用 onchain-data-mcp password 提供的一键链接。
	设置指南。 三个步骤：添加密钥、选择工具、连接 AI 应用。
	概览。 一切是否正常？还可查看实时调用列表（从上次启动以来计数）。
	服务提供商。 查看每项数据服务的套餐级别、你的密钥、测试按钮、用量、预算和 30 天图表。可将用量导出为电子表格（CSV）。
	路由。 查看每项任务优先调用哪个服务提供商。拖动可重新排序，也可使用向上／向下箭头。
	工具和链。 启用或停用工具和链。
	客户端。 仅在为他人运行时显示：创建和取消客户端密钥，并设置限制。
	连接。 复制 Claude Desktop、Claude Code、Cursor 和其他应用的设置。

密码和密钥

密钥分为三种。只需要第一种，它已为你创建。

随时查看你的仪表板密码：

onchain-data-mcp password --config-dir ~/.onchain-data-mcp

程序每次启动时也会打印仪表板地址，但绝不会打印密码。 密码保存在设置文件夹中的 dashboard_password 文件里。

一键链接中包含你的密码，因此会留在终端历史记录中。 在你自己的电脑上这样做没问题，但不要把链接粘贴到聊天中或截图里。

设置自己的密码：将 DASHBOARD_PASSWORD 设为至少 12 个字符，且不含空格。 对于 Claude Desktop，请将其添加到 "env" 块中，例如 "DASHBOARD_PASSWORD": "my-long-secret-2026"。

生成新的随机密码：

onchain-data-mcp password reset --config-dir ~/.onchain-data-mcp

然后重启 AI 应用（或程序），使其使用新密码。

添加提供商密钥：在仪表板中前往 Providers，粘贴密钥并点击 Test。 或者将其添加到 AI 应用设置的 "env" 块中，例如 "ALCHEMY_API_KEY": "your-key"。

数据提供商

提供商分为四个等级：

**我们的建议：**先不使用任何密钥。需要更好的结果时，可从 Alchemy 和 Helius 获取免费密钥，并粘贴到仪表板中。

完整列表（包括使用限制和注册链接）请参阅 docs/VENDORS.md。

可用工具

这些工具可供你的 AI 应用使用。你无需自行调用；AI 助手会选择合适的工具。“配置集”是现成的工具组合（payments、trading、neobank、defi）。默认情况下，你会获得全部配置集。你可以在仪表板的 Tools & Chains 页面选择较小的工具集。

除 tx_broadcast 外，所有工具都只读取数据。tx_broadcast 会发送你已签名的交易。

链与健康状况

钱包

交易

支付

稳定币

稳定币是旨在维持一美元（或一欧元）价值的加密货币，例如 USDC 和 USDT。

合规

资金（法币和银行业务）

市场和代币

交易

现实世界资产

旧版配置仍可使用四个遗留工具：eth_get_balance、eth_get_code、eth_gas_price 和 eth_get_transaction_by_hash。新配置应使用上述工具。

真实使用示例

将以下任意示例复制到你的 AI 应用中。

钱包

• “0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 在所有链上持有哪些代币？”
• “这个地址是普通钱包还是智能合约？”

支付

• “交易 0x… 是否在 Base 上向 0x… 支付了至少 25 USDC？这笔交易是否已最终确认？”
• “列出今天早上以来我在 Polygon 上三个店铺地址收到的 USDC 新存款。”
• “在 Solana 上为向我的地址支付 10 USDC 创建付款请求。”

安全

• “在我向这个地址付款之前，检查它是否在制裁名单中。”
• “Arbitrum 上的 USDC 仍然值 1 美元吗？”
• “这个新的 Solana 代币是骗局吗？”

资金

• “2026-03-15 的 EUR 兑 USD 汇率是多少？”
• “提供我钱包本月的交易明细，并附上美元价值。”
• “我的加密货币卡支付为什么被拒绝？”

交易

• “帮我找到在 Base 上将 500 USDC 兑换为 ETH 的最佳报价。”
• “2026 年 1 月 1 日 SOL 的价格是多少？”
• “现在 Ethereum 的网络手续费是多少美元？”

代币化股票

• “这个 Robinhood Chain 代币是 NVIDIA 股票的官方代币吗？价格是多少？”

为他人运行

默认情况下，程序只为你运行，在你的电脑上运行（“可自托管”）。

你也可以将它部署到服务器上，让其他人或应用使用（“托管”）。每位客户 都会获得自己的客户端密钥，并有各自的使用限额。你可以通过控制面板管理所有内容。

分步指南见 DEPLOYMENT.md。

故障排除

“missing or invalid dashboard password”

1. 运行 onchain-data-mcp password --config-dir <your folder> 并使用生成的密码。
2. 使用 AI 应用所用的同一个文件夹。不同的文件夹会有不同的密码。
3. 如果你更改了密码，请重启 AI 应用，让它读取更改。

“DASHBOARD_PASSWORD is too short” 或 “DASHBOARD_PASSWORD can only use plain letters…”

你设置的密码必须至少包含 12 个字符，且不能有空格或带重音符号的字母。 请修正密码，或移除 DASHBOARD_PASSWORD，以使用自动生成的密码。在此之前，控制面板 将保持关闭（其余功能仍可正常运行），并且你会在日志中看到 “dashboard turned off”。

“The password comes from the DASHBOARD_PASSWORD setting. Change it there instead.”

你设置了自己的密码，因此 password reset 无法替换它。请改为更改 DASHBOARD_PASSWORD。

“HTTP not started (Address already in use); stdio only” 或控制面板页面无法加载

端口 8787 已被其他程序占用（“端口”就像电脑上的门牌号）。 通常是因为此程序运行了另一个副本，例如两个 AI 应用同时运行它。 你的 AI 应用仍可正常使用；只是无法打开控制面板。请关闭另一个副本，或打开 正在运行的副本的控制面板。

AI 应用没有显示工具，或提示服务启动失败

1. 检查 command 路径。运行 which onchain-data-mcp（Mac/Linux）或 where onchain-data-mcp（Windows），然后粘贴完整路径。
2. 检查设置文本（JSON）中是否缺少逗号或引号。
3. 完全退出应用，然后重新打开。
4. Claude Desktop 日志：Mac ~/Library/Logs/Claude/，Windows %APPDATA%\Claude\logs\。

Mac 提示 “onchain-data-mcp cannot be opened” 或 “developer cannot be verified”

只有在你手动下载文件时才会出现这种情况。在文件所在文件夹中运行一次以下命令：

xattr -d com.apple.quarantine onchain-data-mcp

Linux：“GLIBC_2.35 not found”

你的 Linux 版本太旧，无法运行预构建程序。请改用 Docker 选项。

“hosted mode requires at least one client key” 或 “hosted mode requires public_bind”

只有在为他人运行时才会出现这些提示。请参阅 DEPLOYMENT.md。

工具提示某条链不受支持

此功能需要你尚未添加的服务提供商密钥。询问 “你支持哪些链和功能？” （chain_list 工具）以查看缺少的内容，然后在 Providers 页面添加密钥。

常见问题

免费吗？ 是的。本程序免费且开源（MIT 许可证）。它会优先使用免费数据服务。 部分提供商有付费套餐，但你完全不需要使用这些套餐。

我需要任何密钥吗？ 不需要。它可以直接使用无需注册的免费提供商。免费的 Alchemy 和 Helius 密钥能让它更快、更全面。

它支持哪些链？ Ethereum、Base、Arbitrum、Optimism、Polygon、Avalanche、BNB Chain、Robinhood Chain 和 Solana。

它能转移我的资金吗？ 不能。它从来不会获取你的钱包私钥。它可以为你准备一笔交易，由你在自己的钱包中签名；tx_broadcast 可以发送你已签名的交易。它本身无法签署任何内容。

我的数据安全吗？我的密钥会发送到哪里？ 所有内容都保存在你的计算机上。你的提供商密钥保存在设置文件夹中的 secrets.toml 里（在 Mac 和 Linux 上，只有你的用户可以读取），并且只会发送给相应的提供商。 仪表板只接受来自你自己的计算机的连接。

我的设置保存在哪里？ 保存在你选择的文件夹中（例如 ~/.onchain-data-mcp）：config.toml 用于设置，secrets.toml 用于密钥，dashboard_password，以及包含使用量数据的 data 文件夹。

如何更新？ 再次运行安装命令（或运行 brew upgrade onchain-data-mcp），然后重启你的 AI 应用。 对于 Claude Desktop，请下载新版 .mcpb 文件并双击打开。

开发者指南

REST API、设置参考、路由、架构、构建、测试和发布： docs/TECHNICAL.md。

安全

发现安全问题？请按照 SECURITY.md 中的说明私下报告。

许可证

MIT。仪表板字体采用 SIL 开放字体许可证 （OFL.txt）。