Solx402 MCP Server

🚀 SOLx402 MCP Server

SOLx402 MCP Serverは、AIアシスタントがSolana上のx402支払いプロトコルとやり取りできるようにするModel Context Protocol (MCP)サーバーです。x402対応サービスの発見と利用、USDC支払いの管理、プロトコルドキュメントの照会、統合されたMCPクライアントを通じたSolana開発リソースへのアクセスなどのツールを提供します。

公式ページ

🚀 クイックスタート

統合方法

SOLx402 MCP Serverを統合するには、以下の手順に従ってください。

1. SOLx402 MCP Server Smitheryページにアクセスします。
2. サインインします。
3. 「Configure」ボタンをクリックします。
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：Anchor Frameworkを使用したSolana開発に関する質問をします。
  • Solana_Expert__Ask_For_Help：Solana開発のトピック、概念、API、SDK、エラーに関する専門家の支援を受けます。
• ドキュメント
  • Solana_Documentation_Search：Solanaエコシステム全体のドキュメントを検索して、最新の情報を取得します。

🔧 技術詳細

⚠️ 重要：リクエストタイムアウトの設定

重要な設定要件：このMCPサーバーを使用する際には、x402サービスの利用を正常に実行するために、MCPクライアントに最低60,000ms（60秒）のリクエストタイムアウトを設定することが不可欠です。

なぜこれが重要なのか

• 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）