索尔x402-MCP服务器

Name: 索尔x402-MCP服务器
Author: leandrogavidia

作者：leandrogavidia4 星标更新：2025-11-12

项目介绍

<div align="center"> <p></p> <img src="./apps/mcp-server/assets/solx402-logo.png" width=140 alt="Solana logo" /> <p></p> <h1>SOLx402 MCP 服务器</h1> <p> <a href="https://www.x402.org/" target="_blank"> <img src="./apps/mcp-server/assets/x402-badge.png" width=132 alt="x402 徽章"> </a>    <a href="https://smithery.ai/server/@leandrogavidia/solx402-mcp-server" target="_blank"> <img src="https://smithery.ai/badge/@leandrogavidia/marinade-finance-mcp-server" alt="smithery 徽章"> </a> </p> <p></p> <p>SOLx402 MCP 服务器是一个模型上下文协议（MCP）服务器，它使AI助手能够与Solana上的x402支付协议进行交互。它提供了发现和使用x402服务的工具，管理USDC支付，查询协议文档，并通过集成的MCP客户端访问Solana开发资源。</p>

</div>

数据流图

集成

要集成SOLx402 MCP 服务器，请按照以下步骤操作：

前往SOLx402 MCP 服务器 Smithery 页面。
登录。
点击配置按钮。
填写所需字段（如有需要，填写可选字段）。
使用您的API密钥和配置文件生成URL并复制。

将生成的MCP服务器URL添加到您的系统中（例如，Claude、Cursor、VS Code等）。

{
    "mcpServers": {
            "solx402-mcp-server": {
                "url": "https://server.smithery.ai/@leandrogavidia/solx402-mcp-server/mcp?api_key=<YOUR-SMITHERY-API-KEY>&profile=<YOUR-SMITHERY-PROFILE>",
                "type": "streamable-http",
                "timeout": 120000
            },
        }
}

工具

x402 协议
- 文档
  - search_x402_documentation: 在x402文档中搜索相关信息、代码示例、API参考和指南。
  - x402_protocol_flow: 显示x402协议流程和架构的可视化图表。
- 服务发现
  - get_x402_services: 从协调者处获取可用的x402服务列表。
  - get_facilitators: 获取已知的Solana协调者列表。
- 服务消费
  - consume_x402_service: 自动处理支付，消费特定的x402服务。
    
    ⚠️ 注意： x402服务是由第三方团队维护的外部服务。虽然这些服务出现在发现层，但它们可能会暂时下线、不可用或出现问题。服务可用性完全取决于外部团队的管理。
钱包操作
- 钱包信息
  - get_wallet_public_key: 获取配置的钱包公钥。
- 余额
  - get_wallet_usdc_balance: 检查配置的钱包中的USDC代币余额。
Solana 开发资源（可选）
- 专家协助
  - Ask_Solana_Anchor_Framework_Expert: 关于使用Anchor框架在Solana上开发的问题。
  - Solana_Expert__Ask_For_Help: 获取关于Solana开发主题、概念、API、SDK和错误的专家帮助。
- 文档
  - Solana_Documentation_Search: 在Solana生态系统中搜索最新的文档信息。

⚠️ 重要：请求超时配置

关键设置要求： 使用此MCP服务器时，必须将您的MCP客户端配置为最小请求超时60,000毫秒（60秒），以确保成功执行x402服务消费。

为什么这很重要：

x402服务是外部API，可能需要大量的处理时间。
支付交易在Solana区块链上执行，确认需要时间。
短超时可能导致请求失败在USDC已被扣款后，导致支付但未收到服务。
默认情况下，MCP服务器运行时的最大请求超时为10秒，在某些情况下这非常低。

配置示例：

{
  "mcpServers": {
    "solx402": {
      "url": "https://server.smithery.ai/@leandrogavidia/solx402-mcp-server/mcp?api_key=<YOUR-SMITHERY-API-KEY>&profile=<YOUR-SMITHERY-PROFILE>",
      "type": "streamable-http",
      120000 // 2分钟
    }
  }
}

查询参数：

MCP服务器现在接受通过URL查询参数进行配置，使得设置更简单和灵活：

privateKey（必需）：您的Solana钱包的Base58编码私钥
mainnetRpcUrl（必需）：用于主网操作的Solana RPC URL
isMainnet（可选）：对于主网设置为true，对于测试网设置为false（默认：false）
facilitatorUrl（可选）：x402协调者的URL（默认：PayAI协调者URL）
maxPrice（可选）：服务的最大支付价格，单位为USDC微分，例如10000 = 0.01 USDC（默认：0）
useSolanaMcpServer（可选）：启用Solana开发工具集成（默认：false）

配置选项

1. 查询参数

如上所示，在MCP客户端URL中直接传递配置。

2. 环境变量

您可以使用环境变量：

PORT：您的MCP服务器运行的端口（默认：8001）
HOST：您的MCP服务器运行的主机（默认：127.0.0.1）