BlockVectra: multi-chain RPC & Data API

BlockVectra MCP 服务

适用于 BlockVectra 的远程 Model Context Protocol 服务：多链 EVM JSON-RPC、索引 Data API、文档、CU 定价和状态查询。文档、发现、定价和状态查询无需 API 密钥。免密 RPC 取决于各链的公共方法策略；索引 Data API 和账户工具需要你自己的 BlockVectra API 密钥。

中文

Robinhood Chain 主网和测试网任务

主网公共只读 RPC 任务请使用链 RPC 指南。测试网任务请使用测试网入门指南和水龙头指南。主网公共读取无需先领取测试网代币。

连接到 https://docs.blockvectra.com/mcp 时无需提供请求头，即可访问文档和发现功能。Robinhood Chain 公共端点允许在无需密钥的情况下执行受支持的 RPC 读取；策略范围外的方法需要 API 密钥。领取水龙头代币需要 x-api-key。HTTP 202 表示请求已受理；请检查交易回执以确认是否已上链（status: "0x1"），但这不代表最终确定。

本地 stdio 桥接程序

使用 Node.js 22 或更高版本运行采用 MIT 许可证的 stdio 桥接程序：

npx --yes @blockvectra/[email protected]

配置 stdio 客户端：

{
  "mcpServers": {
    "blockvectra-docs": {
      "command": "npx",
      "args": ["--yes", "@blockvectra/[email protected]"]
    }
  }
}

对于源代码检出，请运行 npm ci，然后改用 node 并指定 src/cli.js 的绝对路径。

CLI 始终桥接到 https://docs.blockvectra.com/mcp；它不接受任何命令行参数。你可以通过子进程环境或客户端的私有环境设置提供 BLOCKVECTRA_API_KEY。该密钥只会作为 x-api-key 转发。切勿将密钥放入 CLI 参数、工具参数或聊天内容中；切勿提供私钥。

桥接程序直接连接官方的 StreamableHTTPClientTransport 和 StdioServerTransport，不会重新构建功能或工具。它会在 JSON 消息层级（而非字节格式层级）保留初始化参数/结果、功能、说明、protocolVersion、工具结果、JSON-RPC 错误、通知和双向请求。收到成功的初始化响应后，它会先设置 HTTP 传输协商所得的协议版本，再转发该响应。stdout 只包含 MCP 消息；stderr 使用固定诊断信息，不包含 SDK 错误文本。EOF、SIGINT 和 SIGTERM 会关闭两种传输；传输故障会关闭桥接程序并以退出代码 1 退出。HTTP/SSE 行为、解析和重连仍由 SDK 处理。

依赖项固定为官方 @modelcontextprotocol/client 和 @modelcontextprotocol/server 2.3.1，其已发布的软件包导出内容和源代码提供了这些传输，并要求 Node >=20。请参阅官方 SDK 仓库/版本发布页面和连接文档。截至 2026-10-13，Node 官方版本发布表将 Node 20 列为 EOL、将 Node 22 列为 LTS，因此此软件包要求 Node >=22。

本地验证：npm test 仅运行串行模拟 HTTP/真实 stdio 子进程测试；npm pack --dry-run 会检查软件包内容。无需构建。

一步安装

服务 URL（Streamable HTTP，无需密钥）：https://docs.blockvectra.com/mcp

客户端	一行安装命令	来源
Claude Code	claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp	Claude Code 中的 MCP
Claude Code 插件（MCP 服务 + blockvectra-rpc 技能）	/plugin marketplace add blockvectra/mcp，然后运行 /plugin install blockvectra-docs@blockvectra	创建 marketplace，插件依赖项
Cursor	添加到 Cursor（网页链接），或打开 cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra-docs&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9	MCP 安装链接，网页链接格式
VS Code	code --add-mcp '{"name":"blockvectra-docs","type":"http","url":"https://docs.blockvectra.com/mcp"}'	在 VS Code 中使用 MCP 服务
VS Code（链接）	vscode:mcp/install?%7B%22name%22%3A%22blockvectra-docs%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.blockvectra.com%2Fmcp%22%7D	MCP 开发者指南
Gemini CLI	gemini extensions install https://github.com/blockvectra/mcp --ref main	Gemini CLI 扩展
Antigravity	agy plugin install https://github.com/blockvectra/mcp	Antigravity 插件

Cursor 的 config 值是 {"url":"https://docs.blockvectra.com/mcp"} 的 Base64 编码。VS Code 链接是经过 URL 编码的 JSON 服务配置。

插件由 .claude-plugin/marketplace.json 和 .claude-plugin/plugin.json 描述。它会从 .mcp.json 安装 blockvectra MCP 服务，并将 blockvectra/skills 中的 blockvectra-rpc 技能作为依赖安装。

