cipher-x402-mcp

cipher-x402-mcp

一个 MCP 服务，向任何支持 MCP 的客户端（Claude Desktop、Cursor、Cline、Continue 等）提供 8 个 Solana / 加密货币 / 宏观经济工具。其中 7 个工具由 x402 支付协议保护——Agent 会在 Base 上自动使用 USDC 支付，每次工具调用费用为 $0.005–$0.25。另有 1 个免费工具（用于教育）。

此服务是仅转发的中继：当 Agent 调用付费工具时，如果没有 X-PAYMENT 标头，我们会原样返回上游的 HTTP 402 和接受列表，以便 Agent 使用自己的钱包签署付款。我们绝不会托管调用方的资金。

免费，采用 MIT 许可。 随意 Fork 并发布自己的版本，无任何附加条件。

---

托管方案（MCPize）

不想自行托管？MCPize 上提供了托管服务，包含网关代理、速率限制、API 密钥身份验证和统一账单：

mcpize.com/mcp/cipher-x402-mcp

方案	价格	每月请求数	速率限制	包含内容
免费	$0	100	10 / 分钟	免费工具 + solana_wallet_scan
Starter	$9	1,000	60 / 分钟	4 个只读工具（scan、HIBP、repo health、FRED）
Pro（推荐）	$29	5,000	120 / 分钟	全部 8 个工具、GitHub 优先支持
Team	$99	25,000	600 / 分钟	全部 8 个工具 + 自定义上游覆盖，24 小时响应 SLA

通过 MCPize 网关按使用量付费。自行托管仍然免费（本仓库采用 MIT 许可）。

---

工具

工具	价格（USDC，Base）	上游
solana_wallet_scan(address)	$0.01	cipher-scan-three.vercel.app
check_password_breach(sha1_prefix)	$0.005	cipher-pwned.vercel.app
jito_tip_calculator(pool_depth, expected_profit, slot_prob)	$0.01	cipher-jito-tip.vercel.app
github_repo_health(owner, repo)	$0.02	cipher-repo-health.vercel.app
fred_macro_series(series_id)	$0.005	cipher-fred.vercel.app
check_drift_exposure(wallet)	$0.01	cipher-drift-exposure.vercel.app
solana_wallet_security_audit_rules()	免费	本地（v1.1.0 规则集）
get_premium_cipher_chapter(slug)	$0.25	cipher-x402.vercel.app

Base 网络，USDC 资产 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913。当前的 x402 付款接收方会在运行时通过根路径 / 的 JSON 清单公开——Agent 会自动发现，无需手动配置。

安装（Claude Desktop）

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "cipher-x402": {
      "command": "npx",
      "args": ["-y", "cipher-x402-mcp"]
    }
  }
}

重启 Claude Desktop。工具栏中会显示这 8 个工具。

安装（Cursor / Cline / Continue）

任何通过 stdio 使用 MCP 的客户端都可以采用相同方式——启动命令为 npx -y cipher-x402-mcp。

安装（Smithery）

npx -y @smithery/cli install cipher-x402-mcp --client claude

远程 HTTP 传输

部署地址：**https://cipher-x402-mcp.vercel.app/mcp**（可流式传输的 HTTP）。 在根 URL 探测清单。

支付方式

1. Agent 调用（例如）solana_wallet_scan({ "address": "..." })，无需支付。
2. 服务端返回一条结构化结果，以 HTTP 402 Payment Required — upstream returned an x402 accept-list. 开头，后面附有 JSON 接受列表（价格、网络、payTo、asset 等）。
3. Agent 的钱包为公布的 maxAmountRequired 签署 EIP-3009 授权。
4. Agent 使用以下参数重新调用同一工具： { "address": "...", "_payment": "<base64-signed-header>" }。
5. 服务端将 X-PAYMENT 标头转发给上游，上游的 facilitator 会在 Base 上验证并结算，然后将内容返回给 Agent。

服务端本身是无状态的——没有 API 密钥、用户会话或资金。

---

🏃 自行运行

前提条件

• Node.js 20+（推荐 22）
• npm 10+
• 如果想部署 HTTP 传输，需要一个 Vercel 账户（免费套餐即可）
• 本地使用 stdio 无需 API 密钥——服务端只是将请求转发到公共上游端点

克隆并构建

git clone https://github.com/cryptomotifs/cipher-x402-mcp
cd cipher-x402-mcp
npm install
npm run build
npm run smoke     # tool-registry smoke test
npm start         # stdio transport
npm run start:http  # HTTP transport on :8080

配置自己的上游端点（可选）

所有上游基础 URL 都可以通过环境变量覆盖——如果你将上游端点分叉到自己的 Vercel 项目，并希望 MCP 服务将请求路由到这些端点，这会很有用：

