AI导哈

AI支付桥接服务

x402-MCP Bridge是一个AI优先的Cronos x402支付桥接服务，通过将链上数据标准化为结构化、可解释的格式，促进AI代理与支付系统的交互。

  • by FlemingJohn
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 FlemingJohn/x402-mcp-bridge

使用说明

x402 MCP桥

Cronos x402支付的AI第一桥梁。该服务器通过将链上数据标准化为结构化、可解释的格式，促进了AI代理与支付的交互。

开发人员快速入门

1.先决条件

  • Node.js：v18或更高版本。
  • 代币：Cronos测试网上的TCRO（从 克罗诺斯水龙头).
  • 私钥：用于签署交易的开发人员钱包私钥（只读工具可选）。

2.设置

克隆存储库并安装依赖项：

npm install

3.配置

创建一个 .env 基于示例的文件：

cp .env.example .env

填写您的 CRONOS_RPC_URL, X402_FACILITATOR_ADDRESS，以及 PRIVATE_KEY.

4.运行服务器

在开发模式下启动网桥：

npm run dev

服务器将于启动 http://localhost:4020.

与MCP工具交互

该桥在以下位置公开了一个统一的MCP接口 /api/mcp。您可以使用标准的HTTP POST请求与它进行交互。

工具： get_agent_balance

检查特定地址的链上余额。

请求:

{
  "tool": "get_agent_balance",
  "params": {
    "address": "0xYourAddressHere"
  }
}

工具： get_payment_history

检索代理的索引历史付款。

请求:

{
  "tool": "get_payment_history",
  "params": {
    "agent_id": "agent_123"
  }
}

工具： get_token_balance

获取指定Cronos地址的USDC余额。

请求:

{
  "tool": "get_token_balance",
  "params": {
    "address": "0xYourAddressHere"
  }
}

工具： estimate_gas_cost

从Cronos网络获取当前的天然气价格和费用数据。

请求:

{
  "tool": "estimate_gas_cost",
  "params": {}
}

工具： generate_verification_deep_link

为交易哈希生成一个直接的区块浏览器web链接。

请求:

{
  "tool": "generate_verification_deep_link",
  "params": {
    "tx_hash": "0xabc..."
  }
}

AI代理客户端（Gemini供电）

这座桥上有一位原住民 “克洛诺斯特工” 使用的客户端 谷歌双子座 通过工具调用与x402 MCP桥进行交互。

1.配置

将您的Gemini API密钥和钱包私钥添加到 .env:

GEMINI_API_KEY=AIza...
PRIVATE_KEY=0x...

2.运行代理

代理会自动从私钥中检测您的钱包地址，因此您可以自然地说话：

npm run agent "What is my balance?"

（Windows注意事项： node_modules\.bin\ts-node.cmd src\agent\agent.ts "What is my balance?")

主要特点

  • 自动上下文：知道您的钱包地址和水龙头URL(https://cronos.org/faucet).
  • 动态模型分辨率：自动查找API密钥的最佳Gemini模型（Flash/Pro/Lite）。
  • 费率限制处理：强大的指数回退防止 429 免费等级帐户上的错误。

项目结构

  • src/blockchain/: 模块化区块链层 （v2）
    • config.ts：网络常数和合约地址。
    • client.ts：Ethers.js提供程序和协调器SDK初始化。
    • cronos.ts: CronosService 类为所有工具提供业务逻辑。
  • src/db/：SQLite持久性用于本地数据索引。
  • src/indexer/：链上事件监控逻辑。
  • src/mcp/：MCP端点和刀具布线。
  • src/agent/: 模块化AI代理客户端
    • agent.ts：主要编排者和切入点。
    • tools.ts：Gemini的工具（功能）定义。
    • utils.ts：辅助逻辑（重试、模型解析）。
    • mcp.ts：MCP服务器通信的网桥客户端。
  • data/：SQLite数据库的本地存储（自动创建）。
  • frontend/：使用React+Vite构建的高级登录页面（金色和黑色）。

相关 MCP