MCP Sse Sample

🚀 MCP SSE サンプル

SSE（Server-Sent Events）を使用したMCPサーバーのサンプルプロジェクトです。MCPプロトコルにおけるSSEの実装方法を示しています。

✨ 主な機能

ツール

1. echo

   • 入力されたメッセージをエコーバックするシンプルなツールです。
   • 入力:
     • message (文字列): エコーバックするメッセージ
   • 返り値: エコーバックされたメッセージを含むテキスト内容

2. add

   • 2つの数字を足し合わせます。
   • 入力:
     • a (数字): 1つ目の数字
     • b (数字): 2つ目の数字
   • 返り値: 足し算の結果のテキスト

3. longRunningOperation

   • 長時間実行される操作の進捗通知を表示します。
   • 入力:
     • duration (数字, デフォルト: 10): 実行時間（秒）
     • steps (数字, デフォルト: 5): 進捗ステップの数
   • 返り値: 実行時間とステップ数を含む完了メッセージ
   • 実行中に進捗通知を送信します。

4. sampleLLM

   • MCPのサンプリング機能を使用して、LLMのサンプリング能力をデモします。
   • 入力:
     • prompt (文字列): LLMに送信するプロンプト
     • maxTokens (数字, デフォルト: 100): 生成する最大トークン数
   • 返り値: LLMが生成した応答

5. getTinyImage

   • 小さなテスト画像を返します。
   • 入力は不要です。
   • 返り値: Base64エンコードされたPNG画像データ

6. printEnv

   • すべての環境変数を表示します。
   • MCPサーバーの設定をデバッグするために使用します。
   • 入力は不要です。
   • 返り値: すべての環境変数のJSON文字列

7. annotatedMessage

   • 注釈を使用してコンテンツのメタデータを提供する方法を示します。
   • 入力:
     • messageType (列挙型: "error" | "success" | "debug"): 表示するメッセージのタイプ
     • includeImage (ブール値, デフォルト: false): サンプル画像を含めるかどうか
   • 返り値: 異なる注釈付きのコンテンツ:
     • エラーメッセージ: 高優先度（1.0）、ユーザーとアシスタントの両方に表示
     • 成功メッセージ: 中優先度（0.7）、ユーザー向け
     • デバッグメッセージ: 低優先度（0.3）、アシスタント向け
     • オプションの画像: 中優先度（0.5）、ユーザー向け
   • 注釈の例:

     {
       "priority": 1.0,
       "audience": ["user", "assistant"]
     }
     

ログ

サーバーは15秒ごとにランダムなレベルのログメッセージを送信します。例えば：

{
  "method": "notifications/message",
  "params": {
    "level": "info",
    "data": "Info-level message"
  }
}

📦 インストール

ローカルでの実行

# インストール
npm install

# ビルド
npm run build

# 実行(STDIOモード)
npm run start

# 実行(SSEモード)
npm run start:sse

Claude Desktopでの使用

claude_desktop_config.jsonファイルに以下の内容を追加します：

{
  "mcpServers": {
    "sse-sample": {
      "command": "npx",
      "args": [
        "-y",
        "mcp_sse_sample"
      ]
    }
  }
}