• 端点： https://docs.blockvectra.com/mcp（Streamable HTTP，无状态）
• 身份验证： 可选的 x-api-key 标头（BlockVectra API 密钥）。也接受 Authorization: Bearer <key>。不提供密钥时，可以使用文档、链、定价和状态工具，以及链的公共端点所允许的 JSON-RPC 方法。
• 切勿将 API 密钥或私钥放入工具参数或聊天内容中；服务只会从 HTTP 标头读取密钥。

链、价格和限额会发生变化，因此本 README 不会列出这些信息。请实时查询：

• 支持的链：GET https://api.blockvectra.com/v1/chains
• 套餐、价格和限额：GET https://console-api.blockvectra.com/v1/plans
• 服务状态：GET https://api.blockvectra.com/v1/status

更多信息：面向 Agent 的 BlockVectra 和 AI Agent 指南。

goose：免密文档查询

使用 goose 和你配置的模型提供商。文档工具无需 BlockVectra 账户或 API 密钥。

下载并运行文档配方。你只需要这个 JSON 文件，无需检出仓库：

curl --fail --location --output blockvectra-goose-docs.json \
  https://raw.githubusercontent.com/blockvectra/mcp/8c99c0e499166d8ba2163536f8d150571783c0a3/recipes/goose-docs.json
goose recipe validate blockvectra-goose-docs.json
goose run --recipe blockvectra-goose-docs.json

它会使用 search_docs 搜索 Robinhood Chain 主网设置，然后使用 read_doc 读取一份返回的文档。该配方仅列出这两个工具；不包含 RPC、账户或交易工具。成功的结果应引用该文档，并说明哪些连接步骤需要密钥。模型使用你 goose 提供商的常规配额或计费方式。

如需改用交互式会话，请为该会话添加远程扩展：

goose session --with-streamable-http-extension "https://docs.blockvectra.com/mcp"

该会话会发现完整的工具目录；配方则是更精简的文档专用起点。请参阅 goose 扩展指南和配方参考。

可移植的 RPC 文档 Agent

如需进行小型托管 Agent 演示，请使用可移植说明和评估用例。它们复用上述双工具文档任务。这是一份提示词和演示简介，并非 Lagrange 清单或经过验证的部署；主机端工具过滤以及模型／托管费用另计。

n8n：离线提案检查

对于常规的 n8n MCP Client 工作流，此配方演示了如何在任何 MCP 节点运行之前，离线检查提议的 rpc_call。粘贴 Code 节点，并与测试样例进行比较。将可信预算设为零后，每项收据都只是参考性比较，调度结果始终为 DENY。这不是资金授权或执行，也未在真实的 n8n 实例中运行。请阅读指南了解设置方法和限制。

Gemini CLI 扩展

该扩展通过远程 Streamable HTTP 直接连接到 https://docs.blockvectra.com/mcp。你不需要本地 stdio 桥接程序或 npm。

安装后，重启 Gemini CLI 并运行 /mcp，查看可用工具。试着运行 list_chains，然后使用 path=quickstart 和 lang=en 调用 read_doc。

可选身份验证

该扩展默认免密：文档、发现、定价和状态功能均无需密钥；RPC 遵循各链的公共方法策略；索引数据和账户工具需要你自己的 BlockVectra API 密钥。切勿将密钥放入 argv、工具参数、聊天内容或版本控制中，也不要将明文密钥导出到 shell 历史记录。在 Gemini 启动前，通过现有的私有密钥管理器或私有启动环境，让 Gemini 进程环境能够访问 BLOCKVECTRA_API_KEY；仅创建 .gemini/.env 文件并不足够。

如需将密钥作为请求头发送，请将以下内容合并到用户级 ~/.gemini/settings.json 中，不要替换其他设置：

{
  "mcpServers": {
    "blockvectra-docs": {
      "httpUrl": "https://docs.blockvectra.com/mcp",
      "headers": { "x-api-key": "${BLOCKVECTRA_API_KEY}" }
    }
  }
}

此用户级配置会覆盖同名扩展服务器的设置。配置后请重启 Gemini CLI。gemini mcp list 或 /mcp 只能检查连接状态，无法确认账户或数据授权是否成功；如需验证身份验证，请主动调用只读的 get_account 工具，并对返回的账户数据保密。

已使用官方 Gemini CLI 0.65.0 和本地模拟程序及合成密钥进行测试；这验证的是客户端配置和请求头传输，而非实际的带密钥工具行为。请参阅 Gemini CLI MCP 自定义请求头。

Antigravity 插件

该插件通过远程 Streamable HTTP 直接连接到 https://docs.blockvectra.com/mcp。你不需要本地 stdio 桥接程序或 npm。

在当前项目中安装

在项目根目录运行以下命令：

