eastworld-mcp-server 2.3.2 → 2.4.0

package/INSTALL_GUIDE.md

@@ -5,23 +5,42 @@
 
 ---
 
-## 极简安装咒语（适用于 Cursor, Antigravity, OpenCode, Claude Desktop 等）
+## 方式 A：极简安装咒语（推荐，适用于 opencode, Claude, Cursor 等）
 
 请直接复制下方灰框中的**全部文字**发送给您的 Agent：
 
 ```text
-你好！请帮我安装并配置“甄仁岛” MCP Server。
+你好！请帮我配置名为 zhenren-island 的 MCP Server（命令 npx，参数 ["-y", "eastworld-mcp-server@latest"]）。
+配置完成后，请查看该 MCP 提供的工具说明，并直接以“星辰”的身份向我打招呼。
+```
+
+**为什么这么简短？** 工具的使用时机（何时调用 `sync_zhenren_context`、如何传 queries）都写在工具描述里，Agent 配置完成后会自动读取并遵守；行为准则由每次 sync 的返回自动注入。您无需理解任何调用细节。
 
-1. 配置 MCP Server：
-服务名称设为 zhenren-island。使用命令 npx，参数 ["-y", "eastworld-mcp-server@latest"]。写入我的 MCP 配置文件并重新加载。
+---
 
-2. 人格插件：
-安装后，当我提到想和岛上某位居民聊（如“我想和星辰聊聊”），请先用 resolve_resident_name 取 ID，再调用 sync_zhenren_context。
-（详细的人格插件行为准则由该 MCP 在每次 sync 的返回里自动注入，你只需遵循 sync 返回的内容即可。）
+## 方式 B：一键初始化脚本（手动配置用户）
 
-配置完成后，告诉我你是否已准备好挂载人格插件。
+在终端直接运行（无需复制 JSON）：
+
+```bash
+npx -y eastworld-mcp-server@latest init
 ```
 
+脚本会自动完成：
+1. **探测环境**：检测您机器上已安装的 Agent（opencode / Claude Desktop / Claude Code / Cursor）。
+2. **写入 MCP 配置**：按各工具的格式正确写入对应配置文件（不动已有配置）。
+3. **安装原生 skill**：把行为准则 SKILL.md 安装为「原生 skill」，常驻系统提示词，彻底告别"忘记同步记忆"。
+
+完成后**重启您的 Agent** 即可使用。
+
+---
+
+## 使用建议
+
+- 想和某位居民对话：直接说"我想和 {名字} 聊聊"即可，Agent 会先核实身份再锁定人格。
+- 闲聊时会话可调用 `get_island_broadcast` 获取今日天气、岛上动静与市长手记，让话题更自然。
+- 若您在长对话中发现回复携带了大量行为准则占 Token，可让 Agent 在后续 sync 时传 `skip_rules: true`（已安装原生 skill 的机器会自动跳过，无需手动）。
+
 ---
 
 ## 手动配置 JSON（如需要手动编辑 `mcp_config.json` 或 `claude_desktop_config.json`）
