MCP Nest

🚀 NestJS MCP モジュール使用ガイド

NestJS MCP モジュールは、NestJS アプリケーションに特化した Model Context Protocol (MCP) の実装です。このモジュールは、MCP 互換のクライアントとサービスの統合を簡素化し、ツール管理、コンテキストモデルの相互作用、サーバー側の機能宣言をサポートする一連の機能を提供します。

🚀 クイックスタート

NestJS MCP モジュールを使い始めるには、まずインストールが必要です。その後、基本的な設定を行い、モジュールをアプリケーションに統合することができます。

✨ 主な機能

ツール管理

MCP モジュールを通じて、複数のツールを簡単に登録および管理できます。

// 単一のツールを登録
this.mcp.registerTool('my-tool', {
  input: 'string',
  output: 'string',
  description: 'A simple echo tool'
});

// 複数のツールを一括登録
const tools = [
  { name: 'tool1', input: 'string', output: 'string' },
  { name: 'tool2', input: 'number', output: 'number' }
];
this.mcp.registerTools(tools);

コンテキスト管理

MCP モジュールは、複雑なコンテキストモデルの相互作用をサポートします。

// 新しいコンテキストを作成
const ctx = this.mcp.createContext('my-context-id');

// 既存のコンテキストを更新
ctx.update({ 
  inputs: { text: 'Hello MCP' },
  parameters: { temperature: 0.7 }
});

// コンテキストの状態を確認
this.mcp.getContextStatus(ctx.id());

サーバー側の機能宣言

サーバー側の機能を構成および管理します。

// 単一のモデルを登録
this.mcp.registerModel('gpt-3.5-turbo', {
  type: 'llm',
  capabilities: ['text-generation']
});

// 複数のモデルを一括登録
const models = [
  { name: 'gpt-4', type: 'llm', capabilities: ['text-generation'] },
  { name: 'image-generator', type: 'image', capabilities: ['image-generation'] }
];
this.mcp.registerModels(models);

📦 インストール

プロジェクトで @rekog/mcp-nest モジュールを使用するには、以下のコマンドを実行してインストールします。

npm install @rekog/mcp-nest

💻 使用例

基本的な使用法

NestJS アプリケーションのメインモジュールに MCP モジュールを導入します。

import { Module } from '@nestjs/common';
import { McpModule } from '@rekog/mcp-nest';

@Module({
  imports: [McpModule.forRoot()],
})
export class AppModule {}

高度な使用法

必要に応じて MCP の設定をカスタマイズします。

import { Module } from '@nestjs/common';
import { McpModule } from '@rekog/mcp-nest';

@Module({
  imports: [
    McpModule.forRoot({
      name: 'My MCP Server',
      version: '1.0.0',
      capabilities: {
        tools: ['my-tool'],
        models: ['gpt-3.5-turbo']
      },
      instructions: 'Please refer to the API documentation for usage details.',
      transport: [McpTransportType.SSE, McpTransportType.STREAMABLE_HTTP],
    }),
  ],
})
export class AppModule {}

🔧 技術詳細

セキュリティ機構

MCP モジュールには、データのやり取りの安全性を確保するためのいくつかのセキュリティ機能が組み込まれています。

• 認証と承認：OAuth、API キーなど、複数の認証メカニズムをサポートします。
• レート制限：乱用や DoS 攻撃を防止します。
• データ暗号化：転送中の機密データを暗号化します。

トランスポート層プロトコル

MCP モジュールは、さまざまなシナリオのニーズに対応するため、複数のトランスポート層プロトコルをサポートしています。

サーバー送信イベント (SSE)

SSE を使用してリアルタイムの双方向通信を実現します。

import { Server } from 'http';
import { McpModule, McpTransportType } from '@rekog/mcp-nest';

const server = new Server(3000);
server.on('connection', (stream) => {
  const mcp = new Mcp(stream, { transport: McpTransportType.SSE });
  // MCP リクエストを処理
});

ストリーミング可能な HTTP

ストリーミング可能な HTTP を使用して効率的なデータ転送を実現します。

import { McpModule, McpTransportType } from '@rekog/mcp-nest';

const mcp = new Mcp(httpStream, {
  transport: McpTransportType.STREAMABLE_HTTP,
});

設定の詳細

設定オプション

以下は MCP モジュールの主な設定パラメータです。

ハートビート機構

接続の活性を維持するために、ハートビート検出を設定できます。

const mcp = new Mcp(stream, {
  transport: McpTransportType.SSE,
  heartbeatInterval: 30000 // ハートビート間隔（ミリ秒）
});

その他のリソース

• GitHub リポジトリ: NestJS MCP モジュール
• 問題の報告: Issues 提出ページ

バッジ

npm バージョン	依存関係

NestJS MCP モジュールを使用することで、MCP プロトコルを NestJS アプリケーションに簡単に統合し、ツール管理、コンテキストモデルの相互作用、サーバー側の機能宣言などの機能を実現できます。詳細な情報については、完全なドキュメントまたはソースコードを参照してください。