mcp-adder-simple 1.0.5 → 1.0.7

package/mcp-adder.js

@@ -1,129 +1,191 @@
+/**
+ * MCP Adder Server
+ * 一个简单的 MCP (Model Context Protocol) 服务器，提供数字相加功能
+ */
+
 const readline = require('readline');
 
-// 创建 readline 接口
+// ========== 配置和初始化 ==========
+
+// 创建 readline 接口用于处理 stdin/stdout 通信
 const rl = readline.createInterface({
   input: process.stdin,
   output: process.stdout,
-  terminal: false
+  terminal: false  // 非终端模式，避免额外的输出格式化
 });
 
-// 强制启用 stdin，避免延迟
+// 设置 stdin 编码为 UTF-8
 process.stdin.setEncoding('utf8');
-process.stdin.resume(); // 关键！防止 Node.js 缓冲输入
 
-console.error('[MCP] ✅ 服务启动，等待 initialize...');
+// 立即恢复 stdin 流，防止缓冲输入延迟
+process.stdin.resume();
+
+// ========== 主逻辑 ==========
 
+// 监听输入行事件，处理 MCP 请求
 rl.on('line', (line) => {
-  console.error('[MCP] 📥 收到数据:', line);
   try {
+    // 跳过空行
     const trimmed = line.trim();
-    if (!trimmed) return; // 跳过空行
+    if (!trimmed) return;
+
+    // 解析 JSON-RPC 请求
     const msg = JSON.parse(trimmed);
-    console.error('[MCP] ✅ 解析成功:', msg.method);
-
-    if (msg.id === undefined || msg.id === null) return;
-
-    let result = null;
-    let error = null;
-
-    try {
-      switch (msg.method) {
-        case 'tools/list':
-          result = {
-            tools: [
-              {
-                name: 'add_numbers',
-                description: '将两个数字相加',
-                inputSchema: {
-                  type: 'object',
-                  properties: {
-                    a: { type: 'number', description: '第一个数' },
-                    b: { type: 'number', description: '第二个数' }
-                  },
-                  required: ['a', 'b']
-                }
-              }
-            ]
-          };
-          console.error('[MCP] ← tools/list 成功响应');
-          break;
-
-        case 'initialize':
-          result = {
-            protocolVersion: '2024-10-07',
-            serverInfo: {
-              name: 'mcp-adder-server',
-              version: '1.0.0'
+
+    // 打印完整的请求消息（用于调试）
+    console.error('[MCP] 收到请求:', JSON.stringify(msg, null, 2));
+
+    // 检查请求是否包含 id（id 可以为 0，不能只检查 !msg.id）
+    if (msg.id === undefined || msg.id === null) {
+      return;
+    }
+
+    // 处理请求
+    handleRequest(msg);
+
+  } catch (e) {
+    // JSON 解析失败，记录错误但不中断服务
+    console.error(`[MCP] JSON 解析失败: ${line}`);
+  }
+});
+
+/**
+ * 处理 MCP 请求
+ * @param {Object} msg - JSON-RPC 请求对象
+ */
+function handleRequest(msg) {
+  let result = null;
+  let error = null;
+
+  try {
+    // 根据方法名分发处理
+    switch (msg.method) {
+      case 'initialize':
+        result = handleInitialize();
+        break;
+
+      case 'tools/list':
+        result = handleToolsList();
+        break;
+
+      case 'tools/call':
+        result = handleToolCall(msg.params);
+        break;
+
+      default:
+        throw new Error(`不支持的方法: ${msg.method}`);
+    }
+  } catch (err) {
+    // 处理过程中的错误
+    error = {
+      code: -32602,
+      message: err.message
+    };
+  }
+
+  // 构建并发送响应
+  const response = {
+    jsonrpc: '2.0',
+    id: msg.id
+  };
+
+  if (error) {
+    response.error = error;
+  } else {
+    response.result = result;
+  }
+
+  // 输出响应到 stdout（MCP 客户端读取）
+  console.log(JSON.stringify(response));
+}
+
+/**
+ * 处理 initialize 请求
+ * @returns {Object} 初始化响应
+ */
+function handleInitialize() {
+  return {
+    protocolVersion: '2024-10-07',
+    serverInfo: {
+      name: 'mcp-adder-server',
+      version: '1.0.0'
+    },
+    capabilities: {
+      tools: {}  // 声明支持 tools 功能
+    }
+  };
+}
+
+/**
+ * 处理工具列表请求
+ * @returns {Object} 工具列表响应
+ */
+function handleToolsList() {
+  return {
+    tools: [
+      {
+        name: 'add_numbers',
+        description: '将两个数字相加',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            a: {
+              type: 'number',
+              description: '第一个数'
             },
-            capabilities: {
-              tools: {}
+            b: {
+              type: 'number',
+              description: '第二个数'
             }
-          };
-          console.error('[MCP] ← initialize 成功响应');
-          break;
-
-        case 'list_tools':
-          result = {
-            tools: [
-              {
-                name: 'add_numbers',
-                description: '将两个数字相加',
-                inputSchema: {
-                  type: 'object',
-                  properties: {
-                    a: { type: 'number', description: '第一个数' },
-                    b: { type: 'number', description: '第二个数' }
-                  },
-                  required: ['a', 'b']
-                }
-              }
-            ]
-          };
-          console.error('[MCP] ← list_tools 成功响应');
-          break;
-
-        case 'call_tool':
-          const { name, arguments: args } = msg.params;
-          if (name === 'add_numbers') {
-            const { a, b } = args;
-            if (typeof a !== 'number' || typeof b !== 'number') {
-              throw new Error('参数必须是数字');
-            }
-            result = {
-              content: [{ type: 'text', text: `${a} + ${b} = ${a + b}` }]
-            };
-          } else {
-            throw new Error(`未知工具: ${name}`);
-          }
-          break;
-
-        default:
-          throw new Error(`不支持的方法: ${msg.method}`);
+          },
+          required: ['a', 'b']
+        }
       }
-    } catch (err) {
-      error = { code: -32602, message: err.message };
-      console.error('[MCP] ❌ 错误:', err.message);
-    }
+    ]
+  };
+}
+
+/**
+ * 处理工具调用请求
+ * @param {Object} params - 请求参数
+ * @param {string} params.name - 工具名称
+ * @param {Object} params.arguments - 工具参数
+ * @returns {Object} 工具执行结果
+ */
+function handleToolCall(params) {
+  const { name, arguments: args } = params;
+
+  if (name === 'add_numbers') {
+    const { a, b } = args;
 
-    const response = { jsonrpc: '2.0', id: msg.id };
-    if (error) {
-      response.error = error;
-    } else {
-      response.result = result;
+    // 参数类型验证
+    if (typeof a !== 'number' || typeof b !== 'number') {
+      throw new Error('参数必须是数字');
     }
 
-    console.log(JSON.stringify(response));
-  } catch (e) {
-    console.error('[MCP] ❌ JSON 解析失败:', line);
+    // 计算并返回结果
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `${a} + ${b} = ${a + b}`
+        }
+      ]
+    };
+
+  } else {
+    throw new Error(`未知工具: ${name}`);
   }
-});
+}
+
+// ========== 清理和退出 ==========
 
+// 当连接关闭时退出进程
 rl.on('close', () => {
-  console.error('[MCP] 连接关闭，退出服务');
   process.exit(0);
 });
 
-// ⚠️ 关键：防止 Node.js 阻塞
+// 当 stdin 结束时退出进程（防止 Node.js 阻塞）
 process.stdin.on('end', () => {
   process.exit(0);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-adder-simple",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "main": "mcp-adder.js",
   "bin": {
     "mcp-adder-simple": "./bin/mcp-adder-simple.cmd"