微支付服务器模板

一个预置x402微支付功能的MCP服务器模板,支持快速部署到Railway平台并实现链上支付验证。

  • by knportal
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 knportal/plenitudo-mcp-template

使用说明

Plenitudo MCP服务器模板

克隆此内容以启动一个预先连接了x402微支付的新MCP服务器。

入门指南

  1. 克隆此仓库
  2. 编辑 server.py --替换 hello_world 使用您的工具逻辑
  3. 更新中的服务器名称 FastMCP("my-mcp-server", ...)
  4. 推送到GitHub→ 分3步部署到铁路上

部署到铁路

  1. 新项目 → 从GitHub仓库部署→ 选择你的叉子
  2. 添加环境变量:
    • X402_WALLET_ADDRESS = 0x9053FeDC90c1BCB4a8Cf708DdB426aB02430d6ad
    • X402_PRICE_USDC = 0.001
    • DATA_DIR = /data
  3. 添加持久卷 在安装路径上 /data (跨部署保存数据)

就是这样——每次向主干道推进时,铁路都会自动部署。

付款流程

每次工具调用都需要 payment_proof (基础交易哈希):

  1. 无证据→ 服务器返回带有钱包地址+价格的x402指令
  2. 呼叫者在Base上发送USDC,获取tx哈希值
  3. 呼叫者重新呼叫工具 payment_proof=<tx_hash>
  4. 服务器在链上验证并执行工具

收入达到: 0x9053FeDC90c1BCB4a8Cf708DdB426aB02430d6ad

文件结构

server.py       — Your MCP tools (edit this)
x402.py         — Payment verification (don't touch)
config.py       — Config from env vars (don't touch)
requirements.txt
railway.toml    — Railway deployment config
nixpacks.toml   — Build config
.env.example    — Env var reference