Template for MCP Server について
TypeScript 製 MCP サーバーを作る開発者向けのひな形です。文字列反転ツールやサンプルリソースに加え、stdio と SSE のトランスポートに対応しています。
主な機能
- 01文字列反転ツール
- 02stdio と SSE のトランスポート
- 03TypeScript のビルド工程
- 04挨拶とサーバー情報のリソース
活用シーン
- 01MCP サーバープロジェクトの作成
- 02文字列反転ツールのテスト
- 03MCP Inspector による通信確認
MCP 対応
このひな形は、文字列反転ツールと挨拶・サーバー情報のリソースをクライアントに公開する MCP サーバーを実装しています。stdio と SSE に対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
MCP サーバーのテンプレート
MCP サーバーを始めるためのテンプレートです。
自分用に複製してください
このテンプレートは、自分用に使っていただくことを目的としています。 このコマンドを実行すると、このテンプレートを複製した新しいフォルダーが作成されます (git は削除され、新しいものに置き換えられます)。
mcp-server をお好みの名前に置き換えてください:
npx make-mine https://github.com/bladnman/mcp-server-template.git <mcp-server>
機能
- シンプルな文字列反転ツール
- stdio と SSE の両方のトランスポートに対応
- ビルドプロセスを含む TypeScript の実装
ツール
reverse
文字列を入力として受け取り、反転した文字列を返します。
例:
- 入力:"hello world"
- 出力:"dlrow olleh"
リソース
greeting://hello:ようこそメッセージwelcome://info:サーバーとその機能に関する情報
はじめに
MCP Inspector でのテスト
サーバーとクライアント間でやり取りされるメッセージを確認できる汎用インスペクターツールを使って、サーバー自体をテストする方法があります。 シェルを開き、次のコマンドを実行します。
npx fastmcp inspect server.ts
次に、表示された URL(おそらく以下)にアクセスします。 http://localhost:5173
ここで実行している現在のサーバーでは、ルートディレクトリにある server.sh ファイルを stdio として、no arguments で実行します。
<full_path_to_server>/run-server.sh
前提条件
- Node.js(v14 以降)
- npm
インストール
# Install dependencies
npm install
サーバーの実行
# Build and run with stdio transport (default)
bash run-server.sh
# Or, to run with SSE transport
TRANSPORT_TYPE=sse npm run start
デフォルトでは、SSE サーバーはポート 4000 で実行されます。CONST.ts ファイルで変更してください。
開発
# Run in development mode with hot reloading
npm run dev
# Watch for changes and rebuild automatically
npm run watch
ビルド
# Build TypeScript to JavaScript
npm run build
ビルドされたファイルは dist ディレクトリに格納されます。
ライセンス
ISC ライセンス
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。