MCP Serverless

🚀 MCP 無服務器架構

MCP 無服務器架構是一個實現模型上下文協議 (MCP) 架構的無服務器解決方案，它提供了簡潔的接口用於管理工具，能有效提升工具管理的便捷性和效率。

🚀 快速開始

MCP 無服務器架構提供了 MCP 服務器的無服務器實現，藉助它你能夠：

• 註冊和管理工具
• 處理與工具相關的請求
• 創建內存中的客戶端 - 服務器連接
• 擴展請求以啟用上下文傳輸，從而允許客戶端傳輸憑據

📦 安裝指南

使用以下命令安裝 @tilfin/mcp-serverless 包：

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' }
});

📚 詳細文檔

API 參考

ToolManager 類

該類用於管理工具的註冊和處理。

Tool 接口

工具必須實現以下接口：

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

createServer(serverInfo, toolManager)

使用給定的工具管理器創建一個 MCP 服務器。

createService(toolManager)

創建一個服務實例。