Solx402 MCP Server

🚀 SOLx402 MCP服务器

SOLx402 MCP服务器是一个模型上下文协议（MCP）服务器，它能让AI助手与Solana上的x402支付协议进行交互。该服务器提供了一系列工具，可用于发现和使用支持x402的服务、管理USDC支付、查询协议文档，以及通过集成的MCP客户端访问Solana开发资源。

官方页面

🚀 快速开始

集成步骤

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

1. 访问 SOLx402 MCP服务器Smithery页面。
2. 登录账号。
3. 点击“配置”按钮。
4. 填写必填字段（如有需要，也可填写可选字段）。
5. 使用你的API密钥和配置文件生成URL，然后复制该URL。
6. 将生成的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",
      "timeout": 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）

相关问题：

• Cline PR #1904 - 请求超时配置
• Cline Issue #4391 - 超时相关问题

注意：始终确保MCP客户端的超时时间至少为120秒，以防止支付问题和服务消费失败。

📚 详细文档

配置选项

1. 查询参数

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

2. 环境变量

你可以使用以下环境变量：

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