AI导哈

x402支付协议服务器

SOLx402 MCP服务器是一个模型上下文协议（MCP）服务器，使AI助手能够通过x402支付协议与Solana区块链交互，提供发现和消费x402服务、管理USDC支付、查询协议文档以及通过集成的MCP客户端访问Solana开发资源的功能。

  • by leandrogavidia
  • TypeScript
  • 云端部署
  • 8 星标
  • 更新于
在 GitHub 查看 leandrogavidia/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页面.

  2. 登录。

  3. 单击配置按钮。

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

  5. 使用API密钥和配置文件生成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：询问有关使用锚点框架在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=<YOUR-SMITHERY-API-KEY>&profile=<YOUR-SMITHERY-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）

相关问题：

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

配置选项

1.查询参数

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

2.环境变量

您可以使用环境变量：

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

相关 MCP