@memorycode/mcp-server 是什么？
这是通过 npx 启动的 npm 包。它以 stdio 方式实现 MCP 协议，从磁盘读取你导出的 memorycode-mcp.json，并向宿主应用暴露工具（含 get_user_profile、get_expertise）与资源。常规使用无需克隆仓库。
导出的文件是什么？
点击「导出配置」后得到的 memorycode-mcp.json 包含当前所有记忆档案的配置（名称、描述与生成好的 Prompt）。MCP Server 会读取该文件，在 AI 对话中通过 Resources / Tools 暴露给客户端。你只需在目标 AI 应用中配置「用哪个程序、读哪个文件」即可。
开始前准备
本机需安装 Node.js 18+（包含 npx）。各平台 MCP 配置现已统一走 npx 启动，不再要求你手动填写本地 dist/index.js 绝对路径。 npx 会从 npm 拉取 `@memorycode/mcp-server`（文档约定最低可用版本：1.0.0，已含 get_user_profile / get_expertise）。若客户端报 404 或工具缺失，可在终端执行 `npm view @memorycode/mcp-server version`，应能看到 1.0.0 或更高。
第一步：导出并保存 JSON
在 MemoryCode 的 MCP 面板中点击「导出配置」，将 memorycode-mcp.json 保存到本机固定位置（例如 ~/memorycode/ 或 ~/Desktop/MCP/）。记住该路径，后续在 AI 应用中会用到。
第二步：在目标 AI 应用中添加 MCP 服务器
先选择你的操作系统，再在下文找到你使用的 AI 应用，按步骤编辑其 MCP 配置文件，添加名为 memorycode 的服务器，并填入：① command = npx；② args 包含 -y @memorycode/mcp-server；③ --file 指向你导出的 memorycode-mcp.json 路径。保存后重启该 AI 应用即可。
若 npx 不可用，请安装或升级 Node.js 到 18+。
你的系统
切换后，下方配置文件路径与复制按钮会随系统变化。
OpenClaw（通过 MCP / mcporter）
最新适配MemoryCode 通过 MCP 与 OpenClaw 集成。请按 MCP Server 方式接入，不走 Skill 包。
Step 0 — 确保本机已有 memorycode-mcp.json
在进行平台配置前，请先确保本机已有 memorycode-mcp.json 文件。
推荐路径： 推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Step 1 — 找到该平台的 MCP 配置文件
先打开下方 Typical config path 对应的配置文件（不同安装路径可能略有差异）。
MCP 配置路径（常见，macOS）：~/.config/openclaw/mcp.json
Finder > Command (⌘) + Shift (⇧) + G > 粘贴 > 回车
Step 2 — 写入下方 JSON 并重启应用
将下方配置块加入该平台的 MCP 配置文件，保存后完全重启应用。
本操作仅在浏览器本地完成，不会上传你的 JSON
不想粘贴全文？展开查看手动示例
最小可用完整 JSON（适用于文件几乎空 / 第一次配置）
{"mcpServers": {"memorycode": {"type": "stdio","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}}}
不需要本地 server 绝对路径。保持示例中的 command/args 不变，只需确认 --file 路径与你保存的 memorycode-mcp.json 一致。
注意：OpenClaw 的 Skill 包（SKILL.md）与 MCP Server 是两条不同接入路径。
1. 确保 MemoryCode 正在运行，且 memorycode-mcp.json 已保存到本地磁盘。 2. 打开 OpenClaw 的 MCP 设置（mcporter 或内建 MCP bridge）。 3. 按下方 stdio 配置新增 memorycode MCP 服务器。 4. 确认可发现 get_user_profile 与 get_expertise 工具。
Claude Desktop
Step 0 — 确保本机已有 memorycode-mcp.json
在进行平台配置前，请先确保本机已有 memorycode-mcp.json 文件。
推荐路径： 推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Step 1 — 找到该平台的 MCP 配置文件
先打开下方 Typical config path 对应的配置文件（不同安装路径可能略有差异）。
配置文件路径：~/Library/Application Support/Claude/claude_desktop_config.json
Finder > Command (⌘) + Shift (⇧) + G > 粘贴 > 回车
Step 2 — 写入下方 JSON 并重启应用
将下方配置块加入该平台的 MCP 配置文件，保存后完全重启应用。
本操作仅在浏览器本地完成，不会上传你的 JSON
不想粘贴全文？展开查看手动示例
合并片段（适用于文件里已有其他 MCP）
"memorycode": {"name": "memorycode","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}
插入位置：找到 mcpServers，把这段作为一个新条目粘到 mcpServers 对象内部，放在最后一个 MCP 条目之后、紧挨着 mcpServers 的 } 之前；注意前后逗号。
最小可用完整 JSON（适用于文件几乎空 / 第一次配置）
{"mcpServers": {"memorycode": {"name": "memorycode","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}}}
不需要本地 server 绝对路径。保持示例中的 command/args 不变，只需确认 --file 路径与你保存的 memorycode-mcp.json 一致。
说明：该链接主要介绍 Claude Code（命令行）通过 JSON 添加 MCP。若你使用 Claude Desktop 应用，请使用上方「配置文件路径」编辑 claude_desktop_config.json，在 mcpServers 中加入与本页下方片段一致的条目。
其他支持 MCP 的 Agent
只要你的 Agent 支持 MCP，都可以用同一套 stdio 配置接入 MemoryCode。
Step 0 — 确保本机已有 memorycode-mcp.json
在进行平台配置前，请先确保本机已有 memorycode-mcp.json 文件。
推荐路径： 推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Step 1 — 找到该平台的 MCP 配置文件
在目标 Agent 的设置或帮助文档中找到 MCP 配置文件位置，然后准备加入 memorycode 服务器配置块。
1. 打开目标 Agent 的 MCP 服务器设置。 2. 新增名为 memorycode 的服务器。 3. 使用 npx 参数：-y @memorycode/mcp-server --file [你的 memorycode-mcp.json 路径]。 4. 重启 Agent 后确认 tools/resources 可见。
Step 2 — 写入下方 JSON 并重启应用
将下方配置块加入该平台的 MCP 配置文件，保存后完全重启应用。
本操作仅在浏览器本地完成，不会上传你的 JSON
不想粘贴全文？展开查看手动示例
最小可用完整 JSON（适用于文件几乎空 / 第一次配置）
{"mcpServers": {"memorycode": {"type": "stdio","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}}}
不需要本地 server 绝对路径。保持示例中的 command/args 不变，只需确认 --file 路径与你保存的 memorycode-mcp.json 一致。
Cursor
Step 0 — 确保本机已有 memorycode-mcp.json
在进行平台配置前，请先确保本机已有 memorycode-mcp.json 文件。
推荐路径： 推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Step 1 — 找到该平台的 MCP 配置文件
先打开下方 Typical config path 对应的配置文件（不同安装路径可能略有差异）。
配置文件路径：~/.cursor/mcp.json（全局）或项目根目录 .cursor/mcp.json
Finder > Command (⌘) + Shift (⇧) + G > 粘贴 > 回车
Step 2 — 写入下方 JSON 并重启应用
将下方配置块加入该平台的 MCP 配置文件，保存后完全重启应用。
本操作仅在浏览器本地完成，不会上传你的 JSON
不想粘贴全文？展开查看手动示例
最小可用完整 JSON（适用于文件几乎空 / 第一次配置）
{"mcpServers": {"memorycode": {"type": "stdio","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}}}
不需要本地 server 绝对路径。保持示例中的 command/args 不变，只需确认 --file 路径与你保存的 memorycode-mcp.json 一致。
Cursor 要求 STDIO 服务器必须包含 "type": "stdio"，且 memorycode 必须写在 mcpServers 对象内部。
Windsurf（Codeium）
Step 0 — 确保本机已有 memorycode-mcp.json
在进行平台配置前，请先确保本机已有 memorycode-mcp.json 文件。
推荐路径： 推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Step 1 — 找到该平台的 MCP 配置文件
先打开下方 Typical config path 对应的配置文件（不同安装路径可能略有差异）。
配置文件路径：~/.codeium/windsurf/mcp_config.json
Finder > Command (⌘) + Shift (⇧) + G > 粘贴 > 回车
Step 2 — 写入下方 JSON 并重启应用
将下方配置块加入该平台的 MCP 配置文件，保存后完全重启应用。
本操作仅在浏览器本地完成，不会上传你的 JSON
不想粘贴全文？展开查看手动示例
合并片段（适用于文件里已有其他 MCP）
"memorycode": {"name": "memorycode","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}
插入位置：找到 mcpServers，把这段作为一个新条目粘到 mcpServers 对象内部，放在最后一个 MCP 条目之后、紧挨着 mcpServers 的 } 之前；注意前后逗号。
最小可用完整 JSON（适用于文件几乎空 / 第一次配置）
{"mcpServers": {"memorycode": {"name": "memorycode","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}}}
不需要本地 server 绝对路径。保持示例中的 command/args 不变，只需确认 --file 路径与你保存的 memorycode-mcp.json 一致。
首次使用 npx 可能因下载包而稍慢。若持续超时，请先检查网络或 npm 源连通性。
LM Studio
在 LM Studio 中通过 Program → Install → Edit mcp.json（或应用内等价入口）打开 MCP 配置文件，将 memorycode 服务器加入 mcpServers，保存后重启或刷新 MCP。
Step 0 — 确保本机已有 memorycode-mcp.json
在进行平台配置前，请先确保本机已有 memorycode-mcp.json 文件。
推荐路径： 推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Step 1 — 找到该平台的 MCP 配置文件
先打开下方 Typical config path 对应的配置文件（不同安装路径可能略有差异）。
配置文件路径（常见）：~/.lmstudio/mcp.json
Finder > Command (⌘) + Shift (⇧) + G > 粘贴 > 回车
Step 2 — 写入下方 JSON 并重启应用
将下方配置块加入该平台的 MCP 配置文件，保存后完全重启应用。
本操作仅在浏览器本地完成，不会上传你的 JSON
不想粘贴全文？展开查看手动示例
最小可用完整 JSON（适用于文件几乎空 / 第一次配置）
{"mcpServers": {"memorycode": {"type": "stdio","command": "npx","args": ["-y","@memorycode/mcp-server","--file","~/memorycode/memorycode-mcp.json"]}}}
不需要本地 server 绝对路径。保持示例中的 command/args 不变，只需确认 --file 路径与你保存的 memorycode-mcp.json 一致。
若界面版本不同，请在设置或帮助中搜索「MCP」或「mcp.json」找到编辑入口。
手动配置：仅导出 memorycode-mcp.json
适用于在 MemoryCode 中通过「导出配置」得到 JSON 后，自行放置到固定目录，并用 memorycode-mcp-server 在任意支持 MCP 的客户端中指向该文件（与下方各 AI 的「应用内配置」路径不同，本块只讲「记忆文件」放哪）。
1. 在 MemoryCode 的 MCP 面板或底部「手动配置」中导出 memorycode-mcp.json。 2. 将文件保存到下方「推荐路径」（可与 App 默认 ~/memorycode 一致）。 3. 在 MCP 配置里将 --file 参数指向该文件的绝对路径；若使用各 AI 应用内的配置文件，请再对照下方 Claude / Cursor 等区块。
推荐保存位置（macOS）：~/memorycode/memorycode-mcp.json
Finder > Command (⌘) + Shift (⇧) + G > 粘贴 > 回车
若你使用其他目录，请保证路径与 MCP 配置中 --file 参数完全一致。从 MCP 面板底部「文档」进入时，会滚动定位到本区块（在各 AI 指引之后）。
常见问题
连接失败时优先对照报错：① MODULE_NOT_FOUND：通常是入口路径错误或占位符未替换；② NPX_NOT_FOUND：需安装/升级 Node.js 18+；③ MEMORY_FILE_NOT_FOUND：--file 路径与实际保存位置不一致。然后再完全退出并重开 AI 应用。
路径与 tilde（~）
示例中的 ~ 表示你的用户主目录。若某应用要求「绝对路径」，请在终端或资源管理器中将 ~/… 展开为完整路径后再填入。
Node、npx 与 fallback
请使用 Node.js 18+（包含 npx）。若在受限网络/离线环境下启动失败，可切换高级 fallback：改用本地 node + 本地 dist/index.js 绝对路径，不走 npx。