AI代理支付API服务

Bismuth (x402 API网络)提供的按使用付费的AI代理API服务,支持通过Base网络自动进行USDC小额支付。

  • by jameswilliamwisdom
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jameswilliamwisdom/x402-mcp-server

使用说明

铋--x402 MCP服务器

人工智能代理的一次性付费API,由Bismuth(x402 API网络)提供支持。一个npm安装,在Base上自动进行USDC小额支付。

工具

工具 描述 价格
x402_network_info 列出所有API及其定价和运行状况 免费
x402_screenshot 将任何URL捕获为base64图像 $0.01/捕获
x402_pdf_extract 通过URL从PDF中提取文本 $0.01/提取
x402_sentiment 加密货币的实时情绪分析 $0.01/查询
x402_market_overview 广泛的加密货币市场情绪概述 $0.05/查询
x402_intelligence 多源加密智能(CoinGecko、DeFiLlama、新闻、GitHub) 0.10美元/查询
x402_send_email 通过重新发送CC、BCC和文件附件发送交易电子邮件 $0.01/电子邮件
x402_scrape_url 抓取任何URL并返回结构化标记、链接、表、元数据 $0.02/抓取
x402_convert_file 转换文件:调整图像大小/重新格式化,CSV转换为JSON,HTML转换为PDF,DOCX转换为PDF 0.02美元/转换
x402_web_search 通过Tavily使用排名结果和可选的AI答案搜索网络 $0.01/搜索
x402_transcribe_audio 使用自动语言检测和单词时间戳转录音频文件 $0.05/转录
x402_crawl_site 通过BFS抓取网站并返回每页标记、链接、表格、图像、元数据 $0.10/抓取

2.0.0中的新功能

三个功能扩展和一个新工具:

  • 浅层场地爬行 新 x402_crawl_site 工具:BFS从种子URL抓取最多15个页面
  • 电子邮件CC/BCC/附件 — x402_send_email 现在接受cc、bcc和base64文件附件
  • DOCX转PDF — x402_convert_file 现在支持类型:“docx”进行docx文档转换

快速启动-自由模式

无需钱包或私钥。将服务器添加到MCP客户端配置中:

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"]
    }
  }
}

自由模式限制:

  • 截图仅限于example.com、example.org和httpbin.org
  • PDF提取仅限于前3页
  • 情绪返回具有真实市场结构的模拟数据
  • 电子邮件返回假邮件ID(无法投递)
  • 刮擦返回夹具数据(无实时刮擦)
  • 文件转换返回夹具数据(无实时转换)
  • 网络搜索返回固定结果(无实时搜索)
  • 转录返回固定转录(无实时转录)
  • 站点爬网返回夹具数据(无实时爬网)

快速入门--付费模式

需要一个由USDC资助的基础钱包。

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

永远不要提交你的私钥。将其存储在您的系统环境或本地 .env shell加载的文件。

您需要在Base网络上使用USDC。Base是一个以太坊L2,交易费用低。看 完整钱包设置指南 详细说明。

MCP客户端配置

省略 env 完全免费模式下的块。

克劳德桌面版

配置文件位置:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

克劳德代码

claude mcp add --transport stdio x402 -- npx -y x402-mcp-server

然后设置 X402_PRIVATE_KEY 在您的环境中。

光标

配置文件: ~/.cursor/mcp.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

帆板运动

配置文件: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "x402": {
      "command": "npx",
      "args": ["-y", "x402-mcp-server"],
      "env": {
        "X402_PRIVATE_KEY": "your-private-key-here"
      }
    }
  }
}

运作原理

  1. 你的AI代理调用一个工具(例如。, x402_screenshot)
  2. MCP服务器向API发出HTTP请求
  3. API以 402 Payment Required
  4. x402-fetch 在Base上自动签署USDC付款并重试
  5. API返回结果

付款流程由以下人员处理 x402-fetch --你的代理人永远不需要直接管理交易。

许可证

麻省理工学院