streamable-mcp-server について
streamable-mcp-server は、Streamable HTTP トランスポートを使った MCP サーバーを構築するための TypeScript 製スターターテンプレートです。セッション管理の例と依存関係、tsconfig が含まれており、独自の MCP サーバーを開発する開発者に向いています。
主な機能
- 01Streamable HTTP トランスポート対応の MCP サーバー
- 02TypeScript SDK 由来のセッション管理の例
- 03tsconfig を含む TypeScript ビルド環境
- 04変更を検知して再ビルド・再起動する開発モード
- 05PORT 環境変数によるポート指定
活用シーン
- 01新規の Streamable HTTP MCP サーバーの出発点
- 02ローカルで起動し、MCP クライアントからの接続を検証
MCP 対応
本プロジェクトは MCP サーバーのテンプレートで、http://localhost:3000 などのアドレスで streamable-http 形式の MCP クライアントにサービスを提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
streamable-mcp-server
これは、TypeScript で構築された新しい Streamable HTTP MCP サーバーの出発点です。
Streamable HTTP トランスポートは 2025-03-26 に導入されました。MCP 仕様の変更履歴を参照してください。
Model Context Protocol TypeScript SDK のセッション管理付き Streamable HTTP の例をベースに、すぐに始められるよう、適切な依存関係と tsconfig を含めています。
このリポジトリをクローンまたはフォークして、変更を加え、Streamable HTTP MCP サーバーの構築を始めましょう。
ローカルでインストールして実行する
依存関係をインストールするには、次を実行します。
npm install
次に、ビルドします。
npm run build
サーバーの実行
本番モード
サーバーを本番モードで実行するには、次を実行します。
npm start
# or directly with
node build/index.js
デフォルトではポート 3000 で実行されます。別のポートが必要な場合は、PORT 環境変数で指定できます。
PORT=3002 npm start
# or
PORT=3002 node build/index.js
開発モード
開発時には、ソースファイルの変更を自動的に監視し、再ビルドしてサーバーを再起動する開発モードを使用できます。
npm run dev
カスタムポートを指定する場合:
PORT=3002 npm run dev
クライアントの接続
Streamable HTTP MCP サーバーの起動後、クライアントを接続できます。クライアントの設定に従って構成してください。mcp-config.json に、次のような設定例があります。
{
"mcpServers": {
"streamable-mcp-server": {
"type": "streamable-http",
"url": "http://localhost:3000"
}
}
}
今後の拡張:
- OAuth 認証への対応
- ツールの例の追加
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。