📄 工具详情 ⚙️ 安装教程 📚 使用教程
能力标签
🔌 MCP🤖 Agent💻 CLI🔗 REST API📚 RAG🔊 TTS🧠 Claude✨ GPT🎬 视频生成
blockrun-mcp MCP工具
🔌
MCP工具

blockrun-mcp MCP工具

基于 TypeScript · 让 AI 助手直接操作你的系统与工具
英文名：blockrun-mcp
⭐ 465 Stars 🍴 44 Forks 💻 TypeScript 📄 MIT 🏷 AI 8.0分
8.0AI 综合评分
MCP服务器实时数据AI智能体加密货币社交媒体市场数据
⬇ 下载源码 ZIP ⚙️ 配置说明 📺 TG 频道
✦ AI Skill Hub 推荐

AI Skill Hub 强烈推荐：blockrun-mcp MCP工具 是一款优质的MCP工具。AI 综合评分 8.0 分，在同类工具中表现稳健。如果你正在寻找可靠的MCP工具解决方案，这是一个值得深入了解的选择。

📚 深度解析

blockrun-mcp MCP工具 是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 blockrun-mcp MCP工具，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。blockrun-mcp MCP工具 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 blockrun-mcp MCP工具 评为 AI 评分 8.0 分，属于同类工具中的优质选择。

📋 工具概览

blockrun-mcp MCP工具 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars
⭐ 465
开发语言
TypeScript
支持平台
Windows / macOS / Linux
维护状态
轻量级项目，按需更新
开源协议
MIT
AI 综合评分
8.0 分
工具类型
MCP工具
Forks
44

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

blockrun-mcp MCP工具 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

📌 核心特色
  • 通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
  • 提供结构化工具调用接口，显著降低 AI 集成复杂度
  • 支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
  • 可与其他 MCP 工具组合叠加，构建完整 AI 工作站
  • 轻量无侵入设计，不影响现有系统架构
🎯 主要使用场景
  • 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
  • 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
  • 将多个 MCP 工具组合使用，构建个人专属 AI 工作站
