AI导哈

加密货币打赏服务

tip.md是一个允许开发者通过嵌入GitHub READMEs、网站或任何Markdown内容的简单按钮直接接收加密货币打赏到钱包的平台，支持多区块链、直接到钱包支付和简单集成。

  • by xR0am
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 xR0am/tip-md-x402-mcp-server

使用说明

tip.md x402+CDP MCP服务器

🏆 黑客马拉松参赛：使用x402支付收款和CDP自动支付，将任何AI代理转换为支持支付的小费代理。

🌟 关于tip.md

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

  • 多个区块链：以太坊、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支付协议从专用钱包支付（Money IN）
  • CDP自动支付：后端通过Coinbase Wallet API（Money OUT）自动拆分付款（96%的收款人，4%的平台）
  • MCP工具集成：可与Claude、ChatGPT、Cursor或任何MCP兼容代理配合使用
  • 真正的可组合性：将现有的人工智能工作流程转化为支持支付的体验

🔄 完整流程

  1. 用户：“检查余额” → 代理人： “47.50美元可用于支付小费”
  2. 用户询问AI代理：“提示@用户名5美元”
  3. x402收款：代理生成付款请求，用户从专用钱包付款
  4. CDP自动支付：后端拆分付款并发送给收款人+平台
  5. AI确认: "✅ 已向@username发送5美元

建筑：真正的x402→ CDP流

用户支付流程

User → Dedicated Tipping Wallet → x402 Payment Collection → CDP Agent Wallet → CDP Disburses to Recipient (96%) + Platform (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-无x402/CDP流）

🏥 系统工具

  • mcp_tip_md_ping：健康检查端点

🧪 使用MCP客户端进行测试

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

光标IDE设置

  1. 编辑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"
      }
    }
  }
}

  1. 重新启动游标 并寻找🔨 工具图标

  2. 测试演示:

    • 类型：“提示用户johndoe 5 USDC使用基础区块链”
    • 观看x402+CDP模拟的实际操作！

Claude桌面设置

  1. 安装超级网关 （将我们的HTTP传输桥接到stdio）：
npm install -g supergateway
  1. 配置Claude桌面 (~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "tip-md-demo": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway",
        "--httpStream",
        "http://localhost:3000/mcp",
        "--outputTransport",
        "stdio"
      ]
    }
  }
}
  1. 启动MCP服务器 在演示模式下：
NODE_ENV=demo npm start
  1. 重新启动克劳德桌面 并使用以下命令进行测试：“显示可用的tip.md工具”

其他MCP客户端

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

  • 端点: http://localhost:3000/mcp （在本地运行时）
  • 运输：HTTP流
  • 环境：设置 NODE_ENV=demo 用于模拟模式

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

要与tip.md平台完全集成：

环境变量

创建一个 .env 文件：

# Database Connection (Required for production)
MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/database

# Coinbase Developer Platform (Required for CDP disbursement)
CDP_API_KEY_ID=your_cdp_api_key_id
CDP_API_KEY_SECRET=your_cdp_api_key_secret

# x402 Configuration (Required for payment collection)
X402_WALLET_PRIVATE_KEY=your_x402_wallet_private_key

# Optional Configuration
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

关键差异

  1. 通用代理集成：任何MCP客户端都可以进行支付
  2. 完成付款流程：x402收款+CDP付款在一个解决方案中
  3. 零设置演示：法官可以立即进行评估
  4. 生产准备就绪：已与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黑客马拉松打造 🏆

相关 MCP