MCP Serverless

🚀 MCP 無サーバーアーキテクチャ

このプロジェクトは、モデルコンテキストプロトコル (MCP) アーキテクチャを実装した無サーバーソリューションです。ツールを管理するためのシンプルなインターフェースを提供します。

🚀 クイックスタート

このパッケージは、MCP サーバーの無サーバー実装を提供し、以下のことができます。

• ツールの登録と管理
• ツール関連のリクエストの処理
• メモリ内のクライアント - サーバー接続の作成
• コンテキスト転送を有効にするためのリクエストの拡張。これにより、クライアントが認証情報を転送できます。

📦 インストール

npm install @tilfin/mcp-serverless

💻 使用例

基本的な使用法

import { createService, ToolManager } from '@tilfin/mcp-serverless';

// ツールマネージャーを作成
const toolManager = new ToolManager();

// ツールを登録
toolManager.registerTools([
  {
    name: 'calculator',
    description: '基本的な算術演算を実行',
    inputSchema: {
      type: 'object',
      properties: {
        operation: { type: 'string' },
        numbers: { type: 'array', items: { type: 'number' } }
      },
      required: ['operation', 'numbers']
    },
    toolFunction: async (params, ctx) => {
      if (ctx.apiKey !== 'xyz') throw new Error('無効な API キー');

      let result;
      if (params.operation === 'add') {
        result = params.numbers.reduce((sum, n) => sum + n, 0);
      }
      return { result };
    }
  }
]);

// 無サーバークライアントを作成
const client = createService(toolManager);

// 利用可能なツールをリストする
const toolsList = await client.listTools();

// ツールを呼び出す
try {
  const result = await client.callTool({
    name: 'calculator',
    arguments: {
      operation: 'add',
      numbers: [1, 2, 3]
    }
  });
} catch (err) {
  // 無効な API キーエラーをスロー
}

// コンテキストを使用してツールを呼び出す
const result = await client.callTool({
  name: 'calculator',
  arguments: {
    operation: 'add',
    numbers: [1, 2, 3]
  },
  ctx: { apiKey: 'xyz' }
});

📚 ドキュメント

ToolManager クラス

ツールの登録と処理を管理します。

Tool インターフェース

ツールは以下のインターフェースを実装する必要があります。

interface Tool {
  name: string;
  description: string;
  inputSchema: ToolInput;
  toolFunction: (args: CallToolRequestArguments, ctx: CallToolRequestContext) => Promise<CallToolResultContent>;
}

createServer(serverInfo, toolManager)

指定されたツールマネージャーを使用して、MCP サーバーを作成します。

createService(toolManager)