提示-md-x402-mcp服务器

Name: 提示-md-x402-mcp服务器
Author: xR0am

作者：xR0am6 星标更新：2025-09-11

安装使用来源：spider==github.com

项目介绍

tip.md x402 + CDP MCP Server

🏆 黑客马拉松参赛作品: 使用x402支付收集功能与CDP自动分发功能，将任何AI代理转换为支持支付的小费代理。

🌟 关于 tip.md

tip.md 是一个平台，允许开发者通过在GitHub README、网站或任何Markdown内容中嵌入简单按钮，直接将加密货币小费发送到他们的钱包。它支持：

多个区块链: 以太坊、Base、Solana 和比特币闪电网络
直接到钱包支付: 小费直接进入你的钱包，无需托管
简单的集成: 一个按钮，适用于所有支持Markdown的地方
4% 平台费用: 透明定价，只有你在赚钱时我们才赚钱
客户端安全: 所有交易都在浏览器中安全处理

此MCP服务器扩展了tip.md的功能，使任何AI代理能够通过创新的x402 + CDP集成来促进加密货币小费。

🚀 快速演示（无需设置）

对于评委和评估者: 立即体验x402 + CDP小费流程：

git clone https://github.com/xR0am/tip-md-x402-mcp-server.git
cd tip-md-x402-mcp-server
npm install
NODE_ENV=demo npm start

⚠️ 重要提示: 单独运行的服务器仅显示日志，要查看演示支付功能，你需要将其连接到MCP客户端（参见下方的[MCP客户端测试]）。

🎯 功能概述

核心创新: 任何AI代理 + 此MCP = 即时支付启用代理

x402 支付收集: 用户使用x402支付协议从专用钱包付款（资金流入）
CDP 自动分发: 后端自动分配支付（96%给接收者，4%给平台），通过Coinbase Wallet API（资金流出）
MCP工具集成: 与Claude、ChatGPT、Cursor或任何兼容MCP的代理配合工作
真正的可组合性: 将现有的AI工作流转变为支持支付的体验

🔄 完整流程

用户: "检查余额" → 代理: "可用47.50 USDC用于小费"
用户请求AI代理: "给@username小费5 USDC"
x402 支付收集: 代理生成支付请求，用户从专用钱包支付
CDP 自动分发: 后端分配支付并发送给接收者+平台
AI确认: "✅ 已发送5 USDC给@username"

架构：真正的x402 → CDP流程

用户支付流程

用户 → 专用小费钱包 → x402支付收集 → CDP代理钱包 → CDP分发给接收者(96%) + 平台(4%)

📋 可用的MCP工具

此MCP服务器暴露了7个工具，任何AI代理都可以使用：

💰 x402 + CDP支付工具（黑客马拉松创新）

mcp_tip_md_tip_on_base: 使用x402支付协议和CDP自动分发，在Base上发送USDC小费
mcp_tip_md_tip_on_solana: 使用x402支付协议，在Solana上发送USDC小费
mcp_tip_md_check_tipping_balance: 检查/创建你的专用小费钱包余额和信息

🔧 钱包管理工具

mcp_tip_md_export_tipping_wallet: 导出你的小费钱包私钥（敏感操作）
mcp_tip_md_withdraw_tipping_funds: 从小费钱包中提取USDC到任意地址

🔍 用户及网络工具

mcp_tip_md_get_user_wallet_types: 检查接收者的支持加密货币和钱包类型
mcp_tip_md_crypto_tipping: 供具有钱包的代理手动进行加密货币小费的信息（以太坊、Base、Solana - 不涉及x4_02/CDP流程）

🏥 系统工具

mcp_tip_md_ping: 健康检查端点

🧪 使用MCP客户端测试

要查看实际演示支付功能，你需要将MCP服务器连接到兼容客户端：

Cursor IDE 设置

编辑你的MCP配置 (~/.cursor/mcp.json)：

{
  "mcpServers": {
    "tip-md-demo": {
      "command": "node",
      "args": ["dist/mcp-server/src/index.js"],
      "cwd": "/path/to/tip-md-x402-mcp-server",
      "env": {
        "NODE_ENV": "demo"
      }
    }
  }
}

重启Cursor 并查找🔨工具图标
测试演示：
- 输入: "使用Base区块链给用户johndoe小费5 USDC"
- 观看x402 + CDP模拟过程！

Claude Desktop 设置

安装Supergateway（桥接我们的HTTP传输到stdio）：

npm install -g supergateway

配置Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)：

{
  "mcpServers": {
    "tip-md-demo": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--httpStream",
        "http://localhost:3000/mcp",
        "--outputTransport",
        "stdio"
      ]
    }
  }
}

启动MCP服务器 在演示模式下：

NODE_ENV=demo npm start

重启Claude Desktop 并测试："展示可用的tip.md工具"

其他MCP客户端

对于支持HTTP-stream传输的客户端：

端点: http://localhost:3000/mcp（本地运行时）
传输: HTTP-stream
环境: 设置NODE_ENV=demo以模拟模式运行

🛠️ 生产集成（需要设置）

为了与tip.md平台完全集成：

环境变量

创建一个.env文件：

# 数据库连接（生产必需）
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/database

# Coinbase开发者平台（CDP分发必需）
CDP_API_KEY_ID=your_cdp_api_key_id
CDP_API_KEY_SECRET=your_cdp_api_key_secret

# x402配置（支付收集必需）
X402_WALLET_PRIVATE_KEY=your_x402_wallet_private_key

# 可选配置
PORT=3000
NODE_ENV=production
LOG_LEVEL=info

生产部署

npm install
npm run build
npm start

🏗️ 技术架构

x402支付收集

专用钱包: 每个用户都有一个独特的支付钱包
协议合规: 完全实现x402规范

CDP自动分发

智能拆分: 96%给接收者，4%给平台
即时结算: 通过Coinbase开发者平台自动化

MCP集成

通用兼容性: 与任何兼容MCP的AI代理配合工作
结构化响应: 丰富的JSON响应，无缝集成
错误处理: 平滑回退和详细的错误消息

🎖️ 黑客马拉松提交详情

挑战: Coinbase x402 + CDP集成创新: 通用AI代理支付启用 演示模式: NODE_ENV=demo npm start 仓库: https://github.com/xR0am/tip-md-x402-mcp-server

关键差异点

通用代理集成: 任何MCP客户端都成为支付启用的
完整的支付流程: x402收集 + CDP分发在一个解决方案中
零设置演示: 评委可以立即评估
生产就绪: 已与tip.md平台集成

📚 更多了解

tip.md平台: https://tip.md
MCP协议: https://modelcontextprotocol.io
x402规范: https://docs.coinbase.com/x402
Coinbase CDP: https://docs.cdp.coinbase.com

🤝 支持

关于此次黑客马拉松参赛作品的问题：

问题: 在GitHub上打开一个问题
邮件: support@tip.md
演示问题: 确保你是通过MCP客户端测试，而不仅仅是服务器日志

为Coinbase x402 + CDP黑客马拉松构建 🏆