SOLx402 MCP Server

SOLx402 MCP Server

SOLx402 MCP Server is a Model Context Protocol (MCP) server that enables AI assistants to interact with the x402 payment protocol on Solana. It provides tools for discovering and consuming x402-enabled services, managing USDC payments, querying protocol documentation, and accessing Solana development resources through integrated MCP clients.

官方网站

流程图

整合

为了整合 SOLx402 MCP服务器，请按照以下步骤操作：

1. 去 SOLx402 MCP服务器Smithery页面.

1. 登录。

1. 单击配置按钮。

1. 填写必填字段（以及可选字段，如果需要）。

1. 使用API密钥和配置文件生成URL，然后复制它。

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

   {
       "mcpServers": {
               "solx402-mcp-server": {
                   "url": "https://server.smithery.ai/@leandrogavidia/solx402-mcp-server/mcp?api_key=&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：询问有关使用锚点框架在Solana上开发的问题。

- Solana_Expert__Ask_For_Help：获取有关Solana开发主题、概念、API、SDK和错误的专家帮助。

- 文档

- Solana_Documentation_Search：在Solana生态系统中搜索文档以获取最新信息。

______________________________________________________________________

⚠️ 重要提示：请求超时配置

关键设置要求： 使用此MCP服务器时，必须使用 最小请求超时为60000ms（60秒） 以确保x402服务消费的成功执行。

为什么这很重要：

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

配置示例：

{
  "mcpServers": {
    "solx402": {
      "url": "https://server.smithery.ai/@leandrogavidia/solx402-mcp-server/mcp?api_key=&profile=",
      "type": "streamable-http",
      "timeout": 120000 // 2 Minutes
    }
  }
}

查询参数：

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

• privateKey （必填）：Solana钱包的Base58编码私钥

• mainnetRpcUrl （必需）：用于主网操作的Solana RPC URL

• isMainnet （可选）：对于主网设置为true，对于devnet设置为false（默认值：false）

• facilitatorUrl （可选）：x402主持人的URL（默认：PayAI主持人URL）

• maxPrice （可选）：以美元为单位支付服务的最高价格，例如10000=0.01美元（默认值：0）

• useSolanaMcpServer （可选）：启用Solana开发工具集成（默认值：false）

相关问题：

• 克莱恩公关#1904 -请求超时配置
• 临床问题#4391 -超时相关问题

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

______________________________________________________________________

配置选项

1.查询参数

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

2.环境变量

您可以使用环境变量：

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