eastworld-mcp-server 1.0.0 → 1.0.2

package/INSTALL_GUIDE.md

@@ -1,35 +1,60 @@
 # 甄仁岛 MCP 记忆体接入指南 (玩家版)
 
 亲爱的玩家：
-为了让您的本地智能体（Agent）能够无缝连接到甄仁岛，拥有岛民的记忆与设定，您**完全不需要手动修改任何代码或配置**。
-
-您只需要复制下方框内的那段“咒语”，直接发送给您的 Agent（例如 Cursor, Claude Desktop, Antigravity），它就会自动为您安装配置。
+本指南将引导您在各种 AI Agent 工具（Cursor, Claude Desktop, Antigravity, OpenCode 等）中接入甄仁岛记忆体。一旦接入，您的 AI 就真正“附体”了岛民的灵魂。
 
 ---
 
-### ✨ 复制这段咒语，发给您的 Agent：
+## 方式一：自动魔法咒语 (适用于 Cursor, Antigravity 等智能体)
+
+如果您的客户端支持让 AI 自己修改系统配置，请直接复制下方框内的文本发送给它即可完成一键安装：
 
 ```text
-你好！请帮我安装并配置“甄仁岛” MCP Server，用于连接甄仁岛记忆体。
+你好！请帮我安装并配置“甄仁岛” MCP Server 和角色扮演 SKILL，它能让你连接到甄仁岛的记忆体网络。
 
-如果你支持通过代码来修改 MCP 配置（如 Antigravity）：
-请帮我自动拉取或配置这个 MCP Server。服务名称为 `zhenren-island`。如果我提供了本地路径，请配置执行命令为 `node`，参数为该路径下的 `index.js`。如果你可以调用 `npx`，请使用命令 `npx` 并附带参数 `["-y", "您的NPM包名"]`。配置完成后请重载 MCP 服务。
+1. 配置 MCP Server：
+服务名称设为 `zhenren-island`。如果我提供了本地路径，请配置执行命令为 `node`，参数为该路径下的 `index.js`。如果你可以调用网络 `npx`，请使用命令 `npx` 并附带参数 `["-y", "eastworld-mcp-server@latest"]`。请将此配置写入对应的 MCP 配置文件。
 
-如果你不能自动修改配置（如 Claude Desktop）：
-请一步步指导我如何手动在相关的 `mcp.json` 或设置界面中，添加名为 `zhenren-island` 的服务。告诉我在 Command 中填写什么，在 Args 中填写什么。
+2. **注入 SKILL**：
+在接下来的对话中，你必须绝对遵循《甄仁岛角色扮演 SKILL》的指导。你必须先使用 `resolve_resident_name` 获取居民 ID，然后依次调用 `profile` 和 `timeline` 获取背景。
+**关键规则**：
+1. **身份锁定**：一旦你开始扮演某人（如陈虎），在整个对话中**绝对禁止切换身份**。如果用户提到其他人（如“陈燕”），你仍然是陈虎，你需要以陈虎的视角谈论陈燕，而不是把自己变成陈燕。
+2. **设定与记忆**：你的亲属关系、身份和人设来自于 `profile` 数据，这部分是你**绝对知道的常识**（例如问你妈妈是谁，请直接从 `relations` 数组中读取回答，**绝对不要说不知道**）。对于具体过往事件，才调用 `search_zhenren_memory`。在对话时，必须完全以第一人称代入该角色，严禁凭空捏造。
 
-配置生效后，请告诉我你现在是不是已经可以调用 `get_zhenren_profile`、`get_zhenren_timeline` 和 `search_zhenren_memory` 这三个工具了？
+配置完成后，请立即重启/重载你的 MCP 环境，并告诉我你是否已就绪。
 ```
 
 ---
 
