MCP Ts Starter

🚀 こんにちは MCP 世界サーバー

TypeScript で実装されたシンプルな Model Context Protocol (MCP) サーバーです。このサーバーは、リソース、プロンプト、ツールを含む基本的な MCP 機能をデモンストレートします。

✨ 主な機能

• SSE と STDIO のトランスポートをサポート
• 静的および動的なリソース処理
• サンプルプロンプトの実装
• エコーメッセージのサンプルツール
• サーバーの内部状態を確認するためのデバッグツール

🚀 クイックスタート

前提条件

• Node.js (v16 以上)
• npm または yarn

📦 インストール

npm install

ビルド

npm run build

サーバーの起動

HTTP/SSE トランスポート（Web ブラウザ）

npm run start:http

このコマンドは http://localhost:3000 でサーバーを起動します。以下のエンドポイントが含まれます：

• SSE エンドポイント：/sse
• メッセージエンドポイント：/messages

STDIO トランスポート（コマンドライン）

npm run start

このコマンドは、コマンドライン統合に適した stdio モードでサーバーを実行します。

サーバーのテスト

cURL を使ったテスト

1. HTTP サーバーを起動します：

   npm run start:http
   

2. ターミナルウィンドウで SSE エンドポイントに接続します：

   curl -N http://localhost:3000/sse
   

   以下のようなレスポンスが表示されるはずです：

   event: endpoint
   data: /messages?sessionId=YOUR_SESSION_ID
   

3. 別のターミナルウィンドウで、エコーツールを呼び出すリクエストを送信します：

   curl -X POST \
     "http://localhost:3000/messages?sessionId=YOUR_SESSION_ID" \
     -H 'Content-Type: application/json' \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/invoke",
       "params": {
         "name": "echo",
         "parameters": {
           "message": "Testing the MCP server!"
         }
       }
     }'
   

4. SSE ターミナルウィンドウに以下のようなレスポンスが表示されるはずです：

   event: message
   data: {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"Hello Testing the MCP server!"}]}}
   

5. デバッグツールを使って、利用可能なすべてのサーバーメソッドを表示します：

   curl -X POST \
     "http://localhost:3000/messages?sessionId=YOUR_SESSION_ID" \
     -H 'Content-Type: application/json' \
     -d '{
       "jsonrpc": "2.0",
       "id": 2,
       "method": "tools/invoke",
       "params": {
         "name": "debug",
         "parameters": {}
       }
     }'
   

MCP インスペクターを使ったテスト

視覚的なインターフェースを利用するには、MCP インスペクターツールを使用できます。

1. MCP インスペクターで http://localhost:3000/sse に接続します。
2. 利用可能なリソースとツールを確認します。
3. ツールを対話的に呼び出します。

📚 ドキュメント

サーバー API

リソース

• hello://world - 静的な「こんにちは、世界」リソース
• greeting://{name} - 名前パラメータ付きの動的なあいさつ

ツール

• echo - メッセージをエコーし、「こんにちは」を先頭に付けます。
• debug - 利用可能なすべてのツールとメソッドを一覧表示します。

プロンプト

なし。

トラブルシューティング

なし。

📄 ライセンス

なし。