前置说明

1. MemPalace 依靠 MCP（Model Context Protocol）Stdio 服务 给 Codex-App 提供工具调用能力；

2. Codex-App 原生支持读取 config.toml 注册外部 MCP 服务；

3. 两种使用场景通用：代码项目记忆 / 人脑记忆宫殿训练素材库。

一、环境前置准备

1. 安装 MemPalace
# 全局安装
pip install mempalace
验证 MCP 服务能否正常拉起：
python -m mempalace.mcp_server
终端出现 MCP 初始化日志即正常，按 Ctrl+C 关闭。

2. 初始化你的 MemPalace 仓库

二选一执行：

场景A：代码项目记忆（当前项目目录）
cd /你的项目文件夹
mempalace init .
场景B：人脑记忆训练专用独立库
# Mac/Linux
mempalace init ~/mem_training_palace
# Windows CMD/PowerShell
mempalace init %USERPROFILE%\mem_training_palace
二、找到 Codex-App 配置文件

全局配置（所有项目共用一套记忆库，推荐训练记忆）

• Mac/Linux：~/.codex/config.toml

• Windows：C:\Users\你的用户名\.codex\config.toml

项目局部配置（仅当前项目生效，适合开发）

在项目根目录新建文件：.codex.toml

三、写入 Mempalace MCP 配置（完整模板）

打开上面的 config.toml，粘贴下方配置，修改两处路径：

1. command：你的 Python3 绝对路径（避免找不到python）

2. env.MEMPALACE_ROOT：你刚刚初始化的记忆库路径

完整配置模板
# MemPalace MCP 服务配置
[mcp_servers.mempalace]
# 替换为你本机python3完整路径
command = "/usr/bin/python3"
# Windows示例 command = "C:\\Python311\\python.exe"
args = ["-m", "mempalace.mcp_server"]
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 120

# 指定记忆宫殿仓库根目录
[env]
MEMPALACE_ROOT = "/Users/xxx/mem_training_palace"
# Windows示例 MEMPALACE_ROOT = "C:\\Users\\xxx\\mem_training_palace"
如何获取本机 Python 绝对路径

• Mac/Linux 终端输入：which python3

• Windows PowerShell：Get-Command python | Select-Object Source

四、重启 Codex-App 并验证集成

1. 完全退出 Codex-App，重新打开；

2. 在 Codex 对话输入框执行 MCP 列表命令：
/mcp list
成功标识

输出列表中出现 mempalace，并展示可用工具：
wing_create、room_create、search、edit、tag_add、mine 等。

简易功能测试指令（直接发给Codex）
列出当前记忆库所有翼楼名称
Codex 会自动调用 mempalace 工具读取并输出，代表集成成功。

五、常用配套优化配置（可选追加到config）

1. 对话自动存入记忆宫殿
[mcp_servers.mempalace.hooks]
auto_save = true
save_rounds = 10
default_wing = "codex对话存档"
auto_tag_time = true
每10轮对话自动把上下文存入指定翼楼，自动打上日期标签。

2. 中文优化（记忆训练专用）
[env]
MEMPALACE_ROOT = "你的库路径"
MEMPALACE_LANG = "zh"
EMBEDDING_MODEL = "all-MiniLM-L6-v2-zh"
提升中文知识点、地点桩的检索精准度。

六、常见报错修复

问题1：启动提示 python not found

解决：command 不要写简写 python，使用复制出来的完整绝对路径。

问题2：MEMPALACE_ROOT 路径报错

1. Windows 路径使用双反斜杠 C:\\xxx\\xxx；

2. 路径不要包含中文、空格；

3. 确认文件夹是执行 mempalace init 生成的仓库。

问题3：/mcp list 看不到 mempalace

1. 检查 [mcp_servers.mempalace] 层级缩进是否正确（toml缩进不能用Tab，只用空格）；

2. 删除 Codex 缓存目录后重启 App；

3. 确认已全局安装 mempalace，不是仅虚拟环境安装。

问题4：调用工具超时

增大 tool_timeout_sec = 180，低配电脑检索大量素材会慢。

七、区分两种使用方式示例

1）人脑记忆训练场景指令示例
在记忆库创建翼楼「居家记忆宫殿」，新增玄关、客厅、厨房房间，录入15个地点桩并保存桩位描述
2）代码开发记忆场景指令示例
把本次用户登录接口设计方案存入翼楼「后端项目」-房间「鉴权模块」，方便后续检索