关键词

区块链支付数据访问智能合约加密货币API集成

x402 MCP 服务器使用指南

项目简介

x402 MCP服务器是一个基于Model Context Protocol构建的应用后端，专门为AI代理提供付费数据访问能力。通过集成x402协议，AI代理可以安全地使用USDC加密货币支付数据库查询和API调用费用。

主要功能

  • 发现数据发布者：浏览可用的付费数据源
  • 查询数据库：执行付费SQL查询并自动处理支付
  • 调用付费API：通过HTTP请求访问付费API服务
  • 信用余额管理：查询、存款和确认预付费信用余额
  • 自动支付处理：处理402状态码响应，签名授权并重新请求
  • 多钱包支持：支持私钥钱包和WalletConnect连接

安装步骤

快速运行（推荐）

X402_GATEWAY_URL=https://x402.serendb.com \
WALLET_PRIVATE_KEY=0xYOUR_KEY \
BASE_RPC_URL=https://mainnet.base.org \
SERENDB_CONNECTION_STRING=postgresql://serendb_owner:<password>@ep-<endpoint>.serendb.com/serendb?sslmode=require&channel_binding=require \
npx @serendb/x402-mcp-server

本地安装（可选）

npm install @serendb/x402-mcp-server

环境配置

创建.env文件并配置以下参数：

  • 'X402_GATEWAY_URL'：x402网关服务地址
  • 'WALLET_PRIVATE_KEY'：用于支付的钱包私钥
  • 'BASE_RPC_URL'：Base网络RPC端点
  • 'SERENDB_CONNECTION_STRING'：数据库连接字符串

MCP工具列表

  • 'list_publishers' - 列出可用的数据发布者
  • 'get_publisher_details' - 获取特定发布者详情
  • 'get_publisher_pricing_details' - 查询发布者定价配置
  • 'pay_for_query' - 执行付费API查询
  • 'query_database' - 执行付费SQL查询
  • 'check_credit_balance' - 查询预付费信用余额
  • 'deposit_credits' - 存款到信用余额
  • 'confirm_deposit' - 确认存款交易

基本使用方法

  1. 配置MCP客户端（Claude Desktop、Cursor等）的配置文件
  2. 设置环境变量或直接在配置中指定
  3. 重启客户端以加载MCP服务器
  4. 通过工具调用来发现数据源、查询数据并自动处理支付

该服务器兼容所有支持Model Context Protocol的客户端工具。

信息

分类

商业系统

访问项目