@leju-gym/gym-mcp 0.0.1

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@leju-gym/gym-mcp",
+  "version": "0.0.1",
+  "description": "Gym MCP Server — 通过 MCP 协议调用 gym CLI，AI 助手可直接查询 KuavoDataHub 项目列表等数据",
+  "bin": {
+    "gym-mcp": "src/mcp.js"
+  },
+  "files": [
+    "src/"
+  ],
+  "scripts": {
+    "mcp": "node src/mcp.js"
+  },
+  "keywords": [
+    "mcp",
+    "gym",
+    "kuavo",
+    "robotics",
+    "data-management"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.lejurobot.com/kuavo/kuavodatahubai.git",
+    "directory": "projects/gym-mcp"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "log4js": "^6.9.1"
+  }
+}

package/src/AppHelper.js

@@ -0,0 +1,32 @@
+/**
+ * @ModuleName:   AppHelper
+ * @ModuleDesc:   日志组件（log4js + console 兜底）
+ */
+
+const path = require("path");
+const log4js = require("log4js");
+
+class AppHelper {
+  _log;
+
+  constructor() {
+    try {
+      log4js.configure(path.join(__dirname, "log4js.json"));
+      this._log = log4js.getLogger();
+    } catch (e) {
+      this._log = {
+        error: (...args) => console.error(...args),
+        warn: (...args) => console.warn(...args),
+        info: (...args) => console.log(...args),
+        debug: (...args) => console.debug(...args),
+      };
+    }
+  }
+
+  error(...data) { this._log?.error(...data); }
+  warn(...data)  { this._log?.warn(...data); }
+  info(...data)  { this._log?.info(...data); }
+  debug(...data) { this._log?.debug(...data); }
+}
+
+module.exports = new AppHelper();

package/src/log4js.json

@@ -0,0 +1,19 @@
+{
+  "appenders": {
+    "console": { "type": "console" },
+    "file": {
+      "type": "dateFile",
+      "filename": "logs/gym-mcp.log",
+      "pattern": "yyyy-MM-dd",
+      "keepFileExt": true,
+      "numBackups": 30,
+      "compress": true
+    }
+  },
+  "categories": {
+    "default": {
+      "appenders": ["console", "file"],
+      "level": "debug"
+    }
+  }
+}

package/src/mcp.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * @ModuleName:   mcp
+ * @ModuleMethod: src
+ * @ModuleUsage:  MCP 协议入口（stdio 传输）
+ * @ModuleDesc:   通过标准输入输出与 MCP 客户端通信，
+ *                注册 ToolService 中的所有工具
+ */
+
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} = require("@modelcontextprotocol/sdk/types.js");
+const toolService = require("./services/mcp/ToolService");
+const appHelper = require("./AppHelper");
+
+const VERSION = "0.0.1";
+
+async function main() {
+  const server = new Server({ name: "gym-mcp", version: VERSION }, { capabilities: { tools: {} } });
+
+  // tools/list
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: toolService.listTools() };
+  });
+
+  // tools/call
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    appHelper.info("mcp call", name, JSON.stringify(args));
+    const result = await toolService.callTool(name, args || {});
+    return {
+      content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  appHelper.info("gym-mcp MCP server started");
+}
+
+main().catch((e) => {
+  console.error("MCP server fatal:", e);
+  process.exit(1);
+});

package/src/services/mcp/ToolService.js

@@ -0,0 +1,116 @@
+/**
+ * @ModuleName:   ToolService
+ * @ModuleMethod: src/services/mcp
+ * @ModuleUsage:  MCP 工具注册与调用服务
+ * @ModuleDesc:   通过 spawn gym CLI 二进制 + --json 模式调用本地 gym 工具，
+ *                逻辑零重复，认证完全复用 gym config login
+ */
+
+const appHelper = require('../../AppHelper');
+const { execFile } = require('child_process');
+const { promisify } = require('util');
+const execFileAsync = promisify(execFile);
+
+// ─── Gym CLI 调用 ─────────────────────────────────────────────
+
+function gymBin() {
+  return process.env.GYM_BIN || 'gym';
+}
+
+async function runGym(args = []) {
+  const bin = gymBin();
+  appHelper.info('runGym', bin, args.join(' '));
+  try {
+    const { stdout, stderr } = await execFileAsync(bin, args, {
+      timeout: 30_000,
+      maxBuffer: 1024 * 1024,
+    });
+    if (stderr) appHelper.warn('runGym stderr', stderr);
+    return JSON.parse(stdout);
+  } catch (e) {
+    if (e.code === 'ENOENT') {
+      return { error: 'gym CLI 未安装或不在 PATH 中' };
+    }
+    // gym --json 模式下错误也走 stdout JSON
+    try { return JSON.parse(e.stdout || ''); } catch {}
+    return { error: e.stderr || e.message };
+  }
+}
+
+// ─── 工具定义 ──────────────────────────────────────────────────
+
+const toolDefinitions = [
+  {
+    name: 'echo',
+    description: '回显输入内容，用于测试连通性',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        message: { type: 'string', description: '要回显的消息' },
+      },
+      required: ['message'],
+    },
+  },
+  {
+    name: 'gym_project_list',
+    description:
+      '查询组织及其下属项目列表（调用本地 gym CLI，复用已登录的认证状态）。返回每个组织下的所有项目 ID、名称、编码。',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        page:  { type: 'number', description: '页码，默认 1' },
+        limit: { type: 'number', description: '每页数量，默认 10' },
+      },
+    },
+  },
+];
+
+// ─── ToolService ────────────────────────────────────────────────
+
+class ToolService {
+  listTools() {
+    return toolDefinitions.map(t => ({
+      name: t.name,
+      description: t.description,
+      inputSchema: t.inputSchema,
+    }));
+  }
+
+  async callTool(toolName, args) {
+    const tool = toolDefinitions.find(t => t.name === toolName);
+    if (!tool) {
+      return { ok: false, message: `Unknown tool: ${toolName}` };
+    }
+
+    try {
+      appHelper.info('callTool', toolName, JSON.stringify(args));
+
+      switch (toolName) {
+        case 'echo':
+          return { ok: true, data: { echo: args.message || '' } };
+
+        case 'gym_project_list': {
+          const page  = args.page  || 1;
+          const limit = args.limit || 10;
+          const result = await runGym([
+            'project', 'list',
+            '--page',  String(page),
+            '--limit', String(limit),
+            '--json',
+          ]);
+          return result.error
+            ? { ok: false, message: result.error }
+            : { ok: true,  data: result };
+        }
+
+        default:
+          return { ok: false, message: `Tool not implemented: ${toolName}` };
+      }
+    } catch (e) {
+      appHelper.error('callTool', toolName, e);
+      return { ok: false, message: e.message };
+    }
+  }
+}
+
+module.exports = new ToolService();