MCP Ts Simple Template

🚀 MCP TypeScript 簡単テンプレート

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーを構築するためのシンプルなTypeScriptテンプレートです。AIシステムと統合できるカスタムMCPツールを作成するための基礎を提供します。

🚀 クイックスタート

このテンプレートでは、基本的なMCPサーバーを実装し、サンプルのBMI計算ツールも用意されています。以下のことができるようになります。

• TypeScriptを使用してMCPサーバーを設定する方法
• Zodを使用してMCPツールとその入力検証を定義および実装する方法
• サーバーを標準入出力に接続して通信する方法

✨ 主な機能

• 基本的なMCPサーバーの実装
• サンプルのBMI計算ツール付き
• TypeScriptとZodを使用したMCPツールの作成と入力検証

📦 インストール

前提条件

• Node.js（推奨バージョン20以上）
• 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",
  {
    // Zodを使用して入力スキーマを定義
    paramName: z.string(),
    // 必要に応じて追加のパラメーターを追加
  },
  async ({ paramName }) => ({
    content: [{
      type: "text",
      text: "あなたのツールの応答"
    }]
  })
);

依存関係

• @modelcontextprotocol/sdk - コアMCP SDK
• zod - スキーマ検証
• dotenv - 環境変数管理
• typescript - TypeScriptコンパイラ

📄 ライセンス

ISC

貢献

貢献を歓迎します！自由にプルリクエストを送信してください。