SwiftNodes RPC

swiftnodes-mcp

一个适用于 SwiftNodes 的 MCP（Model Context Protocol） 服务，提供多链区块链 RPC，并开放给 AI Agent 使用。

一个 API 密钥，支持 125+ 条链，采用固定费率定价。此服务可让 Claude、ChatGPT、Cursor 及任何 MCP 客户端实时获取有关链、定价和 JSON-RPC 方法支持情况的准确信息，还能直接探测任意 EVM 端点。

链

支持 SwiftNodes 的全部 128 条链，包括 Ethereum、BNB Smart Chain (BSC)、opBNB、Base、Arbitrum、Polygon、Solana 和 Bitcoin。每条链都有一个用于工具参数和端点 URL 的 slug，例如：

链	Slug	端点
BNB Smart Chain (BSC)	bsc	https://rpc.swiftnodes.io/rpc/bsc?key=YOUR_API_KEY
opBNB	opbnb	https://rpc.swiftnodes.io/rpc/opbnb?key=YOUR_API_KEY
Ethereum	eth	https://rpc.swiftnodes.io/rpc/eth?key=YOUR_API_KEY
Base	base	https://rpc.swiftnodes.io/rpc/base?key=YOUR_API_KEY

提示词示例：“BNB Smart Chain 支持哪些 JSON-RPC 方法？”、“opBNB 的最新区块是什么？”、“BSC 上是否支持 trace_filter？”。list_chains 会返回完整列表。

托管服务（推荐）

SwiftNodes 会为你运行此服务，地址为 https://rpc.swiftnodes.io/mcp（Streamable HTTP）。无需安装。

claude mcp add --transport http --scope user swiftnodes https://rpc.swiftnodes.io/mcp --header "Authorization: Bearer $SWIFTNODES_API_KEY"

Cursor 和其他客户端（~/.cursor/mcp.json）：

{ "mcpServers": { "swiftnodes": { "url": "https://rpc.swiftnodes.io/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

密钥为可选项：不提供密钥也能使用下方的公共工具。提供密钥后，还可使用另外两个工具：

工具	功能
rpc_call	使用你的密钥在任意 SwiftNodes 链上发起 JSON-RPC 调用（与任何请求一样，会计入你的套餐用量）。
get_account	查看你的套餐、速率限制、本月已用请求数，以及密钥的 IP／来源限制。绝不会返回密钥值。

已在官方 MCP Registry 中登记，名称为 io.swiftnodes/swiftnodes。文档：https://swiftnodes.io/docs/mcp

工具

工具	功能
list_chains	SwiftNodes 提供的所有链——名称、slug、链 ID、类别和文档页面。支持筛选。
get_chain	某条链的完整详情：ID、区块时间、原生货币、HTTP／WebSocket／归档端点模板和文档链接。
get_pricing	从公共 API 实时获取固定费率套餐——速率限制、包含的功能，不使用计算单元。
get_method_support	查询哪些 JSON-RPC 方法在哪些链上可用——每周通过与客户请求相同的路径自动探测。可查看概览或单个方法的详情。
probe_endpoint	诊断任意 EVM JSON-RPC 端点（我们或其他服务的）：链身份、区块高度、归档能力、延迟，或运行指定的方法调用。

本地运行（stdio）

零依赖，Node >= 18。

从此仓库运行：

git clone https://github.com/swiftnodes/swiftnodes-mcp
node swiftnodes-mcp/bin/server.js   # speaks MCP over stdio

通过 npm 运行（发布后）：npx -y swiftnodes-mcp

Claude Desktop

{
  "mcpServers": {
    "swiftnodes": {
      "command": "node",
      "args": ["/path/to/swiftnodes-mcp/bin/server.js"]
    }
  }
}

Cursor／任何 MCP 客户端

添加一个 stdio 服务，命令设为 node，参数设为 ["/path/to/swiftnodes-mcp/bin/server.js"]。

数据来源

• 链 — 根据 SwiftNodes 网站的权威数据源生成的内置快照（scripts/generate-chains-data.mjs；链信息有变更后请重新生成）。
• 定价 — 从 https://rpc.swiftnodes.io/api/plans 实时获取（无法访问时使用内置备用数据）。
• 方法支持情况 — 从 https://swiftnodes.io/method-matrix.json 实时获取，每周重新探测。支持情况反映真实的客户请求路径，包括故障转移。

注意事项

probe_endpoint 会调用你提供的任何 http(s) URL——我们的 CLI 诊断工具 rpc-doctor 覆盖的范围也相同。请负责任地进行探测：每个端点快速探测一次，不要进行负载测试。

有疑问？请访问 swiftnodes.io——提供免费套餐，无需 KYC。

许可证

MIT——详见 LICENSE。