DRX-1877/dev-tools-mcp

Dev Tools MCP Server

这是一个使用TypeScript编写的MCP（Model Context Protocol）服务器示例。

功能

这个MCP服务器提供了以下工具：

1. hello_world - 简单的问候工具

   • 参数：name (string) - 要问候的人名

2. calculate - 简单的计算器

   • 参数：
     • operation (string) - 运算类型：add, subtract, multiply, divide
     • a (number) - 第一个数字
     • b (number) - 第二个数字

3. file_info - 获取文件信息

   • 参数：path (string) - 文件路径

安装和运行

1. 安装依赖

npm install

2. 构建项目

npm run build

3. 运行服务器

npm start

开发模式运行

npm run dev

测试

项目包含一个测试文件 test-mcp.js，用于验证MCP服务器的功能：

node test-mcp.js

测试会验证：

• 服务器初始化
• 工具列表获取
• hello_world 工具调用
• calculate 工具的各种运算
• file_info 工具的文件信息获取

与AI模型集成

要将此MCP服务器与支持MCP的AI模型集成，你需要在AI模型的配置文件中添加此服务器。

示例配置（Claude Desktop）

在Claude Desktop的配置文件中添加：

{
  "mcpServers": {
    "dev-tools": {
      "command": "node",
      "args": ["/path/to/your/dev-tools/dist/server.js"],
      "env": {}
    }
  }
}

示例配置（Cursor）

在Cursor的MCP配置中添加：

{
  "mcpServers": {
    "dev-tools": {
      "command": "node",
      "args": ["/path/to/your/dev-tools/dist/server.js"]
    }
  }
}

开发

项目结构

dev-tools/
├── src/
│   └── server.ts          # MCP服务器主文件
├── dist/                  # 编译后的JavaScript文件
├── test-mcp.js           # 测试文件
├── package.json
├── tsconfig.json
└── README.md

添加新工具

1. 在 src/server.ts 中定义新的参数模式：

const NewToolArgsSchema = z.object({
  // 定义参数
});

2. 在 tools 数组中添加新工具：

{
  name: "new_tool",
  description: "工具描述",
  inputSchema: NewToolArgsSchema,
}

3. 在 CallToolRequest 处理函数中添加新的case：

case "new_tool": {
  const args = NewToolArgsSchema.parse(request.params.arguments);
  // 实现工具逻辑
  return {
    content: [
      {
        type: "text",
        text: "结果",
      },
    ],
  };
}

4. 在 test-mcp.js 中添加测试用例：

{
  jsonrpc: "2.0",
  id: 7,
  method: "tools/call",
  params: {
    name: "new_tool",
    arguments: {
      // 测试参数
    }
  }
}

许可证

ISC