MCP TypeScript Simple Template

MCP TypeScript Simple Template

Model Context Protocol（MCP）サーバーを構築するためのシンプルな TypeScript テンプレートです。このプロジェクトは、AI システムと連携できるカスタム MCP ツールを作成するための基盤を提供します。

概要

このテンプレートでは、BMI 計算ツールのサンプルを備えた基本的な MCP サーバーを実装しています。次の方法を説明します。

• TypeScript で MCP サーバーをセットアップする
• Zod を使用した入力検証を含め、MCP ツールを定義して実装する
• 通信のためにサーバーを標準入出力に接続する

前提条件

• Node.js（v20 以上を推奨）
• npm または yarn

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします。

npm install

プロジェクト構成

• index.ts - サンプルツールを含むメインのサーバー実装
• package.json - プロジェクトの依存関係とスクリプト
• tsconfig.json - TypeScript の設定

使い方

ビルドと実行

サーバーをビルドして起動します。

npm start

これにより TypeScript コードがコンパイルされ、MCP サーバーが起動します。

開発

開発時には、次の操作を行えます。

1. index.ts を変更して独自のツールを追加します
2. ビルドコマンドを実行してコンパイルします。

npm run build

カスタムツールの作成

新しいツールを作成するには、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 のコア SDK
• zod - スキーマ検証
• dotenv - 環境変数の管理
• typescript - TypeScript コンパイラー

ライセンス

ISC

コントリビューション

コントリビューションを歓迎します。お気軽にプルリクエストを送信してください。