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。

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