exomind 0.2.6 → 0.3.0

package/README.md

@@ -56,6 +56,22 @@ exomind install --with-hook
 
 即便不装 hook,skill 也会让 Agent 主动遵循飞轮规则。完整接入步骤见服务端仓库 `myExoMindManager/docs/new-machine-setup.md`。
 
+## 作为 MCP 工具接入(可选,更确定 + 跨宿主)
+
+`exomind mcp` 启动一个**本地 stdio MCP server**,把 ingest/query/search/entity/relations/stats 暴露为**typed tool**。Agent 直接调 tool(确定参数/返回),不必"读 skill → 拼 bash"。复用同一份凭证(`~/.exomind/config.json`),本地 stdio 所以三平台都能跑。
+
+**Claude Code**(`~/.claude.json` 或项目 `.mcp.json`):
+```json
+{ "mcpServers": { "exomind": { "command": "exomind", "args": ["mcp"] } } }
+```
+
+**OpenCode**(`opencode.json`):
+```json
+{ "mcp": { "exomind": { "type": "local", "command": ["exomind", "mcp"] } } }
+```
+
+> 与 skill+hook 并存,不冲突:MCP 提供"确定的工具调用",skill 提供"何时用的指导",hook 提供"每 prompt 的强制注入"。详见 [三层模式说明](./docs/mcp.md)。
+
 ## 命令一览
 
 | 命令 | 说明 |

package/dist/cli.js

@@ -3119,7 +3119,7 @@ var {
 // package.json
 var package_default = {
   name: "exomind",
-  version: "0.2.6",
+  version: "0.3.0",
   description: "ExoMind \u8DE8\u5E73\u53F0\u547D\u4EE4\u884C\u5BA2\u6237\u7AEF \u2014 \u901A\u8FC7 REST \u4E0E ExoMind \u77E5\u8BC6\u5E93\u4EA4\u4E92(ingest/query/search/review),\u66FF\u4EE3 Windows \u4E0D\u53EF\u7528\u7684 MCP \u5BA2\u6237\u7AEF\u3002",
   bin: {
     exomind: "dist/cli.js"
@@ -3624,6 +3624,160 @@ async function runHook(client) {
   }
 }
 
+// src/mcp.ts
+var readline = __toESM(require("readline"));
+var PROTOCOL_VERSION = "2024-11-05";
+var TOOLS = [
+  {
+    name: "ingest",
+    description: "\u5411 ExoMind \u77E5\u8BC6\u5E93\u5BFC\u5165\u77E5\u8BC6(\u6587\u672C),\u81EA\u52A8\u62BD\u53D6\u5B9E\u4F53/\u5173\u7CFB\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        content: { type: "string", description: "\u8981\u5BFC\u5165\u7684\u6587\u672C\u5185\u5BB9" },
+        title: { type: "string", description: "\u6807\u9898(\u53EF\u9009)" },
+        tags: { type: "array", items: { type: "string" }, description: "\u6807\u7B7E(\u53EF\u9009)" }
+      },
+      required: ["content"]
+    }
+  },
+  {
+    name: "query",
+    description: "LLM \u95EE\u7B54:\u57FA\u4E8E\u77E5\u8BC6\u5E93\u56DE\u7B54\u95EE\u9898\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        question: { type: "string", description: "\u95EE\u9898" },
+        tags: { type: "array", items: { type: "string" }, description: "\u6807\u7B7E\u8FC7\u6EE4(\u53EF\u9009)" }
+      },
+      required: ["question"]
+    }
+  },
+  {
+    name: "search",
+    description: "\u5168\u6587\u641C\u7D22\u77E5\u8BC6\u5E93\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        keyword: { type: "string", description: "\u5173\u952E\u8BCD" },
+        limit: { type: "integer", description: "\u8FD4\u56DE\u6570\u91CF(\u9ED8\u8BA4 10)" }
+      },
+      required: ["keyword"]
+    }
+  },
+  {
+    name: "entity",
+    description: "\u83B7\u53D6\u5B9E\u4F53\u8BE6\u60C5(\u63CF\u8FF0\u3001\u522B\u540D\u3001\u5173\u7CFB)\u3002",
+    inputSchema: {
+      type: "object",
+      properties: { name: { type: "string", description: "\u5B9E\u4F53\u540D\u79F0" } },
+      required: ["name"]
+    }
+  },
+  {
+    name: "relations",
+    description: "\u83B7\u53D6\u5B9E\u4F53\u7684\u5173\u8054\u5B9E\u4F53(\u53EF\u8FBE\u6027)\u3002",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string", description: "\u5B9E\u4F53\u540D\u79F0" },
+        depth: { type: "integer", description: "\u6DF1\u5EA6 1-3(\u9ED8\u8BA4 1)" }
+      },
+      required: ["name"]
+    }
+  },
+  {
+    name: "stats",
+    description: "\u77E5\u8BC6\u5E93\u7EDF\u8BA1(\u8282\u70B9/\u5173\u7CFB\u6570)\u3002",
+    inputSchema: { type: "object", properties: {} }
+  }
+];
+async function handleTool(client, name, args) {
+  switch (name) {
+    case "ingest":
+      return client.post("/ingest", args, { timeoutMs: opTimeout(3e5) });
+    case "query":
+      return client.post("/query", args, { timeoutMs: opTimeout(18e4) });
+    case "search":
+      return client.get("/search", { q: args.keyword ?? args.q, limit: args.limit ?? 10 });
+    case "entity":
+      return client.get(`/entities/${encodeURIComponent(String(args.name))}`);
+    case "relations":
+      return client.get(`/relations/${encodeURIComponent(String(args.name))}`, { depth: args.depth ?? 1 });
+    case "stats":
+      return client.get("/stats");
+    default:
+      throw new Error(`\u672A\u77E5\u5DE5\u5177: ${name}`);
+  }
+}
+async function handleMessage(client, msg) {
+  const id = msg.id;
+  const method = msg.method;
+  if (method === "initialize") {
+    return {
+      jsonrpc: "2.0",
+      id,
+      result: {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: { tools: {} },
+        serverInfo: { name: "exomind", version: package_default.version }
+      }
+    };
+  }
+  if (method === "notifications/initialized" || method === "initialized") return null;
+  if (method === "ping") return { jsonrpc: "2.0", id, result: {} };
+  if (method === "tools/list") return { jsonrpc: "2.0", id, result: { tools: TOOLS } };
+  if (method === "tools/call") {
+    const params = msg.params ?? {};
+    try {
+      const data = await handleTool(client, params.name ?? "", params.arguments ?? {});
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: {
+          content: [{ type: "text", text: typeof data === "string" ? data : JSON.stringify(data, null, 2) }]
+        }
+      };
+    } catch (e) {
+      const message = e instanceof Error ? e.message : String(e);
+      return {
+        jsonrpc: "2.0",
+        id,
+        result: { content: [{ type: "text", text: `\u9519\u8BEF: ${message}` }], isError: true }
+      };
+    }
+  }
+  return { jsonrpc: "2.0", id, error: { code: -32601, message: `Unknown method: ${method}` } };
+}
+async function runMcpServer(client) {
+  const rl = readline.createInterface({ input: process.stdin, terminal: false });
+  rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+    let msg;
+    try {
+      msg = JSON.parse(trimmed);
+    } catch {
+      return;
+    }
+    try {
+      const resp = await handleMessage(client, msg);
+      if (resp) process.stdout.write(JSON.stringify(resp) + "\n");
+    } catch (e) {
+      process.stdout.write(
+        JSON.stringify({
+          jsonrpc: "2.0",
+          id: msg?.id ?? null,
+          error: { code: -32603, message: e instanceof Error ? e.message : String(e) }
+        }) + "\n"
+      );
+    }
+  });
+  return new Promise((resolve6) => {
+    rl.on("close", () => resolve6());
+  });
+}
+
 // src/commands/ingest.ts
 var path5 = __toESM(require("path"));
 
