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

API 参考

ToolManager 类

管理工具的注册和处理。

Tool 接口

工具必须实现以下接口：

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

createServer(serverInfo, toolManager)

使用给定的工具管理器创建一个 MCP 服务器。

createService(toolManager)