MCP Pay Server

MCP Pay Server

HTTP+SSE トランスポートを使用した Model Context Protocol（MCP）サーバーのスタンドアロン実装で、基本的な前払いクレジットシステムを備えています。

機能

• MCP のツール、リソース、プロンプトを公開します
• 双方向通信に HTTP+SSE をサポートします
• Base（または Base Sepolia）での USDC 入金を使用したシンプルな決済レイヤーを実装しています
• Express、TypeScript、Viem、Zod で構築されています

セットアップ

1. 依存関係をインストールします：

   npm install
   

2. 環境変数を設定します： ルートディレクトリ（mcp-pay-server/.env）に次の内容の .env ファイルを作成します。

   # 必須：サーバーが USDC 入金を監視するウォレットの公開アドレス
   SERVER_DEPOSIT_ADDRESS=0xYourServerWalletPublicAddress
   
   # 任意：Base または Base Sepolia の RPC URL（デフォルト値が設定されています）
   # BASE_RPC_URL=https://your-base-rpc-url
   
   # 任意：サーバーのポート（デフォルトは 3000）
   # PORT=3001
   

   • SERVER_DEPOSIT_ADDRESS：サーバーが入金を監視する 0x... 形式の公開アドレスです。
   • BASE_RPC_URL：Base ブロックチェーン（メインネットまたは Sepolia）との通信に使用する RPC エンドポイントです。
   • PORT：HTTP サーバーがリッスンするポートです。

使用方法

サーバーを起動します：

npm start

これにより MCP サーバーが起動し、設定された SERVER_DEPOSIT_ADDRESS への USDC 入金の監視が開始されます。

決済システムの概要

このサーバーでは、暗号署名によって検証される前払いクレジットシステムを使用します。クライアントは接続後、決済機能を個別に取得します。

1. 接続： クライアントがサーバーに接続します。
2. 機能の取得： クライアントが payments/getCapabilities メソッドを呼び出し、次の情報を受け取ります。
   • 入金情報を提供するリソースの URI（例：mcp-pay://server/payment/info）。
   • 残高確認に使用するツールの名前（例：payments_getBalance）。
   • 支払いが必要なツールと、それぞれの費用の一覧（文字列形式）。
3. 入金情報： クライアントは入金情報リソース（URI は機能情報から取得）を読み取り、サーバーの USDC 入金アドレスを確認します。
4. クレジット： クライアントは（設定されたネットワーク上で）入金アドレスに USDC を送金します。サーバーはこのアドレスを監視し、送金者のアカウントにクレジットを付与します。
5. 有料ツールの使用： クライアントが機能情報で有料として指定されたツールを呼び出す場合：
   • params.arguments に __payer（クライアントの 0x... 形式のアドレス）と __signature（正規化されたリクエストの ECDSA 署名）を含める必要があります。
   • サーバーの中央ミドルウェアが署名を検証し、ツールのロジックを実行する前に、支払者の残高がツールの費用を満たしているか確認します。
   • 検証に成功するとツールが実行されます。ツールの実行が成功した場合、支払者の残高から費用が差し引かれます。
6. 残高の確認： クライアントは残高確認ツール（名前は機能情報から取得）を使用し、引数として payerAddress を渡します。このツールに署名は不要です。

利用可能なエンドポイント

• POST /mcp - クライアントからサーバーへのリクエストに使用します（mcp-session-id ヘッダーが必要です）。一般的な MCP メソッドと payments/getCapabilities を処理します。
• GET /mcp - SSE（Server-Sent Events）ストリームに使用します（mcp-session-id ヘッダーが必要です）。

決済機能（payments/getCapabilities で公開）

• 入金情報リソース URI： mcp-pay://server/payment/info（デフォルト）
• 残高確認ツール： payments_getBalance（デフォルト）
• 有料ツール（例）：
  • greet：0.05 USDC（デフォルト）
  • (その他も設定できます)

利用可能なツール

• greet：シンプルな挨拶ツール（デフォルトで支払いが必要です）。
• payments_getBalance：呼び出し元のウォレットのクレジット残高を返します（無料）。

利用可能なリソース

• mcp-pay://server/payment/info：サーバーの入金アドレスを返します。

開発

TypeScript コードをビルドします：

npm run build