x402 MCP桥
Cronos x402支付的AI第一桥梁。该服务器通过将链上数据标准化为结构化、可解释的格式，促进了AI代理与支付的交互。
开发人员快速入门
1.先决条件
- Node.js：v18或更高版本。
- 代币：Cronos测试网上的TCRO（从 克罗诺斯水龙头).
- 私钥：用于签署交易的开发人员钱包私钥（只读工具可选）。
2.设置
克隆存储库并安装依赖项：
npm install3.配置
创建一个 .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构建的高级登录页面（金色和黑色）。