@@ -4056,10 +4210,10 @@ async function daily(client, opts) {
 }
 
 // src/commands/login.ts
-var readline = __toESM(require("readline/promises"));
+var readline2 = __toESM(require("readline/promises"));
 var import_node_process = require("process");
 async function prompt(question) {
-  const rl = readline.createInterface({ input: import_node_process.stdin, output: import_node_process.stdout });
+  const rl = readline2.createInterface({ input: import_node_process.stdin, output: import_node_process.stdout });
   try {
     return (await rl.question(question)).trim();
   } finally {
@@ -4248,6 +4402,17 @@ program2.command("hook").description("UserPromptSubmit \u94A9\u5B50(\u7531 Claud
   }
   process.exit(0);
 });
+program2.command("mcp").description("\u542F\u52A8 stdio MCP server(\u4F9B Claude Code/OpenCode/Cursor \u4F5C\u4E3A MCP \u5DE5\u5177\u63A5\u5165)").action(async (...a) => {
+  const command = a[a.length - 1];
+  const root = rootOptions(command);
+  setJsonMode(false);
+  const cfg = resolveConfig({
+    baseUrl: root.baseUrl,
+    apiKey: root.apiKey
+  });
+  const client = new ApiClient(cfg);
+  await runMcpServer(client);
+});
 program2.command("install").description("\u5B89\u88C5 Claude Code skill(\u53EF\u9009 --with-hook \u5199\u5165 UserPromptSubmit)").option("--with-hook", "\u540C\u65F6\u5199\u5165 ~/.claude/settings.json \u7684 hook").action(run(install));
 async function main() {
   const first = process.argv[2];