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）