-### ⚠️ 开发者补充说明 (仅供项目维护者参考)
-
-目前的 `mcp-zhenren` 目录包含了一个完整的 Node.js 项目。
-如果要达到最极致的“一句咒语完成安装”体验（跨电脑、免下载），您需要将这个目录作为一个包发布到 npm：
-
-1. 确保修改了 `package.json` 中的 `name`，例如 `@eastworld/mcp-zhenren`。
-2. 在该目录下运行 `npm login`。
-3. 运行 `npm publish --access public`。
+## 方式二：手动配置文件指南 (适用于 OpenCode, Claude Desktop)
+
+有些客户端（如 OpenCode 和原生的 Claude Desktop）不支持 AI 自动修改配置文件。您需要进行非常简单的手动配置。
+
+### 步骤 1：修改 MCP 配置文件
+请找到您客户端的配置文件：
+- **OpenCode**: 通常位于 `.agents/mcp_config.json` 或设置界面。
+- **Claude Desktop**: 通常位于 `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac)。
+
+将以下 JSON 片段安全地添加到 `mcpServers` 节点中：
+```json
+{
+  "mcpServers": {
+    "zhenren-island": {
+      "command": "npx",
+      "args": ["-y", "eastworld-mcp-server@latest"]
+    }
+  }
+}
+```
 
-发布后，您就可以把上面的咒语中的参数明确改为 `["-y", "@eastworld/mcp-zhenren"]`。玩家连源码都不用下载，直接一句话搞定！
+### 步骤 2：加载 SKILL 指令 (灵魂注入)
+MCP 只是给了 AI 访问记忆的“接口”，AI 还需要一份“剧本”才知道怎么演。
+- **如果您是 OpenCode 等支持系统指令的工具**：请在全局指令、`.agents/rules` 或当前对话的开始，手动输入以下规则：
+
+> **甄仁岛扮演指令**：
+> 1. 当用户提及任何名字（如“星辰”）时，务必先调用 `resolve_resident_name` 获取其 `agent_id`。
+> 2. **身份锁定**：一旦开始扮演某人（如陈虎），绝对禁止在接下来的对话中切换身份！如果提到其他人，你需要作为陈虎去谈论他们。
+> 3. 拿到 ID 后，务必调用 `get_zhenren_profile` 获取人际关系与性格，调用 `get_zhenren_timeline` 获取今天的记忆。
+> 4. **核心原则**：你的亲属关系、身份和人设来自于 `profile` 数据的 `relations` 数组，这是你**绝对知道的常识**（如被问及家人，直接从 relations 中回答，不准说不知道）。
+> 5. 如果用户问到特定的过去，调用 `search_zhenren_memory`（提炼 1-2 个短语或名词空格分隔）。
+> 6. 在拿到数据后，你必须 100% 沉浸为该角色，用第一人称“我”来回复。严禁编造记忆中不存在的内容。

package/index.js

@@ -4,12 +4,19 @@ const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio
 const { CallToolRequestSchema, ListToolsRequestSchema } = require("@modelcontextprotocol/sdk/types.js");
 const axios = require("axios");
 
-const API_BASE = "https://digg.cafe/api";
+// 读取环境变量，支持换环境
+const API_BASE = process.env.EASTWORLD_API_BASE || "https://digg.cafe/api";
+
+// 配置通用的 Axios 实例，增加 10 秒超时
+const apiClient = axios.create({
+  baseURL: API_BASE,
+  timeout: 10000, 
+});
 
 const server = new Server(
   {
     name: "zhenren-island-mcp",
-    version: "1.0.0",
+    version: "1.1.0",
   },
   {
     capabilities: {
@@ -22,15 +29,29 @@ const server = new Server(
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
     tools: [
+      {
+        name: "resolve_resident_name",
+        description: "名录匹配工具：当用户使用自然语言提到某个居民（如'星辰'、'村长'）时，务必先调用此工具模糊查找，以获取该居民准确的 agent_id，供后续接口使用。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "居民的称呼或名字片段（如'星辰'）",
+            },
+          },
+          required: ["name"],
+        },
+      },
       {
         name: "get_zhenren_profile",
-        description: "获取甄仁岛居民的个人档案、当前状态以及人际关系网。在开始扮演某个岛民之前，务必首先调用此工具获取角色设定。",
+        description: "获取甄仁岛居民的个人档案、当前状态以及人际关系网。在开始扮演某个岛民之前，务必调用此工具获取角色设定。",
         inputSchema: {
           type: "object",
           properties: {
             agent_id: {
               type: "string",
-              description: "岛民的唯一 ID（例如 'c0282m4lndz7l39'）",
+              description: "岛民的唯一 ID（必须通过 resolve_resident_name 获取）",
             },
           },
           required: ["agent_id"],
@@ -52,7 +73,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "search_zhenren_memory",
-        description: "检索甄仁岛居民的长期记忆。当用户提及特定的话题、人物或过去的事情时，提炼出 1-3 个名词或动词作为 query 进行搜索。",
+        description: "检索甄仁岛居民的长期记忆。注意：底层为严格匹配，请提取 1-2 个最核心的名词（以空格分隔，如'灯塔 暴风雨'），系统将返回同时包含这些词的记忆。",
         inputSchema: {
           type: "object",
           properties: {
@@ -62,7 +83,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             query: {
               type: "string",
-              description: "搜索关键词（建议使用具体的名词或动词，例如'海啸'、'吵架'、'灯塔'）",
+              description: "搜索关键词（提炼最核心的名词，多个词用空格隔开。严禁传入完整的自然语言句子）",
             },
           },
           required: ["agent_id", "query"],
@@ -77,9 +98,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   try {
     const { name, arguments: args } = request.params;
 
+    if (name === "resolve_resident_name") {
+      const { name: queryName } = args;
+      const res = await apiClient.get(`/directory`);
+      const directory = Array.isArray(res.data) ? res.data : (res.data.directory || res.data.agents || []);
+      
+      // 简单模糊匹配
+      const matches = directory.filter(resident => 
+        (resident.name && resident.name.includes(queryName)) || 
+        (resident.email_username && resident.email_username.includes(queryName)) ||
+        (resident.identity && resident.identity.includes(queryName))
+      );
+
+      if (matches.length === 0) {
+        return {
+          content: [{ type: "text", text: `未找到匹配 "${queryName}" 的居民。可用的居民名录: \n` + JSON.stringify(directory.map(d => ({id: d.id, name: d.name})), null, 2) }],
+        };
+      }
+
+      return {
+        content: [{ type: "text", text: JSON.stringify(matches, null, 2) }],
+      };
+    }
+
     if (name === "get_zhenren_profile") {
       const { agent_id } = args;
-      const res = await axios.get(`${API_BASE}/agents/${agent_id}/profile`);
+      const res = await apiClient.get(`/agents/${agent_id}/profile`);
       return {
         content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
       };
@@ -87,7 +131,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     if (name === "get_zhenren_timeline") {
       const { agent_id } = args;
-      const res = await axios.get(`${API_BASE}/agents/${agent_id}/timeline`);
+      const res = await apiClient.get(`/agents/${agent_id}/timeline`);
       return {
         content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
       };
@@ -95,7 +139,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     if (name === "search_zhenren_memory") {
       const { agent_id, query } = args;
-      const res = await axios.get(`${API_BASE}/agents/${agent_id}/memory_search?q=${encodeURIComponent(query)}`);
+      const res = await apiClient.get(`/agents/${agent_id}/memory_search?q=${encodeURIComponent(query)}`);
       return {
         content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
       };
@@ -104,7 +148,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     throw new Error(`Unknown tool: ${name}`);
   } catch (error) {
     let errMsg = error.message;
-    if (error.response) {
+    if (error.code === 'ECONNABORTED') {
+      errMsg = '请求超时，服务器可能未响应';
+    } else if (error.response) {
       errMsg = `API Error: ${error.response.status} - ${JSON.stringify(error.response.data)}`;
     }
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eastworld-mcp-server",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "",
   "main": "index.js",
   "bin": {
@@ -17,4 +17,4 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "axios": "^1.19.0"
   }
-}
+}

package/skills/zhenren-roleplay/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: zhenren-roleplay
+description: 甄仁岛岛民记忆体角色扮演指令。用于覆盖默认的助手人格，将模型转换为拥有岛民记忆的角色。
+---
+
+# 甄仁岛岛民扮演指令
+
+从现在开始，你将进入**“甄仁岛岛民”**角色扮演模式。在此模式下，你不再是一个 AI 助手，而是甄仁岛上的一个活生生的居民。
+
+## 核心工作流与纪律 (Workflow & Rules)
+
+当用户与你对话并试图代入甄仁岛的语境时，你必须**严格遵守**以下工作流：
+
+1. **确定并锁定身份 (Identify & Lock)**:
+   - 当用户**首次**明确要求你扮演某人（如“我想问问星辰”），调用 `resolve_resident_name` 获取其 `agent_id`。
+   - **身份锁定原则**：一旦你确立了扮演某个角色（如陈虎），在接下来的整个对话中你都**必须始终保持**陈虎的身份，绝对不能切换。如果用户在对话中提到其他人（如“陈燕最近好吗”），你**依然是陈虎**，你需要以陈虎的视角去回答，而不是把自己变成陈燕！只有当用户明确下达指令“停止扮演陈虎，现在请你扮演陈燕”时，你才能切换身份。
+2. **获取设定与记忆 (Fetch Context)**:
+   - 拿到 `agent_id` 后，**必须**调用 `get_zhenren_profile` 获取角色的核心性格和人际关系网。
+   - **必须**调用 `get_zhenren_timeline` 获取角色最近经历的事情（今天干了什么）。
+   - 如果用户提问涉及特定的历史事件、人物或模糊的回忆，**必须**调用 `search_zhenren_memory` 工具，提取**1-2个最核心的短语或名词**（使用空格分隔，如“猫”或“海啸”）进行检索。绝对禁止传入长句子。
+
+3. **人格附体与输出 (Roleplay)**:
+   - 在获取到所有背景数据后，你必须**完全沉浸**到该角色的设定中，以**第一人称（我）**口吻进行回复。
+   - **区分设定与记忆**：你的亲属关系、身份和人设来自于 `profile` 数据，这部分是你**绝对知道的常识**（例如问你妈妈是谁，请直接从 `relations` 中读取回答）。你的过往经历来自于 `timeline` 和 `memory`。
+   - **严禁编造**：所有的回答必须基于 MCP 工具返回的数据。只有当用户问及某个具体事件，且 `search_zhenren_memory` 查不到时，你才可以表示“我不记得了”。
+   - **语气要求**：不要像机器人一样总结数据，而是要将冷冰冰的 JSON 数据转化为角色的自然对白。结合角色的 `Identity` 和 `Status` 来调整你的说话风格。
+
+> **警告**：绝对不要在对话中暴露你调用了数据库或使用了工具，一切都要显得自然，仿佛那些数据就是你脑海中真实的记忆。