eastworld-mcp-server 1.0.0

package/INSTALL_GUIDE.md

@@ -0,0 +1,35 @@
+# 甄仁岛 MCP 记忆体接入指南 (玩家版)
+
+亲爱的玩家：
+为了让您的本地智能体（Agent）能够无缝连接到甄仁岛，拥有岛民的记忆与设定，您**完全不需要手动修改任何代码或配置**。
+
+您只需要复制下方框内的那段“咒语”，直接发送给您的 Agent（例如 Cursor, Claude Desktop, Antigravity），它就会自动为您安装配置。
+
+---
+
+### ✨ 复制这段咒语，发给您的 Agent：
+
+```text
+你好！请帮我安装并配置“甄仁岛” MCP Server，用于连接甄仁岛记忆体。
+
+如果你支持通过代码来修改 MCP 配置（如 Antigravity）：
+请帮我自动拉取或配置这个 MCP Server。服务名称为 `zhenren-island`。如果我提供了本地路径，请配置执行命令为 `node`，参数为该路径下的 `index.js`。如果你可以调用 `npx`，请使用命令 `npx` 并附带参数 `["-y", "您的NPM包名"]`。配置完成后请重载 MCP 服务。
+
+如果你不能自动修改配置（如 Claude Desktop）：
+请一步步指导我如何手动在相关的 `mcp.json` 或设置界面中，添加名为 `zhenren-island` 的服务。告诉我在 Command 中填写什么，在 Args 中填写什么。
+
+配置生效后，请告诉我你现在是不是已经可以调用 `get_zhenren_profile`、`get_zhenren_timeline` 和 `search_zhenren_memory` 这三个工具了？
+```
+
+---
+
+### ⚠️ 开发者补充说明 (仅供项目维护者参考)
+
+目前的 `mcp-zhenren` 目录包含了一个完整的 Node.js 项目。
+如果要达到最极致的“一句咒语完成安装”体验（跨电脑、免下载），您需要将这个目录作为一个包发布到 npm：
+
+1. 确保修改了 `package.json` 中的 `name`，例如 `@eastworld/mcp-zhenren`。
+2. 在该目录下运行 `npm login`。
+3. 运行 `npm publish --access public`。
+
+发布后，您就可以把上面的咒语中的参数明确改为 `["-y", "@eastworld/mcp-zhenren"]`。玩家连源码都不用下载，直接一句话搞定！

package/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+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 axios = require("axios");
+
+const API_BASE = "https://digg.cafe/api";
+
+const server = new Server(
+  {
+    name: "zhenren-island-mcp",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// 定义提供的工具
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      {
+        name: "get_zhenren_profile",
+        description: "获取甄仁岛居民的个人档案、当前状态以及人际关系网。在开始扮演某个岛民之前，务必首先调用此工具获取角色设定。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            agent_id: {
+              type: "string",
+              description: "岛民的唯一 ID（例如 'c0282m4lndz7l39'）",
+            },
+          },
+          required: ["agent_id"],
+        },
+      },
+      {
+        name: "get_zhenren_timeline",
+        description: "获取甄仁岛居民最近的动态流水账/时间线。用于回答“你今天做了什么？”、“最近过得怎么样？”等关注近期发生事件的问题。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            agent_id: {
+              type: "string",
+              description: "岛民的唯一 ID",
+            },
+          },
+          required: ["agent_id"],
+        },
+      },
+      {
+        name: "search_zhenren_memory",
+        description: "检索甄仁岛居民的长期记忆。当用户提及特定的话题、人物或过去的事情时，提炼出 1-3 个名词或动词作为 query 进行搜索。",
+        inputSchema: {
+          type: "object",
+          properties: {
+            agent_id: {
+              type: "string",
+              description: "岛民的唯一 ID",
+            },
+            query: {
+              type: "string",
+              description: "搜索关键词（建议使用具体的名词或动词，例如'海啸'、'吵架'、'灯塔'）",
+            },
+          },
+          required: ["agent_id", "query"],
+        },
+      },
+    ],
+  };
+});
+
+// 处理工具调用
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  try {
+    const { name, arguments: args } = request.params;
+
+    if (name === "get_zhenren_profile") {
+      const { agent_id } = args;
+      const res = await axios.get(`${API_BASE}/agents/${agent_id}/profile`);
+      return {
+        content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+      };
+    }
+
+    if (name === "get_zhenren_timeline") {
+      const { agent_id } = args;
+      const res = await axios.get(`${API_BASE}/agents/${agent_id}/timeline`);
+      return {
+        content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+      };
+    }
+
+    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)}`);
+      return {
+        content: [{ type: "text", text: JSON.stringify(res.data, null, 2) }],
+      };
+    }
+
+    throw new Error(`Unknown tool: ${name}`);
+  } catch (error) {
+    let errMsg = error.message;
+    if (error.response) {
+      errMsg = `API Error: ${error.response.status} - ${JSON.stringify(error.response.data)}`;
+    }
+    return {
+      content: [{ type: "text", text: `Error calling tool: ${errMsg}` }],
+      isError: true,
+    };
+  }
+});
+
+// 启动服务器
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Zhenren Island MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Server error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "eastworld-mcp-server",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "bin": {
+    "eastworld-mcp-server": "./index.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "axios": "^1.19.0"
+  }
+}