tom-echo-mcp 1.0.0

package/README.md

@@ -0,0 +1,118 @@
+# Tom Echo MCP 服务器
+
+一个支持多线程的 MCP (Model Context Protocol) Echo 服务器，用于演示基本的 MCP 工具功能和多线程处理。
+
+## 功能特性
+
+- 提供一个 `echo` 工具，返回接收到的任何消息
+- 支持多线程处理，使用 worker pool 提高并发性能
+- 可配置工作线程数量
+- 基于 TypeScript 开发
+
+## 安装
+
+```bash
+npm install
+```
+
+## 构建
+
+```bash
+npm run build
+```
+
+## 使用方法
+
+### 直接运行
+
+使用默认配置（4个工作线程）：
+
+```bash
+npm start
+```
+
+### 配置线程数量
+
+通过环境变量 `WORKER_THREADS` 配置工作线程数量：
+
+```bash
+WORKER_THREADS=8 npm start
+```
+
+### 在 MCP 客户端中配置
+
+在你的 MCP 客户端配置文件中添加：
+
+```json
+{
+  "mcpServers": {
+    "tom-echo": {
+      "command": "node",
+      "args": ["/Users/tom/Desktop/tom_echo/dist/index.js"],
+      "env": {
+        "WORKER_THREADS": "8"
+      }
+    }
+  }
+}
+```
+
+或者使用 npm 运行：
+
+```json
+{
+  "mcpServers": {
+    "tom-echo": {
+      "command": "npm",
+      "args": ["start"],
+      "cwd": "/Users/tom/Desktop/tom_echo",
+      "env": {
+        "WORKER_THREADS": "8"
+      }
+    }
+  }
+}
+```
+
+## API
+
+### echo 工具
+
+回显输入的消息内容。
+
+**参数：**
+- `message` (string, 必需): 要回显的消息内容
+
+**返回：**
+- 返回与输入相同的消息内容
+
+**示例：**
+```json
+{
+  "name": "echo",
+  "arguments": {
+    "message": "Hello, World!"
+  }
+}
+```
+
+返回：`Hello, World!`
+
+## 技术栈
+
+- **@modelcontextprotocol/sdk**: MCP 协议实现
+- **workerpool**: Node.js 工作线程池管理
+- **TypeScript**: 类型安全的开发体验
+
+## 架构说明
+
+本项目使用 `workerpool` 库实现多线程支持：
+
+1. 主线程运行 MCP 服务器，处理请求和响应
+2. Worker 线程池处理实际的 echo 操作
+3. 请求会自动分配到空闲的 worker 线程
+4. 支持动态配置线程数量，适应不同的负载需求
+
+## 许可证
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import * as workerpool from 'workerpool';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// 从环境变量读取线程数配置，默认为 4
+const WORKER_THREADS = parseInt(process.env.WORKER_THREADS || '4', 10);
+// 创建 worker pool
+const pool = workerpool.pool(join(__dirname, 'worker.js'), {
+    maxWorkers: WORKER_THREADS,
+    minWorkers: Math.min(2, WORKER_THREADS)
+});
+console.error(`Echo MCP 服务器启动，使用 ${WORKER_THREADS} 个工作线程`);
+const server = new Server({
+    name: "tom-echo-mcp",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// 列出可用的工具
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: "echo",
+                description: "回显输入的消息。支持多线程处理，传入什么消息就返回什么消息。",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        message: {
+                            type: "string",
+                            description: "要回显的消息内容",
+                        },
+                    },
+                    required: ["message"],
+                },
+            },
+        ],
+    };
+});
+// 处理工具调用
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (request.params.name === "echo") {
+        const message = request.params.arguments?.message;
+        if (typeof message !== "string") {
+            throw new Error("参数 'message' 必须是字符串类型");
+        }
+        try {
+            // 使用 worker pool 执行 echo 操作
+            const result = await pool.exec('echo', [message]);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: result,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(`Echo 执行失败: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    else {
+        throw new Error(`未知的工具: ${request.params.name}`);
+    }
+});
+// 启动服务器
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Echo MCP 服务器已连接并运行中...");
+}
+// 优雅关闭
+process.on('SIGINT', async () => {
+    console.error('\n正在关闭 worker pool...');
+    await pool.terminate();
+    process.exit(0);
+});
+process.on('SIGTERM', async () => {
+    console.error('\n正在关闭 worker pool...');
+    await pool.terminate();
+    process.exit(0);
+});
+main().catch((error) => {
+    console.error("服务器启动失败:", error);
+    process.exit(1);
+});

package/dist/worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/worker.js

@@ -0,0 +1,11 @@
+import * as workerpool from 'workerpool';
+/**
+ * Echo 函数：返回接收到的消息
+ */
+function echo(message) {
+    return message;
+}
+// 创建 worker 并注册函数
+workerpool.worker({
+    echo: echo
+});

package/mcp-config-example.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "tom-echo": {
+      "command": "node",
+      "args": [
+        "/Users/tom/Desktop/tom_echo/dist/index.js"
+      ],
+      "env": {
+        "WORKER_THREADS": "4"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "tom-echo-mcp",
+  "version": "1.0.0",
+  "description": "一个支持多线程的 MCP Echo 服务器",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "tom-echo-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "echo",
+    "worker-threads"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "workerpool": "^9.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import * as workerpool from 'workerpool';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 从环境变量读取线程数配置，默认为 4
+const WORKER_THREADS = parseInt(process.env.WORKER_THREADS || '4', 10);
+
+// 创建 worker pool
+const pool = workerpool.pool(join(__dirname, 'worker.js'), {
+  maxWorkers: WORKER_THREADS,
+  minWorkers: Math.min(2, WORKER_THREADS)
+});
+
+console.error(`Echo MCP 服务器启动，使用 ${WORKER_THREADS} 个工作线程`);
+
+const server = new Server(
+  {
+    name: "tom-echo-mcp",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// 列出可用的工具
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "echo",
+        description: "回显输入的消息。支持多线程处理，传入什么消息就返回什么消息。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            message: {
+              type: "string",
+              description: "要回显的消息内容",
+            },
+          },
+          required: ["message"],
+        },
+      },
+    ],
+  };
+});
+
+// 处理工具调用
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  if (request.params.name === "echo") {
+    const message = request.params.arguments?.message;
+    
+    if (typeof message !== "string") {
+      throw new Error("参数 'message' 必须是字符串类型");
+    }
+
+    try {
+      // 使用 worker pool 执行 echo 操作
+      const result = await pool.exec('echo', [message]) as string;
+      
+      return {
+        content: [
+          {
+            type: "text",
+            text: result,
+          },
+        ],
+      };
+    } catch (error) {
+      throw new Error(`Echo 执行失败: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  } else {
+    throw new Error(`未知的工具: ${request.params.name}`);
+  }
+});
+
+// 启动服务器
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  
+  console.error("Echo MCP 服务器已连接并运行中...");
+}
+
+// 优雅关闭
+process.on('SIGINT', async () => {
+  console.error('\n正在关闭 worker pool...');
+  await pool.terminate();
+  process.exit(0);
+});
+
+process.on('SIGTERM', async () => {
+  console.error('\n正在关闭 worker pool...');
+  await pool.terminate();
+  process.exit(0);
+});
+
+main().catch((error) => {
+  console.error("服务器启动失败:", error);
+  process.exit(1);
+});

package/src/worker.ts

@@ -0,0 +1,13 @@
+import * as workerpool from 'workerpool';
+
+/**
+ * Echo 函数：返回接收到的消息
+ */
+function echo(message: string): string {
+  return message;
+}
+
+// 创建 worker 并注册函数
+workerpool.worker({
+  echo: echo
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "node",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}