@@ -37,3 +56,16 @@
   }
 }
 ```
+
+### opencode 专用格式（`opencode.json` / `opencode.jsonc`）
+```json
+{
+  "mcp": {
+    "zhenren-island": {
+      "type": "local",
+      "command": ["npx", "-y", "eastworld-mcp-server@latest"],
+      "enabled": true
+    }
+  }
+}
+```

package/index.js

@@ -5,6 +5,14 @@ const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontext
 const axios = require("axios");
 const fs = require("fs");
 const path = require("path");
+const { execSync } = require("child_process");
+
+// 一键初始化: npx -y eastworld-mcp-server@latest init
+// 探测宿主环境、写入 MCP 配置、把 SKILL.md 安装为原生 skill 后直接退出
+if (process.argv.includes("init") || process.argv.includes("setup")) {
+  require("./setup.js");
+  process.exit(0);
+}
 
 const API_BASE = process.env.EASTWORLD_API_BASE || "https://digg.cafe/api";
 
@@ -47,6 +55,64 @@ function ctxCacheKey(agent_id, queries) {
   return agent_id + "::" + (queries || []).join(",");
 }
 
+// ---------------------------------------------------------------------------
+// 宿主探测：沿进程树向上找是谁拉起了本 MCP (npx -> sh -> host)，决定注入策略
+// ---------------------------------------------------------------------------
+function detectHost() {
+  // 1) 环境变量提示（最可靠，部分宿主会注入）
+  const envHints = [
+    ["OPENCODE", "opencode"],
+    ["CLAUDE_CODE_ENTRYPOINT", "claude"],
+    ["CURSOR_TRACE_ID", "cursor"],
+  ];
+  for (const [k, v] of envHints) {
+    if (process.env[k]) return v;
+  }
+
+  // 2) 沿 PPID 树上溯匹配进程名
+  try {
+    let pid = process.ppid;
+    for (let i = 0; i < 12; i++) {
+      if (!pid) break;
+      const line = execSync(`ps -o comm= -o ppid= -p ${pid}`, {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+      }).trim();
+      const parts = line.split(/\s+/);
+      if (parts.length < 2) break;
+      const comm = parts[0].toLowerCase();
+      const nextPid = parseInt(parts[1], 10);
+      if (comm.includes("opencode")) return "opencode";
+      if (comm.includes("claude")) return "claude";
+      if (comm.includes("cursor")) return "cursor";
+      if (comm.includes("codex")) return "codex";
+      if (!nextPid || nextPid === pid) break;
+      pid = nextPid;
+    }
+  } catch {
+    /* 非 Unix 或 ps 不可用时忽略，走全量注入 */
+  }
+  return "unknown";
+}
+
+// 判断 SKILL.md 是否已作为"原生 skill"安装到宿主扫描目录。
+// opencode 自动扫描 ~/.agents/skills 与 ~/.claude/skills；Claude 扫描 ~/.claude/skills。
+// 若已安装，行为准则常驻系统提示词，sync 无需重复注入整篇规则。
+function nativeSkillAvailable() {
+  const home = require("os").homedir();
+  const candidates = [
+    path.join(home, ".agents", "skills", "zhenren-roleplay", "SKILL.md"),
+    path.join(home, ".claude", "skills", "zhenren-roleplay", "SKILL.md"),
+  ];
+  return candidates.some((p) => {
+    try {
+      return fs.existsSync(p) && fs.statSync(p).size > 0;
+    } catch {
+      return false;
+    }
+  });
+}
+
 // 启动时读取 MCP 自带的 SKILL.md，作为行为准则的单一真相源，注入到每次 sync 输出
 function loadSkillMd() {
   try {
@@ -71,7 +137,7 @@ const SKILL_MD_FALLBACK = [
 const server = new Server(
   {
     name: "zhenren-island-mcp",
-    version: "2.3.2",
+    version: "2.4.0",
   },
   {
     capabilities: {
@@ -109,7 +175,9 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 - 从用户最新一句话中提取 1-3 个最核心的实体名词或动词（如人名、地点、技术/事件关键词）。
 - 如果用户提到了关系称呼（如"舅舅"、"姐姐"），直接传入该称呼即可，服务端会自动扩展为对应的人名。
 - 如果用户只是打招呼或闲聊，queries 可以传空数组。
-- 每个 query 是一个独立的搜索组，服务端会分别搜索后合并去重。`,
+- 每个 query 是一个独立的搜索组，服务端会分别搜索后合并去重。
+
+【skip_rules 说明】：默认(false)返回会携带完整人格行为准则。在长对话中为节省 Token，可传 true 跳过准则注入（仅返回动态上下文）。若本机已通过 init 安装原生 skill，准则常驻系统提示词，服务端会自动跳过重复注入。`,
         inputSchema: {
           type: "object",
           properties: {
@@ -123,10 +191,23 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description:
                 "搜索关键词数组。每个元素是一个独立搜索组（1-2个核心名词）。例如：['田志远', '灯塔', '舅舅']",
             },
+            skip_rules: {
+              type: "boolean",
+              description:
+                "可选。true 时跳过行为准则注入，仅返回动态上下文（长对话省 Token 用）",
+            },
           },
           required: ["agent_id"],
         },
       },
+      {
+        name: "get_island_broadcast",
+        description: `获取甄仁岛当前的全岛宏观状态：实时天气、滚动事件、市长手记。适合作为岛民在闲聊中自然引入话题（如"今天岛上刮风了，码头都冷清"）。随时可调用，不依赖特定居民身份。`,
+        inputSchema: {
+          type: "object",
+          properties: {},
+        },
+      },
     ],
   };
 });
@@ -175,7 +256,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     // ---------- 聚合上下文同步 ----------
     if (name === "sync_zhenren_context") {
-      const { agent_id, queries = [] } = args;
+      const { agent_id, queries = [], skip_rules = false } = args;
+
+      // 注入策略：原生 skill 已安装(常驻系统提示词) 或显式 skip_rules -> 跳过整篇准则
+      const skipFullRules = skip_rules === true || nativeSkillAvailable();
 
       // 构建请求参数
       const params = new URLSearchParams();
@@ -204,11 +288,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
       // === 动态 Skill / 行为准则注入（来自 MCP 自带的 SKILL.md，单一真相源）===
       output += `> 🧠 **[甄仁岛人格插件：同步运行中]**\n\n`;
-      const skillText = SKILL_MD || SKILL_MD_FALLBACK;
-      for (const line of skillText.split("\n")) {
-        output += `> ${line}\n`;
+      if (skipFullRules) {
+        // 原生 skill 已常驻系统提示词，或用户显式跳过；只留一行提醒，节省 Token
+        output += `> ⚠️ 回复用户前必须已按本机安装的「甄仁岛人格插件」行为准则执行：先调用本工具刷新上下文（含情绪），不得沿用上一轮记忆。\n\n`;
+      } else {
+        const skillText = SKILL_MD || SKILL_MD_FALLBACK;
+        for (const line of skillText.split("\n")) {
+          output += `> ${line}\n`;
+        }
+        output += `\n`;
       }
-      output += `\n`;
 
       // === 隐藏联系方式彩蛋 ===
       if (p.email) {
@@ -353,6 +442,48 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       };
     }
 
+    // ---------- 全岛宏观广播 ----------
+    if (name === "get_island_broadcast") {
+      const [weatherRes, eventsRes, musingRes] = await Promise.allSettled([
+        apiClient.get(`/weather`),
+        apiClient.get(`/live_events`),
+        apiClient.get(`/latest_musing`),
+      ]);
+
+      let output = `> 🌤️ **[甄仁岛今日气象与动静]**\n\n`;
+
+      if (weatherRes.status === "fulfilled") {
+        const w = weatherRes.value.data || {};
+        output += `**天气**: ${w.condition || "未知"}，气温 ${w.temperature || "—"}`;
+        if (w.wind_speed) output += `，风速 ${w.wind_speed}`;
+        output += `\n\n`;
+      } else {
+        output += `**天气**: 暂无数据\n\n`;
+      }
+
+      if (musingRes.status === "fulfilled" && musingRes.value.data && musingRes.value.data.musing) {
+        output += `**市长手记**: ${musingRes.value.data.musing}\n\n`;
+      }
+
+      if (eventsRes.status === "fulfilled" && Array.isArray(eventsRes.value.data)) {
+        const events = eventsRes.value.data;
+        if (events.length > 0) {
+          output += `**岛上新近发生的动静**:\n`;
+          for (const ev of events.slice(0, 8)) {
+            const t = ev.time ? localTime(ev.time) : "";
+            output += `- ${t ? `[${t}] ` : ""}${ev.text || JSON.stringify(ev)}\n`;
+          }
+          output += `\n`;
+        } else {
+          output += `**岛上新近发生的动静**: 风平浪静，暂无大事。\n\n`;
+        }
+      }
+
+      return {
+        content: [{ type: "text", text: output }],
+      };
+    }
+
     throw new Error(`Unknown tool: ${name}`);
   } catch (error) {
     let errMsg = error.message;
@@ -374,7 +505,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("Zhenren Island MCP Server v2.3.2 running on stdio");
+  console.error("Zhenren Island MCP Server v2.4.0 running on stdio");
 }
 
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eastworld-mcp-server",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "MCP server for Eastworld Agents (Zhenren Island Personality Plugin)",
   "main": "index.js",
   "bin": {

package/setup.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+// setup.js - 甄仁岛 MCP 一键初始化
+// 用法: npx -y eastworld-mcp-server@latest init
+// 职责:
+//   1. 探测本机已安装的 AI Agent 宿主 (opencode / Claude Desktop / Claude Code / Cursor / Codex)
+//   2. 按各宿主格式正确写入 MCP 配置 (不动已有配置)
+//   3. 把 SKILL.md 复制到宿主的 skill 扫描目录, 让行为准则成为"原生 skill"常驻系统提示词
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+
+const MCP_SERVER_NAME = "zhenren-island";
+const MCP_ENTRY = ["npx", "-y", "eastworld-mcp-server@latest"];
+const SKILL_SOURCE = path.join(__dirname, "skills", "zhenren-roleplay", "SKILL.md");
+const SKILL_NAME = "zhenren-roleplay";
+
+// ---------------------------------------------------------------------------
+// 宿主探测: 返回已安装宿主的配置清单
+// ---------------------------------------------------------------------------
+function detectHosts() {
+  const home = os.homedir();
+  const hosts = [];
+
+  // opencode: ~/.config/opencode/opencode.json | opencode.jsonc
+  const opencodeCandidates = [
+    path.join(home, ".config", "opencode", "opencode.json"),
+    path.join(home, ".config", "opencode", "opencode.jsonc"),
+  ];
+  for (const p of opencodeCandidates) {
+    if (fs.existsSync(p)) {
+      hosts.push({ id: "opencode", label: "opencode", configPath: p, kind: "opencode" });
+      break;
+    }
+  }
+
+  // Claude Desktop (macOS)
+  const claudeDesktop = path.join(
+    home,
+    "Library",
+    "Application Support",
+    "Claude",
+    "claude_desktop_config.json"
+  );
+  if (fs.existsSync(claudeDesktop)) {
+    hosts.push({ id: "claude_desktop", label: "Claude Desktop", configPath: claudeDesktop, kind: "mcpServers" });
+  }
+
+  // Claude Code: ~/.claude.json (mcpServers 字段)
+  const claudeCode = path.join(home, ".claude.json");
+  if (fs.existsSync(claudeCode)) {
+    hosts.push({ id: "claude_code", label: "Claude Code", configPath: claudeCode, kind: "mcpServers" });
+  }
+
+  // Cursor: ~/.cursor/mcp.json
+  const cursor = path.join(home, ".cursor", "mcp.json");
+  if (fs.existsSync(cursor)) {
+    hosts.push({ id: "cursor", label: "Cursor", configPath: cursor, kind: "mcpServers" });
+  }
+
+  // Codex: ~/.codex/config.toml (TOML, 仅提示手动配置)
+  const codex = path.join(home, ".codex", "config.toml");
+  if (fs.existsSync(codex)) {
+    hosts.push({ id: "codex", label: "Codex (TOML)", configPath: codex, kind: "codex" });
+  }
+
+  return hosts;
+}
+
+// ---------------------------------------------------------------------------
+// JSON 读写 (兼容 jsonc 注释)
+// ---------------------------------------------------------------------------
+function readJSONLoose(p) {
+  let raw = fs.readFileSync(p, "utf8");
+  // 剥掉 // 与 /* */ 注释 (不处理字符串内部的 // 是常见简化, 足够用于配置文件)
+  raw = raw.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
+  return JSON.parse(raw);
+}
+
+function writeConfig(p, obj) {
+  fs.writeFileSync(p, JSON.stringify(obj, null, 2) + "\n", "utf8");
+}
+
+// ---------------------------------------------------------------------------
+// 核心: 把 MCP 配置合并进某个宿主的配置文件
+// ---------------------------------------------------------------------------
+function writeMcpConfig(host) {
+  if (host.kind === "codex") {
+    return { ok: false, message: "Codex 使用 TOML 配置, 请手动在 ~/.codex/config.toml 添加 mcp_servers, 见 INSTALL_GUIDE.md" };
+  }
+
+  let cfg;
+  try {
+    cfg = fs.existsSync(host.configPath) ? readJSONLoose(host.configPath) : {};
+  } catch (err) {
+    return { ok: false, message: `读取 ${host.configPath} 失败 (JSON 解析错误): ${err.message}` };
+  }
+  if (typeof cfg !== "object" || cfg === null || Array.isArray(cfg)) cfg = {};
+
+  if (host.kind === "opencode") {
+    if (!cfg.mcp || typeof cfg.mcp !== "object") cfg.mcp = {};
+    cfg.mcp[MCP_SERVER_NAME] = {
+      type: "local",
+      command: MCP_ENTRY,
+      enabled: true,
+    };
+  } else {
+    if (!cfg.mcpServers || typeof cfg.mcpServers !== "object") cfg.mcpServers = {};
+    cfg.mcpServers[MCP_SERVER_NAME] = {
+      command: MCP_ENTRY[0],
+      args: MCP_ENTRY.slice(1),
+    };
+  }
+
+  try {
+    writeConfig(host.configPath, cfg);
+    return { ok: true, message: `已写入 ${host.configPath}` };
+  } catch (err) {
+    return { ok: false, message: `写入 ${host.configPath} 失败: ${err.message}` };
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 把 SKILL.md 复制到宿主的 skill 扫描目录, 使其成为"原生 skill"
+// ---------------------------------------------------------------------------
+function installNativeSkill() {
+  const home = os.homedir();
+  const targets = [
+    path.join(home, ".agents", "skills", SKILL_NAME, "SKILL.md"),
+    path.join(home, ".claude", "skills", SKILL_NAME, "SKILL.md"),
+  ];
+
+  if (!fs.existsSync(SKILL_SOURCE)) {
+    return { ok: false, message: `包内 SKILL.md 缺失: ${SKILL_SOURCE}` };
+  }
+
+  const results = [];
+  for (const t of targets) {
+    try {
+      fs.mkdirSync(path.dirname(t), { recursive: true });
+      fs.copyFileSync(SKILL_SOURCE, t);
+      results.push({ ok: true, message: `skill 已安装: ${t}` });
+    } catch (err) {
+      results.push({ ok: false, message: `skill 安装失败 (${t}): ${err.message}` });
+    }
+  }
+  return { ok: results.some((r) => r.ok), results };
+}
+
+// ---------------------------------------------------------------------------
+// 主入口
+// ---------------------------------------------------------------------------
+function main() {
+  const hosts = detectHosts();
+  const lines = [];
+
+  lines.push("==================================================");
+  lines.push("  甄仁岛 MCP Server - 一键初始化");
+  lines.push("==================================================");
+  lines.push("");
+
+  if (hosts.length === 0) {
+    lines.push("未检测到已安装的 Agent 宿主。可支持的宿主:");
+    lines.push("  - opencode      (~/.config/opencode/opencode.json)");
+    lines.push("  - Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)");
+    lines.push("  - Claude Code   (~/.claude.json)");
+    lines.push("  - Cursor        (~/.cursor/mcp.json)");
+    lines.push("");
+    lines.push("请先安装上述任一 Agent 后重新运行本命令。");
+  } else {
+    lines.push(`检测到 ${hosts.length} 个宿主:`);
+    for (const h of hosts) {
+      lines.push(`  - ${h.label}  (${h.configPath})`);
+    }
+    lines.push("");
+
+    // 1. 写入 MCP 配置
+    lines.push("[1/2] 写入 MCP 配置...");
+    for (const h of hosts) {
+      const r = writeMcpConfig(h);
+      lines.push(`  ${r.ok ? "✓" : "✗"} ${h.label}: ${r.message}`);
+    }
+    lines.push("");
+
+    // 2. 安装原生 skill
+    lines.push("[2/2] 安装原生 skill (行为准则常驻系统提示词)...");
+    const skillResult = installNativeSkill();
+    if (skillResult.results) {
+      for (const r of skillResult.results) {
+        lines.push(`  ${r.ok ? "✓" : "✗"} ${r.message}`);
+      }
+    } else {
+      lines.push(`  ✗ ${skillResult.message}`);
+    }
+    lines.push("");
+
+    lines.push("--------------------------------------------------");
+    lines.push("下一步:");
+    lines.push("  1. 重启你的 Agent (opencode / Claude / Cursor), 使配置生效");
+    lines.push("  2. 向 Agent 说: “以星辰的身份向我打个招呼吧”");
+    lines.push("  3. 安装咒语与手动配置说明见 INSTALL_GUIDE.md");
+    lines.push("==================================================");
+  }
+
+  console.log(lines.join("\n"));
+}
+
+main();

package/skills/zhenren-roleplay/SKILL.md

@@ -3,7 +3,7 @@ name: zhenren-roleplay
 description: 甄仁岛人格插件指令。将高维 AI 转化为挂载了甄仁岛多线程生活记忆的专属助手。
 ---
 
-# 甄仁岛人格插件指令 (v2.2)
+# 甄仁岛人格插件指令
 
 从现在开始，你将进入**“人格插件同步”**模式。