X402 MCP Stellar

x402恒星MCP服务器

本地MCP服务器（stdio），可以调用x402受保护的HTTP资源并自动以Stellar USDC支付。

特性

• 付款流程(stellar:testnet 或 stellar:pubnet)
• 默认测试网配置
• 通过环境交换机准备好主网
• 可选的OpenZeppelin引导程序通过env进行身份验证
• 无资源白名单：在工具调用时提供URL

暴露的工具

• x402_wallet_info：显示活动钱包地址/network/config
• x402_facilitator_supported：检查配置的主持人 /supported 端点
• fetch_paid_resource：通用付费获取(url, method，可选正文/页眉）

先决条件

• Node.js 20+
• 由测试网XLM+测试网USDC资助的恒星钱包
• x402资源服务器正在运行（您的 app/index.js 演示）
• x402引导器正在运行 http://localhost:4022

设置

npm install
cp .env.example .env

测试网

对于测试网，您需要在端口4022上本地运行一个引导程序。我建议使用coinbase x402仓库中包含的版本： https://github.com/coinbase/x402/tree/main/examples/typescript/facilitator/advanced

更新 .env 使用您的钱包钥匙：

STELLAR_SECRET_KEY=S...
STELLAR_NETWORK=stellar:testnet

Pubnet

对于主网，你只需要一个OpenZeppelin API密钥作为中继层。你可以在这里得到一个（谢谢你让这变得容易）： https://channels.openzeppelin.com/gen

STELLAR_NETWORK=stellar:pubnet
STELLAR_RPC_URL=https://rpc.lightsail.network/
X402_FACILITATOR_URL=https://channels.openzeppelin.com/x402
X402_FACILITATOR_API_KEY=

X402_FACILITATOR_API_KEY 通常是可选的，但OpenZeppelin频道是必需的。 当设置时， fetch_paid_resource 自动添加 Authorization: Bearer 对于以下请求 X402_FACILITATOR_URL （除非你提供 Authorization 明确）。

跑

npm run dev

MCP服务器在stdio上运行，用于Claude/Codex集成。

添加到克劳德/Codex

使用MCP条目，如（别忘了更改路径/）：

法典

codex mcp add x402-stellar -- npm --silent --prefix /absolute/path/to/x402-mcp-stellar run dev

克劳德代码

claude mcp add x402-stellar -- npm --silent --prefix /absolute/path/to/x402-mcp-stellar run dev

克劳德桌面（未经测试）

{
  "mcpServers": {
    "x402-stellar": {
      "command": "npm",
      "args": ["--silent", "--prefix", "/absolute/path/to/x402-mcp-stellar", "run", "dev"]
    }
  }
}

此服务器加载 .env 从项目目录(/absolute/path/to/x402-mcp-stellar/.env).

克劳德用法

加载MCP服务器后，您可以询问：

Can you fetch the resource at http://localhost:3000/my-service, use the x402-stellar MCP server to pay for it, and print the response?

工具调用将在运行时传递完整的URL；此MCP服务器中不需要URL分配列表或硬编码端点。

备注

• @x402/stellar 目前尚未在npm上发布，因此该仓库提供了Stellar机制 src/stellar.
• 默认的测试网Soroban RPC会自动使用。
• 主网需要 STELLAR_RPC_URL.

许可证

麻省理工学院