Testmcpserver

🚀 测试MCP 服务器

本项目是一个使用Anthropic的Model Context Protocol（MCP）协议实现的测试服务器，提供了数学计算工具和完善的错误处理机制，以下是详细介绍。

🚀 快速开始

安装指南

1. 克隆仓库

   git clone <项目地址>
   cd mcp-server-test
   

2. 安装依赖

   npm install
   

3. 构建项目

   npm run build
   

启动服务器

node src/index.js

✨ 主要特性

• 数学计算工具：提供加法、乘法等基本运算功能。
• 错误处理：具备全面的错误捕捉和反馈机制。

📦 项目结构

• src/controllers/MathsController.ts：包含数学运算的处理逻辑。
• src/definitions/maths/addition.ts：加法工具的定义文件。

💻 使用示例

基础用法

工具定义

// `src/definitions/maths/addition.ts`
export const ADDITION = {
  name: "addition",
  description: "计算两个数字的和。",
  parameters: [
    { type: "number", name: "a", description: "第一个数字" },
    { type: "number", name: "b", description: "第二个数字" }
  ],
  example: "{ a: 2, b: 3 }"
};

控制器实现

// `src/controllers/MathsController.ts`
export class MathsController {
  async handleAddition(a: number, b: number) {
    try {
      const result = a + b;
      return {
        content: [
          { type: "text", text: `和为：${result}` }
        ],
        isError: false
      };
    } catch (error) {
      return {
        content: [
          { type: "text", text: `计算错误：${error instanceof Error ? error.message : String(error)}` }
        ],
        isError: true
      };
    }
  }
}

工具注册

// `src/utils/toolRegistry.ts`
export const controllerMap = {
  addition: {
    controller: MathsController,
    handlerMethod: "handleAddition"
  }
};

高级用法

服务器配置

// `src/index.ts`
const tools = getToolDefinitions();

const server = new Server({
  name: "mcp-server",
  version: "0.1.0"
}, {
  capabilities: {
    tools: getToolDefinitions()
  }
});

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: tools
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  try {
    const handler = getToolHandler(request.params.name);
    if (!handler) {
      return toolController.getUnknownToolResponse(request.params.name);
    }
    return await handler(request.params.arguments);
  } catch (error) {
    return toolController.getErrorResponse(error);
  }
});

📚 详细文档

集成到Cursor

1. 打开设置。
2. 进入功能选项。
3. 滚动至MCP服务器部分。
4. 点击添加新MCP服务器。
5. 输入服务器名称。
6. 选择类型为command。
7. 填写服务器地址，例如本地使用时为node <项目绝对路径>/build/index.js。

完成以上步骤后，服务器状态将显示为绿色，并列出所有已注册的工具。