Demo Ts MCP Client Server

🚀 MCP 基礎デモ

このプロジェクトは、モデルコンテキストプロトコル (MCP) を使用した基本的なクライアント - サーバー間のやり取りをデモンストレーションしています。MCP は、AI モデル（Google Gemini/Vertex AI などの AI SDK を介してアクセスできるモデル）が、個別のサーバープロセスによって提供される外部ツールやリソースを安全に検出し、利用することを可能にします。

このサンプルでは以下のようになっています：

• サーバー (src/server/) は、MCP プロバイダーとして機能し、簡単な計算ツール（足し算、引き算など）を提供します。
• クライアント (src/client/) は、AI SDK を使用して Google AI モデルとやり取りし、MCP サーバーに接続します。これにより、AI は生成過程でサーバーのツールを使用することができます。

この設定では、AI モデルが MCP サーバー上にホストされたカスタム機能にアクセスすることで、その能力を拡張する方法を示しています。

🚀 クイックスタート

前提条件

• Node.js（バージョン >=23.0.0、package.json で指定）
• npm（Node.js と一緒に提供されます）
• Google AI (Gemini) API Key。Google AI Studio から取得できます。（Gemini モデルを使用する場合に必要）

セットアップ

1. リポジトリをクローンする：

   git clone git@github.com:bertrandgressier/demo-ts-mcp-client-server.git
   cd demo-mcp-basic
   

2. 依存関係をインストールする：

   npm install
   

3. 環境ファイルを作成する： サンプル環境ファイル .env.example を新しいファイル .env としてコピーします：

   cp .env.example .env
   

   次に、.env ファイルを編集して、実際の API キーと設定を追加します。必要なオプション変数は以下の通りです：

   # 必須：Google Studio モデル（Gemini）用
   GOOGLE_API_KEY=YOUR_GOOGLE_API_KEY
   
   # 必須：Google Vertex AI モデル用
   VERTEX_PROJECT_ID=YOUR_VERTEX_PROJECT_ID
   
   # オプション：設定されていない場合は 'us-central1' がデフォルト
   # VERTEX_LOCATION=your-vertex-location
   
   # オプション：Vertex AI サービスアカウントキーファイルのパス。設定されていない場合は、ルートディレクトリの 'vertex-key.json' がデフォルト
   # VERTEX_KEY_FILE=path/to/your/vertex-key.json
   

   YOUR_GOOGLE_API_KEY と YOUR_VERTEX_PROJECT_ID を自分の値に置き換えてください。

   ⚠️ 重要提示

   .env ファイルをバージョン管理システムにコミットしないでください。

利用可能なスクリプト

• npm run build：プロジェクトのソースコードを JavaScript にコンパイルします。
• npm start：コンパイル後のプロジェクトを実行します。
• npm run dev：開発モードで実行し、変更を自動的にリロードします。

プロジェクト構造

• src/：TypeScript のソースコードが含まれています。
  • client/：MCP クライアントアプリケーションのコード。
  • server/：MCP サーバーアプリケーションのコード。
  • model.ts：AI モデルの初期化と環境変数の読み込みを処理します。
• dist/：コンパイル後の JavaScript コード（npm run build を実行した後に生成されます）。
• .env：環境変数（API キーなど）を保存します - このファイルをコミットしないでください。
• package.json：プロジェクトのメタデータと依存関係。
• tsconfig.json：TypeScript コンパイラの設定。

説明

このデモでは、MCP プロトコルを使用して AI アプリケーションに外部ツールを統合する方法を示しています。サーバーは基本的な数学演算機能を提供し、クライアントは Google Gemini とのやり取りを通じてこれらのサービスを呼び出します。