MCP TypeScript シンプルテンプレート
モデルコンテキストプロトコル(MCP)サーバーを構築するためのシンプルなTypeScriptテンプレート。このプロジェクトは、AIシステムに統合できるカスタムMCPツールを作成するための基盤を提供します。
概要
このテンプレートは、サンプルのBMI計算ツールを備えた基本的なMCPサーバーを実装します。以下の操作方法を示します。
- TypeScriptでMCPサーバーをセットアップする
- Zodを使用した入力検証を備えたMCPツールの定義と実装
- 通信のためにサーバーを標準I/Oに接続する
前提条件
- Node.js (v20以上を推奨)
- npmまたはyarn
インストール
- このリポジトリをクローンする
- 依存関係をインストールします:
プロジェクト構造
index.ts
- サンプルツールを使用したメインサーバーの実装package.json
- プロジェクトの依存関係とスクリプトtsconfig.json
- TypeScript 設定
使用法
構築と実行
サーバーをビルドして起動します。
これにより、TypeScript コードがコンパイルされ、MCP サーバーが起動します。
発達
開発の場合、次のことが可能です。
index.ts
を修正して独自のツールを追加する- ビルド コマンドを実行してコンパイルします。
カスタムツールの作成
新しいツールを作成するには、 index.ts
の次のパターンに従います。
server.tool(
"your-tool-name",
{
// Define input schema using Zod
paramName: z.string(),
// Add more parameters as needed
},
async ({ paramName }) => ({
content: [{
type: "text",
text: "Your tool's response"
}]
})
);
依存関係
@modelcontextprotocol/sdk
- コア MCP SDKzod
- スキーマ検証dotenv
- 環境変数の管理typescript
- TypeScript コンパイラ
ライセンス
ISC
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。