以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。
安装命令
# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/BlockRunAI/blockrun-mcp

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "blockrun-mcp-mcp--": {
      "command": "npx",
      "args": ["-y", "blockrun-mcp"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json
📋 安装步骤说明
  1. 确认已安装 Node.js（v18 或以上版本）
  2. 打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
  3. 按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
  4. 保存配置文件并重启 Claude 客户端
  5. 重启后，在对话中即可使用本工具
以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。
常用命令 / 代码示例
# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 blockrun-mcp MCP工具 执行以下任务...
Claude: [自动调用 blockrun-mcp MCP工具 MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"
以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。
配置示例
// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "blockrun-mcp_mcp__": {
      "command": "npx",
      "args": ["-y", "blockrun-mcp"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效
📑 README 深度解析 真实文档 完整度 75/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

BlockRun MCP

npm License: MIT MCP

Real-time data for Claude — markets, research, X/Twitter, crypto. No API keys. Pay per call.

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

Wallet auto-created. Fund with $5 USDC. Ask Claude anything.

---

Prerequisites

  • Node.js ≥ 18 (node -v)
  • ~$5 USDC on Base or Solana (the server auto-creates a wallet on first run; see Fund your wallet)
  • An MCP client: Claude Code, Claude Desktop, Cursor, Windsurf, or ChatGPT Desktop

---

Install

Claude Code (recommended) 

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

The -s user flag installs globally (available in every project). The -- separator ensures -y is passed to npx, not parsed by claude mcp add.

💡 Homebrew / nvm users: if the server doesn't connect after install, Claude Code likely can't find node/npx on its launcher PATH. Install with your shell PATH passed through — works on CLI and desktop: 
> claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest
>
See Troubleshooting if it persists.

Tool profiles — expose a trimmed tool set so the client loads fewer schemas into context. Pass --profile <name> (or set BLOCKRUN_MCP_PROFILE); omit it for the full set.

ProfileTools
full *(default)*everything
mediawallet models image video realface music speech
tradingwallet price dex markets surf defi rpc
researchwallet models chat search exa surf
chatwallet models chat

```bash

e.g. a media-only install

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

or a trading-only install

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

Equivalent via env: `BLOCKRUN_MCP_PROFILE=trading`. An unknown profile name falls back to `full`. `modal` and `phone` are available in the `full` profile only.

**Claude Desktop** — add to `claude_desktop_config.json`:
json { "mcpServers": { "blockrun": { "command": "npx", "args": ["-y", "@blockrun/mcp"] } } } 

**Cursor** — add to `~/.cursor/mcp.json` (macOS / Linux) or `%APPDATA%\Cursor\mcp.json` (Windows):
json { "mcpServers": { "blockrun": { "command": "npx", "args": ["-y", "@blockrun/mcp@latest"] } } } ```

Windsurf — same JSON, in: - macOS: ~/.codeium/windsurf/mcp_config.json - Linux: ~/.config/.codeium/windsurf/mcp_config.json - Windows: %APPDATA%\Codeium\windsurf\mcp_config.json

---

Key Use Cases

What kinds of questions can Claude (or any LLM agent) answer once BlockRun MCP is installed:

1. Price reads / market data > "What's BTC trading at? Compare with last week's average." → blockrun_price (free) or blockrun_surf path:market/price

2. Prediction-market consensus > "What's Polymarket's odds for the next Fed rate decision?" → blockrun_markets path:polymarket/events + filter

3. On-chain forensics > "This wallet (0xabc...) — what's it labeled as? What does it hold? When did it whale up?" → blockrun_surf paths:wallet/labels/batch, wallet/detail, wallet/net-worth

4. Cited research with sources > "Find the 5 most-cited papers on speculative decoding from the last 90 days. Summarize the dominant approach." → blockrun_exa action:search then contents

5. Image generation with on-image text > "Generate a poster announcing GPT-5.5 on BlockRun, retro-futuristic, with the headline 'NOW LIVE'." → blockrun_image + the image-prompting skill 5-section framework

6. Give your agent a voice > "Use blockrun to speak this with the sarah voice." → blockrun_speech action:speak (default), input + voice → hosted MP3 URL. Sound effects via action:sound_effect

7. Voice phone-out > "Call +1-415-555-... and confirm the appointment on Friday at 3pm." → blockrun_phone path:voice/call, body: { to, task, from } (provision from first via phone/numbers/buy), then poll voice/call/{call_id}

8. Multi-agent research with budget cap > "Spawn 3 research agents on competing L1 narratives. Cap each at $0.50." → blockrun_wallet delegate × 3 → children call blockrun_chat + blockrun_exa with their agent_id

9. Cross-chain SQL forensics > "Top 10 tokens by DEX volume on Base in the last 24h." → blockrun_surf path:onchain/sql, body: { sql: "SELECT..." }

---

Demo

User: What's Polymarket saying about the Fed rate decision next month?
Claude: According to Polymarket, the market currently puts a 73% probability on the Fed holding rates steady at the May meeting, with 24% on a 25bp cut and 3% on a hike. Volume over the last 24h: $2.1M. The "Hold" contract last traded at $0.73. (via blockrun_markets · cost: $0.001)

---

User: Find recent papers on speculative decoding and summarize the key approaches
Claude: I found 8 papers from the last 60 days via neural search. The dominant approaches are: (1) draft model selection — smaller models predicting N tokens ahead for the larger model to verify in parallel... (via blockrun_exa · cost: $0.01)

---

Showcase

Posters generated through blockrun_image with openai/gpt-image-2. Each is a single API call routed through BlockRun, paid in USDC on Base.

Environment Variables

Variable / FileDefaultEffect
~/.blockrun/.sessionauto-created on first runEVM private key (0x...). File exists → use Base.
~/.blockrun/.chainunsetOptional explicit chain preference: base or solana.
~/.blockrun/.solana-sessionnot createdSolana private key. File exists → switch to Solana unless .chain says base.
SOLANA_WALLET_KEYunsetEnv-var override of .solana-session. Set → use Solana.

Chain selection priority (see src/utils/wallet.ts):

  1. ~/.blockrun/.chain or ~/.blockrun/payment-chain set to base or solana → explicit preference wins
  2. SOLANA_WALLET_KEY env var present → Solana
  3. ~/.blockrun/.solana-session exists → Solana
  4. Otherwise → Base (~/.blockrun/.session auto-created)

Switching chains:

The recommended way is the tool itself — it provisions both wallets, applies instantly (no restart), and shows the funding QR:

blockrun_wallet action:"chain" chain:"solana"   # or chain:"base"
blockrun_wallet action:"setup"                  # funding instructions for the active chain

Advanced (force a chain before startup, e.g. in CI): echo solana > ~/.blockrun/.chain then set SOLANA_WALLET_KEY or create ~/.blockrun/.solana-session; echo base > ~/.blockrun/.chain reuses the existing .session (same Base wallet). These edit the same preference file that action:"chain" writes — prefer the tool unless you need pre-startup control.

Some media and paid market-data tools still settle on Base only: blockrun_image, blockrun_music, blockrun_speech, blockrun_video, and paid stock blockrun_price calls — plus blockrun_chat routing:"smart" and native Anthropic (claude-*) passthrough. In Solana mode these return a "switch to Base" message instead of charging.

The server also runs a non-blocking npm registry check at startup and prints an Update available notice to stderr when a newer @blockrun/mcp version exists. Upgrade by re-running the install command — no manual npm update needed.

---

Why not just use the APIs directly?

Direct APIsBlockRun
ExaSign up, $20/mo minimum$0.01/call, no subscription
PolymarketUndocumented, rate-limited$0.001/call, clean JSON
Surf (asksurf.ai)Account + monthly plan$0.001/call, no Surf account, 84 endpoints
Multiple sources3 accounts, 3 API keys, 3 billing pages1 wallet

One wallet. All sources. No dashboards.

---

Troubleshooting

- Insufficient balance / HTTP 402 after retry → Run blockrun_wallet action:"setup". Send USDC on Base (or Solana — see Environment Variables). - Smart routing (ClawRouter) is not available on Solana → Pass model: or mode: explicitly to blockrun_chat, or switch back to Base with echo base > ~/.blockrun/.chain. - blockrun doesn't connect / "MCP server failed" / spawn npx ENOENT → Almost always a PATH issue: Claude Code can't find node/npx on the PATH its MCP launcher uses. Common with Homebrew (/opt/homebrew/bin) or nvm, where node isn't on that PATH — and it affects the CLI as well as the desktop app (the launcher doesn't always inherit your interactive shell PATH). Fix by passing your shell PATH at install: 

  claude mcp remove blockrun -s user
  claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest
Then restart Claude Code (or /mcp to reconnect — MCP tools load at session start). Or pin absolute paths: claude mcp add blockrun -s user -- /opt/homebrew/bin/npx -y @blockrun/mcp@latest (use which npx for your path). - claude mcp list doesn't show blockrun → Check node -v (must be ≥20.19). Clear the npx cache: rm -rf ~/.npm/_npx. Re-run the install command from above (see the PATH fix above if node/npx aren't found). - fetch failed / timeout when checking wallet balance → Base RPC transient outage. The tool already falls through 3 public RPCs; retry after 30s. Persistent failures usually = local proxy / firewall blocking outbound RPC. - ENOENT: ~/.blockrun/.session → Expected on first run. The server auto-creates the wallet; check stderr for the WALLET_CREATED line confirming the address. - Video generation timed out (5-min cap) → Upstream Seedance / xAI queue congestion. No charge (payment-on-completion). Retry, or pick a faster model (bytedance/seedance-1.5-pro). - Music generation timed out (200s cap) → Same pattern. No charge. Retry; if it persists, the upstream model is rate-limited — try off-peak.

---

🇨🇳 中文文档镜像 AI 翻译 2026-06-09
英文原文章节由系统翻译为中文摘要，便于快速理解。完整原文见上方 "📑 README 深度解析"。
📌 简介

BlockRun MCP 是一个实时数据服务，提供市场、研究、X/Twitter、加密货币等信息。无需 API 密钥，按调用付费。

📋 环境依赖

环境依赖与系统要求：Node.js ≥ 18、~$5 USDC（在 Base 或 Solana 上）、一个 MCP 客户端（Claude Code、Claude Desktop、Cursor、Windsurf 或 ChatGPT Desktop）

🛠 安装步骤（Docker/pip/源码）

安装：使用 Claude Code（推荐）或 Claude Desktop，添加到 claude_desktop_config.json 文件中

🚀 使用教程

使用教程：BlockRun MCP 可以回答 Claude（或任何 LLM 代理）的问题，例如价格读取、市场数据、预测市场共识等

⚙️ 配置说明（含 MCP / env）

环境变量：~/.blockrun/.session（自动创建，EVM 私钥）、~/.blockrun/.chain（选填，Base 或 Solana）、~/.blockrun/.solana-session（Solana 私钥）

🔌 API 说明

为什么不直接使用 API？BlockRun、Exa、Polymarket、Surf 等 API 有不同的费用和限制

❓ FAQ 摘要

常见问题：不足余额或 HTTP 402 后重试、智能路由（ClawRouter）不可用于 Solana 等

🎯 aiskill88 AI 点评 A 级 2026-05-21

高质量MCP实现，集成多维实时数据源，为AI智能体赋能强大信息获取能力。TypeScript开发维护良好，465星关注度适中，商业付费模式可持续发展。

📚 实用指南（长尾问题）
适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
  • 构建多智能体协作系统的 Agent 开发者
  • 构建企业知识库 / RAG 检索应用的团队
最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
  • 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
  • Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
常见错误
  • API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
  • MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
  • embedding 模型与查询模型不一致导致检索失效
部署方案
  • 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
blockrun-mcp 中文教程blockrun-mcp 安装报错怎么办blockrun-mcp MCP 配置blockrun-mcp Agent 工作流blockrun-mcp 与同类工具对比blockrun-mcp 最佳实践blockrun-mcp 适合谁用

⚡ 核心功能

👥 适合谁
  • 需要让 Claude / Cursor 操作本地工具的 AI 工程师
  • 构建多智能体协作系统的 Agent 开发者
  • 构建企业知识库 / RAG 检索应用的团队
⭐ 最佳实践
  • 配置 MCP 服务器时建议使用 stdio 传输 + JSON-RPC，避免暴露公网
  • 分块大小建议 256-512 tokens，向量库优选 pgvector 或 Qdrant
  • Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
⚠️ 常见错误
  • API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
  • MCP 配置路径拼错或权限不足，重启 Claude Desktop 才生效
  • embedding 模型与查询模型不一致导致检索失效

👥 适合人群

Claude Desktop / Claude Code 用户AI 工具开发者需要扩展 AI 能力的专业人士自动化工程师

🎯 使用场景

  • 在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
  • 通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
  • 将多个 MCP 工具组合使用，构建个人专属 AI 工作站

⚖️ 优点与不足

✅ 优点
  • +MIT 协议，可免费商用
  • +标准化 MCP 协议，生态互联性强
  • +与 Claude 官方生态无缝对接
  • +即插即用，配置简单快捷
⚠️ 不足
  • −依赖 Claude 客户端，非 Claude 用户无法使用
  • −MCP 协议仍在持续演进，接口可能变更
  • −需要一定的配置步骤
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。

📄 License 说明

✅ MIT 协议 — 最宽松的开源协议之一，可自由商用、修改、分发，仅需保留版权声明。

🔗 相关工具推荐

AI工程师中心
MCP工具
GhidraMCP MCP工具
专为Ghidra逆向工程平台设计的MCP服务器，通过模型上下文协议集成AI能力，支持程序分析、反汇编代码理解和安全研究。
MCP 服务器资源汇总
精心策划的Model Context Protocol服务器列表，汇集AI工具生态中的优质MCP服务实现。面向Claud
FastMCP
FastMCP是一个开源Python框架，用于快速构建MCP服务器和客户端。提供Pythonic API设计，简化模型上
📚 相关教程推荐
MCP 配置教程
帮助中心 · AI Skill Hub
MCP 工具
帮助中心 · AI Skill Hub
Cursor AI 编程完全指南：Rules 配置、Composer 使用、MCP 集成
帮助中心 · AI Skill Hub
MCP 工作流生产级配置方案：从开发环境到团队共享
帮助中心 · AI Skill Hub
📰 相关 AI 新闻
前沿 AI 研究论文速览
AI 资讯 · 知识关联
AI Agent 自主化能力最新进展
AI 资讯 · 知识关联
GitHub热门：claude-mem — Persistent Context Across Sessions for Every Agent – Capt
AI 资讯 · 知识关联
AI 监管政策与法规动态
AI 资讯 · 知识关联
🍿 AI 圈相关吃瓜
AutoGPT 自主完成了任务：把我的文件夹全部重命名了
AI 圈观察
配了5个 MCP 工具，Claude 一个都没用
AI 圈观察
Filesystem MCP 帮 Claude 找文件，找了整个 node_modules
AI 圈观察
🗺️ 相关解决方案
mcp
mcp-server-setup
agent
ai-agent-workflow
rag
rag-knowledge-base
🧩 你可能还需要
基于当前 Skill 的能力图谱，自动补全的工具组合
技能寻求者
MCP · Agent · 工作流
natively-cluely-ai-assistant — Claude Skill 中文使用文档
免费开源的AI面试助手，实时转录，隐蔽模式，局部RAG，BYOK。无订阅，防止数据泄露。
total-agent-memory MCP工具
为Claude Code和Codex CLI提供持久化记忆功能的开源MCP工具。自动提取知识图谱，支持多轮对话上下文保留，适合需要长期记忆和
CrewAI 多代理协作平台
MCP · Agent · 工作流
LEANN AI技能包
MCP · Agent · 工作流
DeepCode Agent工作流
MCP · Agent · 工作流

❓ 常见问题 FAQ

支持搜索引擎、研究数据库、市场行情、加密资产信息和Twitter/X社交媒体数据。
💡 AI Skill Hub 点评

总体来看，blockrun-mcp MCP工具 是一款质量优秀的MCP工具，在同类工具中具备一定竞争力。AI Skill Hub 将持续追踪其更新动态，建议收藏备用，结合自身场景选择合适时机引入使用。

⬇️ 获取与下载
⬇ 下载源码 ZIP

✅ MIT 协议 · 可免费商用 · 直接从 aiskill88 服务器下载，无需跳转 GitHub

📚 深入学习 blockrun-mcp MCP工具
查看分步骤安装教程和完整使用指南，快速上手这款工具
⚙️ 安装教程 📚 使用教程
🌐 原始信息
原始名称 blockrun-mcp
原始描述 开源MCP工具：Live data for AI agents — search, research, markets, crypto, X/Twitter. Pay-per-。⭐465 · TypeScript
Topics MCP服务器实时数据AI智能体加密货币社交媒体市场数据
GitHub https://github.com/BlockRunAI/blockrun-mcp
License MIT
语言 TypeScript
🔗 原始来源
🐙 GitHub 仓库  https://github.com/BlockRunAI/blockrun-mcp

收录时间：2026-05-14 · 更新时间：2026-05-16 · License：MIT · AI Skill Hub 不对第三方内容的准确性作法律背书。

📺 订阅 AI Skill Hub Daily Telegram 频道
每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送
加入频道 →