CIPHER_SCAN_API_URL=https://your-scan.example.com \
CIPHER_PWNED_URL=https://your-pwned.example.com \
CIPHER_JITO_TIP_URL=https://your-jito.example.com \
CIPHER_REPO_HEALTH_URL=https://your-repo-health.example.com \
CIPHER_FRED_URL=https://your-fred.example.com \
CIPHER_DRIFT_URL=https://your-drift.example.com \
CIPHER_X402_URL=https://your-x402.example.com \
  npx cipher-x402-mcp

部署到 Vercel

vercel link
vercel --prod

/mcp 路由提供 MCP JSON-RPC 消息；/ 提供供注册目录使用的轻量级 JSON 清单。

---

🛒 购买

如果 MCP 对你有用，且你想深入了解，这里还有一些价格不高的付费配套产品——均为直接付款，没有平台中间商：

• cipher-checkout.vercel.app — 三款产品，可用银行卡（Stripe）或加密货币（Base USDC、Solana USDC、BTC）付款：
  • x402 Paid Endpoint Starter Kit — $19 — Next.js 16 入门仓库 + 7 页教程 PDF + 一键部署到 Vercel。可正常运行的 x402 端点，可针对 facilitator 验证 X-PAYMENT。
  • Solana Solo-Dev Playbook (PDF) — $9 — 150 页实战手册，涵盖 2026 年独立 Solana + x402 开发者所需的交易、风险、安全、架构、收入、合规和基础设施知识。
  • Solana Bot Toolkit Walkthrough — $29 — 深入讲解开源项目 cipher-solana-bot-toolkit（5 个模块：闪电贷、交易量机器人、套利/MEV、模因币发行器、跟单交易）。

也可以通过托管式 MCPize 列表购买：mcpize.com/mcp/cipher-x402-mcp — 每月 $9 / $29 / $99，另有免费方案。

---

🙏 支持

本项目免费且采用 MIT 许可证。如果它为你节省了时间，欢迎用 SOL 打赏：

cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy

不必勉强——给仓库点个星或分享出去，同样感谢。

---

💼 聘请我

加拿大独立开发者（安大略省，ET）。每周可投入 20 小时，承接 x402 / MCP / Solana 集成项目。

固定价格服务：

#	服务	价格	时长
1	将 x402 接入你的 Next.js / Node 应用——合并 PR 并进行线上测试	$900	2 天
2	x402 或 Solana 机器人架构与安全审查——提供书面报告并进行 60 分钟通话	$1000	1 天
3	AI Agent 付费 API：从 0 到在 Base 上线，并配备 MCP 封装	$1200	3 天

按小时计费： 开放范围项目 $150/小时，至少预订 5 小时。预付 40 小时以上可享 $125/小时。

收款方式： Base 上的 USDC 0x2a33D2414312e8776dA4011c2586c2d067267210、Solana 上的 USDC cR9KrbsLVJvir5rY9cfY3WeNoxMwUGofzpCoVyobryy，或按需使用 Wise-USD。

合作方式： 在此仓库中新建标题为 [Consulting]: <what you need> 的议题，或私信 @[email protected]。我会在一小时内回复项目范围和 50% 订金的收款地址。

我提供的结算路径强化方案演示： dev.to/sai_93caeceb4f6a4d9969910/shipped-x402-paid-endpoint-starter-kit-nextjs-16-5g39

另外： 面向 Solana / x402 / MCP 开发者的提示词包，见 cipher-checkout.vercel.app——共 5 个包，涵盖 Anchor 审计、x402 + MCP 设计、Solana 机器人工程、加密货币开发效率，以及一个优惠 20% 的组合包。支持银行卡或加密货币支付。

---

相关项目

• cipher-starter——免费的 MIT Solana 独立开发者手册 (github.com/cryptomotifs/cipher-starter)。
• cipher-solana-bot-toolkit——免费的 MIT 工具包：闪电贷路由器、交易量机器人、 套利/MEV 捕手、Memecoin 启动器、跟单交易机器人——包含 5 个已清理的模块 (github.com/cryptomotifs/cipher-solana-bot-toolkit)。
• cipher-solana-wallet-audit——免费的 GitHub Action（v1.1.0），发现明文 Solana 私钥时 会使 CI 失败 (github.com/cryptomotifs/cipher-solana-wallet-audit)。

小众 x402 端点（面向非加密货币 Agent 的服务）

• cipher-x402-pubmed——每次调用 $0.005，搜索 PubMed 医学文献 (cipher-x402-pubmed.vercel.app)。
• cipher-x402-osm——每次调用 $0.001，提供 OpenStreetMap 地理编码和反向地理编码 (cipher-x402-osm.vercel.app)。
• cipher-x402-usda——每次调用 $0.002，查询 USDA FoodData Central 营养数据 (cipher-x402-usda.vercel.app)。
• cipher-x402-fda——每次调用 $0.005，查询 openFDA 药物不良事件 (cipher-x402-fda.vercel.app)。

许可证

MIT——详见 LICENSE。