mkdir -p .agents/plugins/blockvectra-docs
curl --fail --location https://raw.githubusercontent.com/blockvectra/mcp/antigravity-v0.1.0/plugin.json --output .agents/plugins/blockvectra-docs/plugin.json
curl --fail --location https://raw.githubusercontent.com/blockvectra/mcp/antigravity-v0.1.0/mcp_config.json --output .agents/plugins/blockvectra-docs/mcp_config.json

在该目录中启动 agy。首次检查时，请让它使用 {"query":"Antigravity","lang":"en","limit":1} 调用 search_docs。已使用 Antigravity CLI 1.4.7 验证项目本地加载以及这次无需密钥的文档搜索。

官方插件指南介绍了项目本地和全局安装方式。上述命令会将插件放入此项目的 .agents/plugins/ 目录。

安装后

安装后，重启 Antigravity 并运行 /mcp，查看可用工具。试着调用 list_chains，然后使用 path=quickstart 和 lang=en 调用 read_doc。

该插件默认无需密钥：文档、发现、定价和状态查询均无需密钥；RPC 调用遵循各链的公开方法策略；索引数据和账户工具则需要你自己的 BlockVectra API 密钥。切勿将密钥放入工具参数、聊天内容或版本控制中。若要发送密钥，请按照 MCP in Antigravity 和客户端的私有请求头设置，将密钥配置为私有请求头。

工具

此表反映了当前在 https://docs.blockvectra.com/mcp 上运行的服务。权威列表请调用 tools/list。

工具	功能	API 密钥	读取 / 写入
read_doc	读取文档页面的原始 Markdown	不需要	只读
search_docs	按关键词搜索文档标题、路径和摘要	不需要	只读
list_docs	列出所有文档页面	不需要	只读
list_chains	支持的链、静态参数和方法策略（GET /v1/chains）	不需要	只读
get_status	实时服务和网络状态（GET /v1/status）	不需要	只读
get_pricing	套餐、CU 权重和限额（GET /v1/plans）	不需要	只读
estimate_usage	根据方法和每日调用量估算 CU 和美元费用	不需要	只读
get_method_info	JSON-RPC 方法在各链上的可用性、CU 权重和价格	不需要	只读
explain_error	查询错误代码或原因：计费、是否可重试、建议操作	不需要	只读
how_to_get_api_key	获取 API 密钥的步骤（程序化 SIWE 注册或浏览器跳转）及身份验证请求头格式	不需要	只读
rpc_call	在链上执行只读 JSON-RPC 2.0 方法	可选：不使用密钥时，仅在链支持的情况下使用该链的免密公开端点	只读
data_api_get	查询指定链和路径的 Data API	需要	只读
get_account	查询 API 密钥的余额、CU 和速率限制（GET /v1/account）	需要	只读
get_deposit_address	查询账户的链上存款地址和开放网络	需要	只读
send_raw_transaction	在链上广播已签名的原始交易	可选：免密访问取决于该链的公开方法策略	写入（destructiveHint: true）

注意：不带密钥调用 get_deposit_address 和其他需要密钥的工具时，会返回指向 how_to_get_api_key 的错误。

在 Cursor / Cline 中使用

免密 Cursor 配置位于 .mcp.json，并由 Cursor 插件清单引用。有关 Cline 的 Streamable HTTP 设置和可选 x-api-key 请求头，请参阅 llms-install.md。先不配置请求头：调用 list_chains，然后使用 {"path":"quickstart","lang":"en"} 调用 read_doc。

连接客户端

以下每个代码片段均遵循相应客户端的文档说明。按照文档所述，添加可选的密钥标头以设置自定义标头。

客户端	官方文档
Claude Code	Claude Code 中的 MCP
Cursor	Cursor 中的模型上下文协议
VS Code	在 VS Code 中使用 MCP 服务
Codex	Codex MCP

Claude Code

claude mcp add --transport http blockvectra https://docs.blockvectra.com/mcp
# For an optional key, use private environment-backed header settings;
# see the Codex env_http_headers example below. Never pass a key as a CLI argument.

Cursor（.cursor/mcp.json）

将此服务合并到项目的 .cursor/mcp.json 中，并保留任何现有服务：

{
  "mcpServers": {
    "blockvectra-docs": {
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

对于 Cursor CLI，请在该项目目录中运行以下命令，以批准连接并列出其工具：

agent mcp enable blockvectra-docs
agent mcp list-tools blockvectra-docs

请参阅 Cursor CLI MCP 命令。

VS Code（.vscode/mcp.json）

{
  "servers": {
    "blockvectra-docs": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"
# optional: read the key from an environment variable
env_http_headers = { "x-api-key" = "BLOCKVECTRA_API_KEY" }

注册表

server.json 描述了此服务在官方 MCP 注册表中的信息，名称为 com.blockvectra/docs。发布流程需手动执行（.github/workflows/publish.yml）。

许可证

MIT