MCP Framework

🚀 MCP フレームワークガイド

MCP フレームワークは、リアルタイム通信アプリケーションの開発を簡素化するための強力なツールです。このフレームワークは、SSE や HTTP ストリームなどの複数のトランスポートプロトコルをサポートし、認証、ログ記録、エラー処理などの豊富な機能モジュールを提供します。

🚀 クイックスタート

📦 依存関係のインストール

npm install mcp-framework

💻 基本的なサービスの作成

import { MCPServer } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      port: 3000,
      host: 'localhost'
    }
  }
});

server.start();

💻 サンプルの実行

node index.js

✨ 主な機能

MCP フレームワークは、ミドルウェア機構を通じてモジュール化された機能を実現しています。ユーザーは必要に応じて異なるミドルウェアを選択してサービスを拡張することができます。

📚 ドキュメント

SSE トランスポートの設定

SSE（Server-Sent Events）は、リアルタイム通信に使用されるプロトコルで、継続的なデータストリームが必要なアプリケーションシナリオに適しています。

基本的な設定

import { MCPServer } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      port: 3000,
      host: 'localhost'
    }
  }
});

server.start();

高度な設定

import { MCPServer, SSETransportOptions } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      port: 3000,
      host: 'localhost',
      path: '/events',
      maxReconnectionDelay: 5000
    }
  }
});

server.start();

HTTP ストリームトランスポートの設定

HTTP ストリームトランスポートは、大きなファイルのアップロードやダウンロードを処理する必要があるシナリオに適しています。

基本的な設定

import { MCPServer } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'http-stream',
    options: {
      port: 3000,
      host: 'localhost'
    }
  }
});

server.start();

高度な設定

import { MCPServer, HTTPStreamOptions } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'http-stream',
    options: {
      port: 3000,
      host: 'localhost',
      path: '/stream',
      responseMode: 'batch',
      batchTimeout: 30000
    }
  }
});

server.start();

認証

MCP フレームワークは、JWT や API Key などの複数の認証方式をサポートしています。

JWT 認証の設定

import { MCPServer, JWTAuthProvider } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      auth: {
        provider: new JWTAuthProvider({
          secret: process.env.JWT_SECRET,
          algorithms: ['HS256']
        }),
        endpoints: {
          sse: true
        }
      }
    }
  }
});

server.start();

API Key 認証の設定

import { MCPServer, APIKeyAuthProvider } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      auth: {
        provider: new APIKeyAuthProvider({
          secret: process.env.API_KEY_SECRET
        })
      }
    }
  }
});

server.start();

ログ記録

MCP フレームワークは、開発者がサービスのデバッグや監視を行うための組み込みログ記録機能を提供しています。

ログ記録の有効化

import { MCPServer, Logger } from 'mcp-framework';

const logger = new Logger({
  level: 'info',
  handlers: [
    {
      type: 'file',
      path: './logs/app.log'
    }
  ]
});

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      port: 3000,
      host: 'localhost'
    }
  },
  logger
});

server.start();

エラー処理

MCP フレームワークは、開発者が問題を迅速に特定して解決するための強力なエラー処理機構を提供しています。

カスタムエラーハンドラーの設定

import { MCPServer } from 'mcp-framework';

const server = new MCPServer({
  transport: {
    type: 'sae',
    options: {
      port: 3000,
      host: 'localhost'
    }
  },
  errorHandlers: [
    (error, context) => {
      console.error('Custom error handler:', error);
      context.reply(500, 'Internal Server Error');
    }
  ]
});

server.start();

まとめ

MCP フレームワークは、柔軟な設定と強力な機能モジュールを提供することで、リアルタイム通信アプリケーションの開発プロセスを簡素化します。SSE や HTTP ストリームトランスポートのいずれも、ユーザーは必要に応じて適切なソリューションを選択し、豊富なミドルウェアを通じてサービス機能を拡張することができます。