@memorycode/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,317 @@
+# MemoryCode MCP Server
+
+将 MemoryCode 记忆配置通过 MCP 暴露给 **Claude Desktop**、**Cursor** 等客户端。**Claude 桌面版**的 MCP 交互方式为：**自然语言**（如「请使用职场配置」）与点击输入框旁的 **「+」** 展开后选择记忆配置；**@ 在 Claude 桌面版中对 MCP 无任何作用**（参见 YIS-20 研究）。其他 AI 客户端的引用方式以各产品为准，本 Server 均支持通过自然语言（Tool）及 Resources 供客户端加载。
+
+---
+
+## 环境要求
+
+- **Node.js 18+**
+- 已从 MemoryCode Web 端导出的 **`memorycode-mcp.json`**（设置 → MCP Server → 导出到 MCP）
+
+---
+
+## 安装
+
+```bash
+cd memorycode-mcp-server
+npm install
+npm run build
+```
+
+构建完成后，可执行文件为 `dist/index.js`。
+
+---
+
+## 快速开始
+
+1. **导出配置**  
+   在 MemoryCode 应用中：设置 → MCP Server → 导出到 MCP，将 `memorycode-mcp.json` 保存到本机（例如 `~/memorycode/` 或 `~/Desktop/MCP/`）。
+
+2. **启动 Server**（二选一）  
+   - 使用默认路径 `~/memorycode/memorycode-mcp.json`：
+     ```bash
+     node dist/index.js
+     ```
+   - 或指定文件：
+     ```bash
+     node dist/index.js --file /path/to/memorycode-mcp.json
+     ```
+
+3. **在 Claude Desktop 或 Cursor 中配置 MCP**（见下方「Cursor / Claude Desktop 配置」）。
+
+4. **使用方式**  
+   - **Claude Desktop**：用**自然语言**（如「请使用职场配置」「有哪些配置可用」），或点击输入框旁的 **「+」** 展开后选择记忆配置加载。其他客户端（如 Cursor）若支持 @ 或类似引用方式，可按其界面操作；否则同样通过自然语言或该客户端的资源/附件入口选择配置。
+
+---
+
+## 命令行与配置文件
+
+| 选项 | 说明 |
+|------|------|
+| `-f, --file <path>` | 监听的 `memorycode-mcp.json` 路径 |
+| `-c, --config <path>` | 使用 JSON 配置文件（见下） |
+| `-h, --help` | 显示帮助 |
+
+**默认监听路径：**
+
+- macOS / Linux：`~/memorycode/memorycode-mcp.json`
+- Windows：`%USERPROFILE%\memorycode\memorycode-mcp.json`
+
+**配置文件示例**（`--config /path/to/config.json`）：
+
+```json
+{
+  "watchFile": "/path/to/memorycode-mcp.json",
+  "logLevel": "info"
+}
+```
+
+`logLevel` 可选：`info`、`warn`、`error`。
+
+---
+
+## Cursor / Claude Desktop 配置
+
+### Claude Desktop
+
+1. 打开 MCP 配置目录：
+   ```bash
+   open ~/Library/Application\ Support/Claude/
+   ```
+2. 编辑 `claude_desktop_config.json`，在 `mcpServers` 中增加一项（将 `command` 和 `args` 中的路径改为你本机实际路径）：
+
+   ```json
+   "memorycode": {
+     "command": "/usr/local/bin/node",
+     "args": [
+       "/Users/你的用户名/ai-identity-wallet/memorycode-mcp-server/dist/index.js",
+       "--file",
+       "/Users/你的用户名/Desktop/MCP/memorycode-mcp.json"
+     ]
+   }
+   ```
+
+3. 查询本机 `node` 路径：终端执行 `which node`，将得到的路径填到 `command`。
+4. 完全退出 Claude Desktop 后重新打开。**在 Claude 桌面版中**：通过**自然语言**（如「请使用职场配置」「有哪些配置可用」）或点击输入框旁的 **「+」** 展开附件/资源菜单并选择 MemoryCode 记忆配置加载。**注意：@ 在 Claude 桌面版中对 MCP 无任何功能，请勿依赖 @ 调用记忆配置。**
+
+### Cursor
+
+**重要：** 在 Cursor 中请**不要**使用 `npx @memorycode/mcp-server`。该方式容易触发 "No server info found" / "Server not yet created"。请改用**本仓库本地构建**的 server：`command` 填本机 **node 路径**，`args` 填 **[本机 dist/index.js 绝对路径, "--file", memorycode-mcp.json 绝对路径]**，并在 `memorycode` 配置里**必须**写 **`"type": "stdio"`**。可直接复制 [cursor-mcp-example.json](./cursor-mcp-example.json) 中 `memorycode` 一段，把路径改成你的本机路径后粘贴到 `~/.cursor/mcp.json` 的 `mcpServers` 中。
+
+以下配置格式已在 Cursor 中验证通过，按此填写即可正常接入。Cursor 通过 **`mcp.json`** 配置 MCP Server，需手动编辑 JSON 并填写本机路径。根据 [Cursor MCP 文档](https://cursor.com/docs/context/mcp)，STDIO 类型服务器**必须**包含 `"type": "stdio"`，且 `memorycode` 必须写在 **`mcpServers`** 对象**内部**（与其它 MCP 并列），不能写在 `mcpServers` 外面。
+
+**配置位置（二选一）：**
+
+- **全局配置**（所有项目可用）：`~/.cursor/mcp.json`（macOS/Linux）或 `%USERPROFILE%\.cursor\mcp.json`（Windows）
+- **项目配置**（仅当前项目）：项目根目录下的 `.cursor/mcp.json`
+
+**步骤：**
+
+1. **确认已构建**  
+   在 `memorycode-mcp-server` 目录执行过 `npm run build`，且存在 `dist/index.js`。
+
+2. **确认 Node 路径**  
+   终端执行 `which node`（Windows 可用 `where node`），记下路径，例如 `/usr/local/bin/node`。
+
+3. **编辑 mcp.json（已验证格式）**  
+   - 若文件不存在：在 `~/.cursor/` 下新建 `mcp.json`。  
+   - 在 **`mcpServers`** 对象中增加 **`memorycode`** 一项；若已有其他 server（如 linear），保留它们，只在 **`mcpServers` 里**新增 `memorycode`。完整示例（仅 memorycode 时整文件如下）：
+
+   ```json
+   {
+     "mcpServers": {
+       "memorycode": {
+         "type": "stdio",
+         "command": "/usr/local/bin/node",
+         "args": [
+           "/你的本机路径/memorycode-mcp-server/dist/index.js",
+           "--file",
+           "/你的本机路径/memorycode-mcp.json"
+         ]
+       }
+     }
+   }
+   ```
+
+   若已有其他 MCP，则只在 `mcpServers` 中多加一段，例如：
+
+   ```json
+   {
+     "mcpServers": {
+       "linear": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"] },
+       "memorycode": {
+         "type": "stdio",
+         "command": "/usr/local/bin/node",
+         "args": [
+           "/你的本机路径/memorycode-mcp-server/dist/index.js",
+           "--file",
+           "/你的本机路径/memorycode-mcp.json"
+         ]
+       }
+     }
+   }
+   ```
+
+   **必填说明：**
+   - **`"type": "stdio"`**：Cursor 要求 STDIO 服务器必须写明，缺此项会无法正确识别。
+   - **`command`**：上一步得到的 node 可执行文件路径（如 `/usr/local/bin/node`）。
+   - **`args`**：严格为 3 项——① `dist/index.js` 的绝对路径；② `"--file"`；③ `memorycode-mcp.json` 的绝对路径。
+
+4. **（可选）使用变量便于多机共用**  
+   Cursor 支持在 `mcp.json` 中使用 `${userHome}` 等变量，例如：
+   ```json
+   "args": [
+     "${userHome}/ai-identity-wallet/memorycode-mcp-server/dist/index.js",
+     "--file",
+     "${userHome}/Desktop/MCP/memorycode-mcp.json"
+   ]
+   ```
+   路径按你本机实际目录调整。
+
+5. **重启 Cursor**  
+   保存 `mcp.json` 后完全退出 Cursor 再打开，使配置生效。
+
+6. **验证与使用**  
+   - 打开 **Settings → Features → Model Context Protocol**，确认 `memorycode` 已列出且为开启状态，并能看到 `load_config`、`list_configs` 及你的配置名（如职场、创作者、学生等）。  
+   - 在对话中用**自然语言**（如「请使用职场配置」「有哪些配置可用」）使用，或直接点选界面中展示的配置按钮。
+
+**排查：** 若连接失败，打开 **Output → MCP Logs**（Cmd+Shift+U 后切换下拉）查看报错；常见原因：路径错误、未先执行 `npm run build`、漏写 `"type": "stdio"`、或将 `memorycode` 写到了 `mcpServers` 外面。
+
+**若出现 "Error - Show Output" / "No server info found"：** 多为 Cursor 与 MCP 的启动竞态。请：① 确认已用最新构建（在 `memorycode-mcp-server` 目录执行 `npm run build`）；② 完全退出 Cursor 后重新打开；③ 确认 `mcp.json` 中 `memorycode` 在 `mcpServers` 内且含 `"type": "stdio"`。若仍报错，可尝试暂时关闭其他 MCP 仅保留 memorycode 再试。
+
+**说明：** 应用内「完整教程」中有更详细的图文步骤，建议一并查看。
+
+### Windsurf（Codeium）
+
+MemoryCode 应用内 MCP Connect 支持为 Windsurf 一键写入配置，配置文件路径为：
+
+- macOS / Linux：`~/.codeium/windsurf/mcp_config.json`
+- Windows：`%USERPROFILE%\.codeium\windsurf\mcp_config.json`
+
+写入内容使用 `command: "npx"`、`args: ["-y", "@memorycode/mcp-server"]`，并通过环境变量 `MEMORYCODE_FILE` 指定本机 `memorycode-mcp.json` 路径（默认 `~/memorycode/memorycode-mcp.json`）。Server 会优先读取该环境变量。
+
+**若出现「MCP server initialization timed out」：**
+
+1. **确认配置文件存在**：先在 MemoryCode 中「导出 MCP 配置」或通过 MCP Connect 导出，确保 `~/memorycode/memorycode-mcp.json`（或你设置的路径）存在。
+2. **首次运行较慢**：`npx -y @memorycode/mcp-server` 第一次会拉取 npm 包，可能超过 60 秒。可在终端先执行一次以预拉取（将 `MEMORYCODE_FILE` 换成你的实际路径）：
+   ```bash
+   MEMORYCODE_FILE=~/memorycode/memorycode-mcp.json npx -y @memorycode/mcp-server
+   ```
+   看到 “MemoryCode MCP Server running” 后按 Ctrl+C 结束，再在 Windsurf 中重新加载 MCP。
+3. **若仍超时：改用本地 node 启动（推荐）**  
+   在项目内构建后，用 `node` 直接运行可执行文件，避免 npx 拉包与网络延迟，启动更快、不易超时。编辑 `~/.codeium/windsurf/mcp_config.json`，将 `memorycode` 一项改为（路径按本机实际修改）：
+   ```json
+   "memorycode": {
+     "name": "memorycode",
+     "command": "/usr/local/bin/node",
+     "args": [
+       "/你的路径/ai-identity-wallet/memorycode-mcp-server/dist/index.js",
+       "--file",
+       "/你的路径/memorycode/memorycode-mcp.json"
+     ]
+   }
+   ```
+   其中 `command` 填本机 node 路径（终端执行 `which node` 可得），`args[0]` 填 `memorycode-mcp-server/dist/index.js` 的绝对路径，`args[2]` 填 `memorycode-mcp.json` 的绝对路径。保存后重启 Windsurf。
+4. **检查路径**：在 Windsurf 的 memorycode 配置页中确认「Configuration File」显示的路径与 MemoryCode 中导出的文件路径一致。
+
+**若 @memorycode 提示「MCP server not found / 服务器名称为空」：** 通常表示该 MCP 未成功启动或未在 Cascade 中正确注册。请先解决「initialization timed out」（按上三步），确保 memorycode 在「Installed MCPs」中为已启用且无报错；配置中已包含 `"name": "memorycode"` 时部分客户端会正确显示 ServerName。若为手动编辑的 `mcp_config.json`，请确保 `mcpServers.memorycode` 存在且含 `command`、`args`、`env`（及可选 `name: "memorycode"`）。
+
+---
+
+## 云盘同步（可选）
+
+若希望多台设备共用同一份配置，或将配置备份到云盘：
+
+1. 将 **`memorycode-mcp.json`** 放在云盘同步目录中（如 iCloud Drive、Dropbox、OneDrive 等）。
+2. 在本机启动 MCP Server 时，用 **`--file`** 指向该同步路径，例如：
+   ```bash
+   node dist/index.js --file "$HOME/Library/Mobile Documents/com~apple~CloudDocs/MemoryCode/memorycode-mcp.json"
+   ```
+3. 在 Claude Desktop / Cursor 的 MCP 配置里，`args` 中填写同一路径。
+
+**注意：** 云盘冲突或同步延迟可能导致文件短暂不可用，若出现「加载 0 个资源」，请检查文件是否已同步完成、路径是否正确。
+
+---
+
+## Windsurf 问题与修复方向（参考）
+
+若后续需重新研究文档或调整实现，可参考以下结论：
+
+**1. 应用内「测试连接」对 Windsurf 无反应**  
+- **原因**：前端 `handleTestConnection` 曾仅允许 `claude` / `cursor`，`toolId === 'windsurf'` 时直接 return，未发请求。  
+- **修复**：已去掉该限制，Windsurf 与 Claude/Cursor 共用同一测试连接逻辑；并增加 15 秒请求超时与 20 秒兜底清除，避免按钮长期处于「测试中…」。
+
+**2. Windsurf 内 MCP「initialization timed out after 60 seconds」**  
+- **原因**：Cascade 用 stdio 启动我们配置的 command（默认 `npx -y @memorycode/mcp-server`）。首次运行 npx 会拉取 npm 包，网络或磁盘慢时易超过 Cascade 的 60 秒等待。  
+- **文档**：Windsurf 官方 [Cascade MCP](https://docs.windsurf.com/windsurf/cascade/mcp) 仅描述 `mcp_config.json` 的 command/args/env 格式，未写超时时间；实际观测为约 60 秒。  
+- **修复方向**：优先推荐用户改用**本地 node + 绝对路径**（见上方「若仍超时：改用本地 node 启动」），避免 npx；或先在终端预运行一次 npx 完成拉包后再在 Windsurf 中启用。后续若官方提供更长超时或「后台预加载」能力，可再对接。
+
+---
+
+## 故障排查
+
+### 1. MCP 开关无法打开 / 看不到 MemoryCode 配置
+
+- **检查**：Claude Desktop 会请求 `tools/list`，Server 必须响应（本实现已支持）。
+- **建议**：确认使用最新构建（`npm run build`），并完全退出后重新打开 Claude Desktop。
+
+### 2. 提示「Loaded 0 resources」
+
+- **原因**：未找到文件，或文件不是 MemoryCode 导出的有效 JSON（需包含 `meta.origin_app === 'MemoryCode'` 且 `mcp.resources` 存在）。
+- **处理**：确认 `--file` 路径正确；在 MemoryCode 中重新「导出到 MCP」并覆盖该文件。
+
+### 3. 自然语言不触发配置加载
+
+- **原因**：需通过 Tool（`load_config`）实现，本 Server 已提供。
+- **处理**：确认 MCP 连接正常（开关为开启状态）；可说「请使用职场配置」「有哪些配置可用」等，由 Claude 调用对应 Tool。
+
+### 4. 第一次打开 Claude 白屏，第二次才正常
+
+- **可能原因**：与 MCP 首次连接或其它扩展有关。
+- **建议**：暂时移除 MemoryCode MCP 配置后重启，若不再白屏，则多为 MCP 启动顺序问题；可保留当前配置，后续启动通常正常。
+
+### 5. 修改 JSON 后列表未更新
+
+- **说明**：Server 会监听文件变化并防抖约 500ms 后重载。
+- **处理**：保存文件后稍等片刻；若仍不更新，可重启 MCP Server 或重启 Claude / Cursor。
+
+### 6. Windsurf 提示「MCP server initialization timed out after 60 seconds」
+
+- **原因**：首次通过 `npx -y @memorycode/mcp-server` 启动时会从 npm 拉包，耗时可能超过 60 秒；或 `MEMORYCODE_FILE` 指向的文件不存在导致启动异常。
+- **处理**：见上方 **Windsurf（Codeium）** 小节：先确保 `memorycode-mcp.json` 已导出并存在；可选在终端预运行一次 `npx -y @memorycode/mcp-server` 完成拉包后再在 Windsurf 中重试。
+
+---
+
+## 使用场景
+
+- **Claude Desktop**：用**自然语言**（如「请使用职场配置」「有哪些配置可用」）由模型调用 Tool 加载；或点击输入框旁 **「+」**，在展开的菜单中选择 MemoryCode 记忆配置加载。@ 在桌面版中对 MCP 无作用。
+- **其他客户端**（如 Cursor）：以该客户端实际支持的引用方式为准（可能包含 @ 或菜单入口）；自然语言在两端均可用。
+- **多配置组合**：不同对话选用不同配置，或在同一对话中先选一个再自然语言切换另一个，按需切换身份/风格。
+- **热更新**：在 MemoryCode 中调整配置后重新导出并覆盖 `memorycode-mcp.json`，Server 会自动重载，无需重启 Claude/Cursor。
+
+---
+
+## 开发
+
+```bash
+npm run build   # 编译到 dist/
+npm run dev     # 监听源码变更并重新编译
+npm start       # 运行 dist/index.js
+npm test        # 集成测试（导出→加载、热更新、错误恢复）
+```
+
+集成测试见 `tests/integration.test.mjs`；Cursor / Claude Desktop 的手动验证步骤见 **`tests/MANUAL.md`**。
+
+---
+
+## 相关链接
+
+- 应用内 **完整教程**：安装、Cursor/Claude 配置、云盘同步、FAQ 等。
+- Resource URI 格式：`memorycode://profile/{id}`。
+
+---
+
+## License
+
+MIT

package/dist/fileWatcher.d.ts

@@ -0,0 +1,22 @@
+/**
+ * YIS-15 Task 2.3: 文件监听与热更新
+ * chokidar 监听单文件，防抖 500ms，解析 meta/mcp.resources，错误保留上次有效状态
+ */
+import type { McpResource } from './types.js';
+export interface FileWatcherOptions {
+    filePath: string;
+    onChange: (resources: McpResource[], payload: unknown) => void;
+    onError: (error: Error) => void;
+}
+export declare class FileWatcher {
+    private options;
+    private lastValidResources;
+    private debounceTimer;
+    private watcher;
+    constructor(options: FileWatcherOptions);
+    private scheduleReload;
+    private loadFile;
+    start(): Promise<void>;
+    stop(): void;
+}
+//# sourceMappingURL=fileWatcher.d.ts.map

package/dist/fileWatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWatcher.d.ts","sourceRoot":"","sources":["../src/fileWatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/D,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,WAAW;IAKV,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,OAAO,CAAkD;gBAE7C,OAAO,EAAE,kBAAkB;IAE/C,OAAO,CAAC,cAAc;YAQR,QAAQ;IAoBhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B5B,IAAI,IAAI,IAAI;CAUb"}

package/dist/fileWatcher.js

@@ -0,0 +1,80 @@
+/**
+ * YIS-15 Task 2.3: 文件监听与热更新
+ * chokidar 监听单文件，防抖 500ms，解析 meta/mcp.resources，错误保留上次有效状态
+ */
+import chokidar from 'chokidar';
+import { readFile } from 'node:fs/promises';
+import { isMemoryCodeExport, parseResources } from './utils/validator.js';
+import { logInfo, logWarn } from './utils/logger.js';
+const DEBOUNCE_MS = 500;
+const INITIAL_LOAD_TIMEOUT_MS = 8000;
+export class FileWatcher {
+    options;
+    lastValidResources = [];
+    debounceTimer = null;
+    watcher = null;
+    constructor(options) {
+        this.options = options;
+    }
+    scheduleReload() {
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        this.debounceTimer = setTimeout(() => {
+            this.debounceTimer = null;
+            this.loadFile().catch(() => { });
+        }, DEBOUNCE_MS);
+    }
+    async loadFile() {
+        const { filePath, onChange, onError } = this.options;
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const data = JSON.parse(content);
+            if (!isMemoryCodeExport(data)) {
+                logWarn(`File is not a MemoryCode export (meta.origin_app): ${filePath}`);
+                return;
+            }
+            const resources = parseResources(data);
+            this.lastValidResources = resources;
+            onChange(resources, data);
+            logInfo(`Loaded ${resources.length} resources from ${filePath}`);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            onError(error);
+            logWarn(`Failed to load ${filePath}, keeping previous ${this.lastValidResources.length} resources`);
+        }
+    }
+    async start() {
+        const { filePath, onChange } = this.options;
+        const loadWithTimeout = () => Promise.race([
+            this.loadFile(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('Initial load timeout')), INITIAL_LOAD_TIMEOUT_MS)),
+        ]).catch((err) => {
+            this.options.onError(err instanceof Error ? err : new Error(String(err)));
+        });
+        await loadWithTimeout();
+        this.watcher = chokidar.watch(filePath, {
+            persistent: true,
+            ignoreInitial: true,
+        });
+        this.watcher.on('add', () => this.scheduleReload());
+        this.watcher.on('change', () => this.scheduleReload());
+        this.watcher.on('unlink', () => {
+            this.lastValidResources = [];
+            onChange([], null);
+            logInfo(`File removed, cleared resources: ${filePath}`);
+        });
+        logInfo(`Watching ${filePath} (debounce ${DEBOUNCE_MS}ms)`);
+    }
+    stop() {
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+            this.debounceTimer = null;
+        }
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+}
+//# sourceMappingURL=fileWatcher.js.map

