BlockRunAI/blockrun-mcp

BlockRun MCP – AI代理人的按调用付费数据与操作服务器

是什么

• 用 TypeScript/Node 编写的开源 模型上下文协议 (MCP) 服务器，可接入任何 MCP 兼容的 LLM 代理（Claude、Codex、Cursor、VS Code 等）。
• 提供 19 个即用型工具，包括：
  • 实时市场数据及在 Polymarket 上进行真实 USDC 结算的投注。
  • 网络、X（原 Twitter）、学术搜索。
  • 图像、视频和音频生成。
  • 跨 约 40 个区块链（Solana、Base 等）的链上查询。
  • LLM 模型访问、价格行情、DEX 数据等。
• 工具为 代理原生：LLM 可直接从提示词中调用，无需人工编写胶水代码。

如何支付

• 钱包模式（默认） – 首次运行时自动创建自托管钱包。您在 Solana 或 Base 上存入 USDC，每次工具调用通过 x402 微支付协议在链上结算（几分钱加上极小的网络费）。
• API 密钥模式 – 设置 BLOCKRUN_API_KEY（从 user.blockrun.ai 获取），适用于希望使用预付信用账户而非钱包的团队。计费为实际使用量，无调用费用。
• 两种模式均提供 相同的 19 个工具；可随时切换。

对代理为何重要

• 传统数据 API 需要人工创建账户、存储 API 密钥并管理信用卡账单——这些步骤是自主 LLM 无法完成的。
• BlockRun 将所有这些来源整合为 单一认证机制（钱包签名或 API 密钥），并按 调用计费，使真正自主的代理成为可能。
• 同时支持 人工在环支出审批（BLOCKRUN_CONFIRM_SPEND=on），用户可批准或拒绝任何超出预算的付费调用。

安装与使用

1. 安装 MCP 服务器（推荐通过 Claude Code）：

   claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
   

   命令首次运行时会创建钱包；请存入约 5 USDC 或设置 API 密钥。
2. 选择工具配置文件（可选）以减少模型上下文中加载的模式数据量。示例：
   • full – 所有 19 个工具（默认，每轮约 12.6K 令牌）。
   • trading – 8 个用于市场数据和 Polymarket 交易的工具（约 5.2K 令牌）。
   • media、research、chat – 更小的子集。 使用 --profile <name> 或设置 BLOCKRUN_MCP_PROFILE。
3. 充值
   • 钱包：将 USDC 发送到 ~/.blockrun/.session 中显示的地址。
   • API 密钥：从 BlockRun 仪表板获取密钥，并导出为 BLOCKRUN_API_KEY。
4. 从任意 MCP 兼容客户端调用工具。示例（Claude）：

   {"name":"blockrun_polymarket","input":{"question":"比特币今年会达到 10 万美元吗？"}}
   

   服务器返回实时赔率；使用 blockrun_polymarket 还可下注。

支持的客户端（均可通过 npx 启动服务器）：

• Claude Code（已验证）、Codex CLI、OpenClaw、Claude Desktop、Cursor、VS Code Copilot、Gemini CLI、Grok、Windsurf 等。
• 每个客户端可通过一个微小的 JSON 片段配置，指向 npx -y @blockrun/mcp@latest。

核心功能

• 一个钱包，多个来源 – 无需为每个供应商单独注册。
• 通过 x402 以 USDC 按调用付费，或通过 API 密钥预付信用。
• 读 + 执行 – 工具不仅获取数据，还能在 Polymarket 上执行真实交易。
• 支持 人工在环支出对话，确保预算安全。
• 生成式 UI – 在 Claude Desktop 和 VS Code 中，Polymarket 工具显示交互式订单卡片；钱包工具显示余额和二维码。
• 开源 MIT 许可证 – 服务器代码已发布在 npm（@blockrun/mcp）和 GitHub 上。

谁可能使用它

• 需要实时市场、网络或区块链数据的自主代理开发者。
• 实验 LLM 驱动交易或预测市场机器人的研究人员。
• 希望为多个代理提供统一、自托管数据层，而无需管理数十个 API 密钥的团队。

---

总结：BlockRun MCP 通过提供一个单一、按调用付费的网关，将 LLM 转变为功能齐全、具备金融能力的代理，接入 19 个实时工具——包括在 Polymarket 上下注真实 USDC 的能力——同时保持认证简单（钱包签名或 API 密钥）和成本透明。