Nestjs MCP Server Langchainjs Demo

🚀 NestJS MCP サーバー - モデルコンテキストプロトコルの使用例

このリポジトリは、NestJS で実装されたモデルコンテキストプロトコル（MCP）とマイクロサービスアーキテクチャをデモンストレーションしています。主に2つのサービスが含まれています。

• mcp-server：大規模言語モデル（LLMs）が使用する現在の時間コンテキストを取得する機能を提供します。
• mcp-backend：LangChain.js を使用し、MCP クライアント SDK を統合して MCP サーバーに接続するクライアントです。

作者：@LiusDev

🚀 クイックスタート

前提条件

• Node.js (v20 以上)
• npm

📦 インストール

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

npm install

3. .env.example を .env にコピーし、OpenAI API キーを追加します。

cp .env.example .env

その後、.env ファイルを編集して OpenAI API キーを含めます。

OPENAI_API_KEY=your_openai_api_key_here
OPENAI_API_URL=https://api.openai.com/v1
PORT=3001

サービスの起動

完全な機能を実現するには、2つのサービスを同時に起動する必要があります。

MCP サーバーの起動

npm run start:dev mcp-server

これにより、MCP サーバーがポート 3000（デフォルト）で起動します。

MCP バックエンドの起動

npm run start:dev mcp-backend

これにより、MCP バックエンドがポート 3001（デフォルト）で起動します。

💻 使用例

2つのサービスが起動したら、POST リクエストを送信して機能をテストできます。

サンプルリクエスト

http://localhost:3001 に POST リクエストを送信し、以下の JSON 本文を含めます。

{
  "message": "What time is it in Viet Nam?"
}

curl を使用する場合

curl -X POST http://localhost:3001 -H "Content-Type: application/json" -d '{"message":"What time is it in Viet Nam?"}'

Postman を使用する場合

1. Postman を開き、新しいリクエストを作成します。
2. URL を http://localhost:3001 に設定します。
3. POST メソッドを選択します。
4. リクエストヘッダーに Content-Type: application/json を追加します。
5. リクエストボディに以下の JSON を入力します。

{
  "message": "What time is it in Viet Nam?"
}

6. リクエストを送信し、レスポンスを確認します。

複数の MCP サーバーへの接続

mcp-backend で複数の MCP サーバーに接続するには、src/main.ts ファイルで以下の設定を行います。

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);

  // 他の MCP サーバーのホストとポートを追加
  const otherMcpServers = ['http://localhost:3002', 'http://localhost:3003'];
  
  // MCP サービスプロバイダーを登録（オプション）
  // app.registerMcpProvider(otherMcpServers);

  await app.listen(3001);
}

🔧 技術詳細

アーキテクチャ

• mcp-server：時間関連のリクエストを処理し、応答を返します。
• mcp-backend：MCP サーバーにリクエストを送信し、レスポンスを受け取るクライアントです。

使用技術

• NestJS：マイクロサービスアーキテクチャの構築に使用されます。
• LangChain.js：大規模言語モデルとのやり取りに使用されます。
• Axios：HTTP リクエストの処理に使用されます。

📄 ライセンス

このプロジェクトは UNLICENSED ライセンスに基づいて配布されています。詳細については、LICENSE ファイルを参照してください。