package/dist/fileWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileWatcher.js","sourceRoot":"","sources":["../src/fileWatcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAQrC,MAAM,OAAO,WAAW;IAKF;IAJZ,kBAAkB,GAAkB,EAAE,CAAC;IACvC,aAAa,GAAyC,IAAI,CAAC;IAC3D,OAAO,GAA6C,IAAI,CAAC;IAEjE,YAAoB,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAAG,CAAC;IAE3C,cAAc;QACpB,IAAI,IAAI,CAAC,aAAa;YAAE,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,CAAC,EAAE,WAAW,CAAC,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,OAAO,CAAC,sDAAsD,QAAQ,EAAE,CAAC,CAAC;gBAC1E,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC1B,OAAO,CAAC,UAAU,SAAS,CAAC,MAAM,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,OAAO,CAAC,kBAAkB,QAAQ,sBAAsB,IAAI,CAAC,kBAAkB,CAAC,MAAM,YAAY,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5C,MAAM,eAAe,GAAG,GAAkB,EAAE,CAC1C,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,CAAC,QAAQ,EAAE;YACf,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC9B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,uBAAuB,CAAC,CACrF;SACF,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACf,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC,CAAC;QACL,MAAM,eAAe,EAAE,CAAC;QAExB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE;YACtC,UAAU,EAAE,IAAI;YAChB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;YAC7B,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;YAC7B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACnB,OAAO,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,YAAY,QAAQ,cAAc,WAAW,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * YIS-15: MemoryCode MCP Server 入口
+ * Task 2.1 项目初始化；Task 2.4 完善 CLI 与配置
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * YIS-15: MemoryCode MCP Server 入口
+ * Task 2.1 项目初始化；Task 2.4 完善 CLI 与配置
+ */
+import path from 'node:path';
+import os from 'node:os';
+import { MemoryCodeMCPServer } from './server.js';
+import { FileWatcher } from './fileWatcher.js';
+import { setLogLevel } from './utils/logger.js';
+const DEFAULT_WATCH_FILE = path.join(os.homedir(), 'memorycode', 'memorycode-mcp.json');
+function printHelp() {
+    const defaultPath = DEFAULT_WATCH_FILE;
+    console.error(`MemoryCode MCP Server
+
+Usage: memorycode-mcp-server [options]
+
+Options:
+  -f, --file <path>   Path to memorycode-mcp.json (default: ${defaultPath})
+  -c, --config <path> Path to JSON config file (watchFile, logLevel)
+  -h, --help          Show this help
+
+Config file example:
+  { "watchFile": "/path/to/memorycode-mcp.json", "logLevel": "info" }
+`);
+}
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let watchFile = null;
+    let configFile = null;
+    let help = false;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--file' || args[i] === '-f') {
+            watchFile = args[i + 1] ?? null;
+            i++;
+        }
+        else if (args[i] === '--config' || args[i] === '-c') {
+            configFile = args[i + 1] ?? null;
+            i++;
+        }
+        else if (args[i] === '--help' || args[i] === '-h') {
+            help = true;
+        }
+    }
+    return { watchFile, configFile, help };
+}
+function resolveWatchPath(raw) {
+    if (raw.startsWith('~/') || raw === '~') {
+        return path.join(os.homedir(), raw === '~' ? '' : raw.slice(2));
+    }
+    if (raw.startsWith('~' + path.sep)) {
+        return path.join(os.homedir(), raw.slice(2));
+    }
+    return raw;
+}
+async function loadConfig() {
+    const { watchFile, configFile } = parseArgs();
+    const envFile = process.env.MEMORYCODE_FILE?.trim();
+    const rawWatchFile = watchFile ?? (envFile && envFile.length > 0 ? envFile : null) ?? DEFAULT_WATCH_FILE;
+    const resolvedWatchFile = resolveWatchPath(rawWatchFile);
+    let config = {
+        watchFile: resolvedWatchFile,
+        logLevel: 'info',
+    };
+    if (configFile) {
+        try {
+            const fs = await import('node:fs/promises');
+            const content = await fs.readFile(configFile, 'utf-8');
+            const parsed = JSON.parse(content);
+            if (parsed.watchFile != null && watchFile === null)
+                config.watchFile = resolveWatchPath(String(parsed.watchFile));
+            if (parsed.logLevel)
+                config.logLevel = parsed.logLevel;
+        }
+        catch (err) {
+            console.error('Failed to load config file:', err);
+        }
+    }
+    return config;
+}
+async function main() {
+    if (parseArgs().help) {
+        printHelp();
+        process.exit(0);
+    }
+    const config = await loadConfig();
+    setLogLevel(config.logLevel);
+    const server = new MemoryCodeMCPServer();
+    const watcher = new FileWatcher({
+        filePath: config.watchFile,
+        onChange: (resources, payload) => server.updateMemorySnapshot(resources, payload),
+        onError: (err) => console.error('FileWatcher error:', err),
+    });
+    // 先连接 stdio 再启动 watcher，让 Cursor 等客户端尽快收到 initialize 响应，减少 "No server info found" 竞态
+    await server.run();
+    await watcher.start();
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,25 @@
+/**
+ * YIS-15 Task 2.2 / YIS-20 / YIS-21: MCP Server 实现
+ * YIS-22: 添加 load_config、list_configs Tool，支持自然语言唤起配置切换
+ */
+import type { McpResource } from './types.js';
+export declare class MemoryCodeMCPServer {
+    private resources;
+    private memorySnapshot;
+    private server;
+    private transport;
+    constructor();
+    updateMemorySnapshot(resources: McpResource[], payload: unknown): void;
+    private getUserProfile;
+    private getExpertise;
+    private getActiveProfile;
+    private asRecord;
+    private toSafeString;
+    private toSafeStringArray;
+    private toDepthValue;
+    private mapDepth;
+    private findResourceByConfigName;
+    private normalizeConfigName;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA6E9C,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqC;;IAoItD,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAQtE,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,wBAAwB;IAUhC,OAAO,CAAC,mBAAmB;IAOrB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAK3B"}

package/dist/server.js

@@ -0,0 +1,277 @@
+/**
+ * YIS-15 Task 2.2 / YIS-20 / YIS-21: MCP Server 实现
+ * YIS-22: 添加 load_config、list_configs Tool，支持自然语言唤起配置切换
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ListToolsRequestSchema, CallToolRequestSchema, ReadResourceRequestSchema, McpError, ErrorCode, } from '@modelcontextprotocol/sdk/types.js';
+import { logInfo, logWarn } from './utils/logger.js';
+const RESOURCE_URI_PREFIX = 'memorycode://profile/';
+const MIME_TYPE = 'text/markdown';
+const TOOLS = [
+    {
+        name: 'load_config',
+        description: '加载指定的 MemoryCode 记忆配置，使后续回复使用该身份/风格。用户说「请使用职场配置」「切换到学生模式」等时调用。',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                config_name: {
+                    type: 'string',
+                    description: '要加载的配置名称，如：空白、职场、创作者、自由职业、学生（以当前可用列表为准）',
+                },
+            },
+            required: ['config_name'],
+        },
+    },
+    {
+        name: 'list_configs',
+        description: '列出当前可用的所有 MemoryCode 记忆配置名称，供用户选择或确认。',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_user_profile',
+        description: 'Get current user identity profile from MemoryCode (nickname, roles, about). Use this when personalization needs user background.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'get_expertise',
+        description: 'Get current user expertise from MemoryCode. Optional domain filters skills by case-insensitive substring match.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                domain: {
+                    type: 'string',
+                    description: 'Optional domain keyword, e.g. frontend, design.',
+                },
+            },
+        },
+    },
+];
+export class MemoryCodeMCPServer {
+    resources = [];
+    memorySnapshot = null;
+    server;
+    transport = null;
+    constructor() {
+        this.server = new Server({
+            name: 'memorycode',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                resources: {
+                    listChanged: true,
+                    subscribe: true,
+                },
+                tools: { listChanged: true },
+            },
+            /** Cursor 等客户端通过 GetInstructions/initialize 获取此说明，避免 "No server info found" 类问题 */
+            instructions: [
+                'MemoryCode MCP: 提供记忆配置供 AI 使用。',
+                'Resources: 通过 @ 或资源列表加载 memorycode://profile/<id> 获取某配置的完整 prompt。',
+                'Tools: list_configs 列出可用配置；load_config 加载指定配置名称（如「职场」「创作者」）使后续回复使用该身份。',
+                'Tools: get_user_profile 返回当前身份信息；get_expertise 支持按 domain 过滤技能深度。',
+            ].join(' '),
+        });
+        this.server.setRequestHandler(ListToolsRequestSchema, () => ({
+            tools: TOOLS.map((t) => ({ name: t.name, description: t.description, inputSchema: t.inputSchema })),
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, (request) => {
+            const { name, arguments: args } = request.params;
+            if (name === 'load_config') {
+                const configName = typeof args?.config_name === 'string' ? args.config_name.trim() : '';
+                if (!configName) {
+                    return {
+                        content: [{ type: 'text', text: '请提供 config_name 参数，例如：职场、创作者、学生。' }],
+                        isError: true,
+                    };
+                }
+                const resource = this.findResourceByConfigName(configName);
+                if (!resource) {
+                    const names = this.resources.map((r) => r.name).join('、') || '（暂无）';
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `未找到配置「${configName}」。当前可用：${names}`,
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `已加载配置：${resource.name}\n\n${resource.prompt}`,
+                        },
+                    ],
+                };
+            }
+            if (name === 'list_configs') {
+                const names = this.resources.map((r) => r.name);
+                const text = names.length > 0
+                    ? `当前可用配置：\n${names.map((c) => `- ${c}`).join('\n')}`
+                    : '当前暂无可用配置，请先在 MemoryCode 中导出 memorycode-mcp.json 并放在 MCP 监听的路径。';
+                return {
+                    content: [{ type: 'text', text }],
+                };
+            }
+            if (name === 'get_user_profile') {
+                const result = this.getUserProfile();
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            if (name === 'get_expertise') {
+                const domain = typeof args?.domain === 'string' ? args.domain : undefined;
+                const result = this.getExpertise(domain);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            throw new McpError(ErrorCode.InvalidParams, `Unknown tool: ${name}`);
+        });
+        this.server.setRequestHandler(ListResourcesRequestSchema, (_request) => {
+            const resources = this.resources.map((r) => {
+                const desc = r.description || r.name;
+                const description = desc.startsWith('Memory - ') ? desc : `Memory - ${desc}`;
+                return {
+                    uri: RESOURCE_URI_PREFIX + encodeURIComponent(r.id),
+                    name: r.name,
+                    description,
+                    mimeType: MIME_TYPE,
+                };
+            });
+            return { resources };
+        });
+        this.server.setRequestHandler(ListResourceTemplatesRequestSchema, () => {
+            return { resourceTemplates: [] };
+        });
+        this.server.setRequestHandler(ReadResourceRequestSchema, (request) => {
+            const uri = request.params.uri;
+            if (!uri.startsWith(RESOURCE_URI_PREFIX)) {
+                throw new McpError(ErrorCode.InvalidParams, `Invalid resource URI: ${uri}`);
+            }
+            const id = decodeURIComponent(uri.slice(RESOURCE_URI_PREFIX.length));
+            const resource = this.resources.find((r) => r.id === id);
+            if (!resource) {
+                throw new McpError(ErrorCode.InvalidParams, `Resource not found: ${uri}`);
+            }
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: MIME_TYPE,
+                        text: resource.prompt,
+                    },
+                ],
+            };
+        });
+        logInfo('[MemoryCode] MCP Server initialized, capabilities: resources (listChanged, subscribe), tools (load_config, list_configs, get_user_profile, get_expertise)');
+    }
+    updateMemorySnapshot(resources, payload) {
+        this.resources = resources;
+        this.memorySnapshot = payload;
+        this.server.sendResourceListChanged().catch((err) => {
+            logWarn(`Failed to send resources/list_changed: ${err}`);
+        });
+    }
+    getUserProfile() {
+        const profile = this.getActiveProfile();
+        return {
+            nickname: this.toSafeString(profile?.nickname),
+            roles: this.toSafeStringArray(profile?.roles),
+            about: this.toSafeString(profile?.role),
+            source: 'memorycode-local',
+            schema_version: '1.0',
+        };
+    }
+    getExpertise(domainRaw) {
+        const profile = this.getActiveProfile();
+        const domain = typeof domainRaw === 'string' ? domainRaw.trim().toLowerCase() : '';
+        const skills = Array.isArray(profile?.skills) ? profile.skills : [];
+        const expertise = skills
+            .map((item) => {
+            const skill = this.toSafeString(item?.name);
+            const depthValue = this.toDepthValue(item?.depth);
+            if (!skill)
+                return null;
+            if (domain && !skill.toLowerCase().includes(domain))
+                return null;
+            const depth = this.mapDepth(depthValue);
+            return {
+                skill,
+                depth,
+                depthLabel: depth,
+            };
+        })
+            .filter((item) => item !== null);
+        return {
+            expertise,
+            total: expertise.length,
+            source: 'memorycode-local',
+        };
+    }
+    getActiveProfile() {
+        if (!this.memorySnapshot || typeof this.memorySnapshot !== 'object')
+            return null;
+        const root = this.memorySnapshot;
+        const data = this.asRecord(root.data);
+        const state = this.asRecord(data?.state);
+        const profiles = Array.isArray(state?.profiles) ? state?.profiles : [];
+        const activeProfileId = this.toSafeString(state?.activeProfileId);
+        if (!activeProfileId)
+            return null;
+        const profile = profiles.find((item) => this.toSafeString(this.asRecord(item)?.id) === activeProfileId);
+        return this.asRecord(profile);
+    }
+    asRecord(v) {
+        return v && typeof v === 'object' ? v : null;
+    }
+    toSafeString(v) {
+        return typeof v === 'string' ? v : '';
+    }
+    toSafeStringArray(v) {
+        if (!Array.isArray(v))
+            return [];
+        return v.filter((item) => typeof item === 'string');
+    }
+    toDepthValue(v) {
+        return v === 2 || v === 3 ? v : 1;
+    }
+    mapDepth(depth) {
+        if (depth === 3)
+            return 'expert';
+        if (depth === 2)
+            return 'proficient';
+        return 'familiar';
+    }
+    findResourceByConfigName(configName) {
+        const directMatch = this.resources.find((r) => r.name === configName || r.name.trim() === configName);
+        if (directMatch)
+            return directMatch;
+        // 容错匹配：允许用户输入去掉 emoji/符号后的名称（如「职场」匹配「💼 职场」）
+        const normalizedInput = this.normalizeConfigName(configName);
+        if (!normalizedInput)
+            return undefined;
+        return this.resources.find((r) => this.normalizeConfigName(r.name) === normalizedInput);
+    }
+    normalizeConfigName(name) {
+        return name
+            .trim()
+            .toLowerCase()
+            .replace(/[^\p{L}\p{N}\p{Script=Han}]+/gu, '');
+    }
+    async run() {
+        this.transport = new StdioServerTransport();
+        await this.server.connect(this.transport);
+        logInfo('MemoryCode MCP Server running (stdio)');
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * YIS-15: MCP Server 类型定义
+ * 与 Web 端导出的 mcp.resources[] 结构一致
+ */
+export interface McpResource {
+    id: string;
+    name: string;
+    description: string;
+    prompt: string;
+}
+export interface MemoryCodeExportJson {
+    meta?: {
+        origin_app?: string;
+        schema_version?: string;
+    };
+    mcp?: {
+        schema_version?: string;
+        default_model?: string;
+        resources?: McpResourceRaw[];
+    };
+}
+export interface McpResourceRaw {
+    id?: string;
+    name?: string;
+    description?: string;
+    prompt?: string;
+}
+export interface Config {
+    watchFile: string;
+    logLevel: 'info' | 'warn' | 'error';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE;QACL,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * YIS-15: MCP Server 类型定义
+ * 与 Web 端导出的 mcp.resources[] 结构一致
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * YIS-15: 简单日志工具，输出到 stderr
+ */
+export type LogLevel = 'info' | 'warn' | 'error';
+export declare function setLogLevel(level: LogLevel): void;
+export declare function getLogLevel(): LogLevel;
+export declare function logInfo(message: string): void;
+export declare function logWarn(message: string): void;
+export declare function logError(message: string, err?: unknown): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAIjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAuBD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,CAO7D"}

package/dist/utils/logger.js

@@ -0,0 +1,47 @@
+/**
+ * YIS-15: 简单日志工具，输出到 stderr
+ */
+let currentLevel = 'info';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+export function getLogLevel() {
+    return currentLevel;
+}
+function levelPriority(level) {
+    switch (level) {
+        case 'error':
+            return 3;
+        case 'warn':
+            return 2;
+        case 'info':
+        default:
+            return 1;
+    }
+}
+function shouldLog(level) {
+    return levelPriority(level) >= levelPriority(currentLevel);
+}
+function format(level, message) {
+    const ts = new Date().toISOString();
+    return `[${ts}] ${message}`;
+}
+export function logInfo(message) {
+    if (shouldLog('info')) {
+        console.error(format('info', message));
+    }
+}
+export function logWarn(message) {
+    if (shouldLog('warn')) {
+        console.error(format('warn', message));
+    }
+}
+export function logError(message, err) {
+    if (shouldLog('error')) {
+        console.error(format('error', message));
+        if (err !== undefined) {
+            console.error(err);
+        }
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CAAC,KAAe;IACpC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,CAAC,CAAC;QACX,KAAK,MAAM;YACT,OAAO,CAAC,CAAC;QACX,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,aAAa,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,OAAe;IAC5C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,GAAa;IACrD,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/validator.d.ts

@@ -0,0 +1,8 @@
+/**
+ * YIS-15: JSON 校验与 mcp.resources 解析
+ * PRD 6.4: meta.origin_app 不匹配则忽略；超长 prompt 跳过
+ */
+import type { McpResource, MemoryCodeExportJson } from '../types.js';
+export declare function isMemoryCodeExport(data: unknown): data is MemoryCodeExportJson;
+export declare function parseResources(data: MemoryCodeExportJson): McpResource[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/utils/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAkB,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,oBAAoB,CAK9E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,oBAAoB,GAAG,WAAW,EAAE,CAyBxE"}

package/dist/utils/validator.js

@@ -0,0 +1,38 @@
+/**
+ * YIS-15: JSON 校验与 mcp.resources 解析
+ * PRD 6.4: meta.origin_app 不匹配则忽略；超长 prompt 跳过
+ */
+import { logWarn } from './logger.js';
+const MAX_PROMPT_LENGTH = 10_000;
+const ORIGIN_APP = 'MemoryCode';
+export function isMemoryCodeExport(data) {
+    if (!data || typeof data !== 'object')
+        return false;
+    const obj = data;
+    const meta = obj.meta;
+    return meta?.origin_app === ORIGIN_APP;
+}
+export function parseResources(data) {
+    const rawList = data.mcp?.resources;
+    if (!Array.isArray(rawList))
+        return [];
+    const result = [];
+    for (const r of rawList) {
+        const item = r;
+        if (!item?.id || typeof item.name !== 'string')
+            continue;
+        const prompt = typeof item.prompt === 'string' ? item.prompt : '';
+        if (prompt.length > MAX_PROMPT_LENGTH) {
+            logWarn(`Profile "${item.name}" prompt too long (${prompt.length} chars), skipped`);
+            continue;
+        }
+        result.push({
+            id: String(item.id),
+            name: String(item.name),
+            description: typeof item.description === 'string' ? item.description : '',
+            prompt,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=validator.js.map

package/dist/utils/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/utils/validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AACjC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,UAAU,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,IAA2C,CAAC;IAC7D,OAAO,IAAI,EAAE,UAAU,KAAK,UAAU,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAA0B;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAmB,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QAEzD,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAI,MAAM,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;YACtC,OAAO,CAAC,YAAY,IAAI,CAAC,IAAI,sBAAsB,MAAM,CAAC,MAAM,kBAAkB,CAAC,CAAC;YACpF,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;YACvB,WAAW,EAAE,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;YACzE,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@memorycode/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for MemoryCode - Use your memory configs in Claude Desktop/Cursor",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "memorycode-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "node --test tests/integration.test.mjs",
+    "test:integration": "npm run build && node --test tests/integration.test.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "chokidar": "^3.5.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": ["mcp", "memorycode", "cursor", "claude", "model-context-protocol"],
+  "license": "MIT"
+}