Read My ChatGPT

把你自己的 ChatGPT Web 会话历史，以只读 MCP tools 提供给本机多个 AI 客户端。每个客户端只启动一个轻量 stdio connector；第一次调用 tool 时， connector 才按需启动一个共享 daemon 和一个 Obscura 浏览器进程。最后一次 tool 调用完成后 10 分钟没有新调用，daemon 会自动退出。

一次初始化

要求 Node.js 22 或更高版本。初始化和内置 Obscura 支持：

Windows、Alpine/musl 暂不支持 init；仍可自行提供兼容的 Obscura 并使用 传统 stdio 模式。

npx -y read-my-chatgpt@latest init

init 会：

1. 隐藏输入你的 ChatGPT Web access token；

2. 从 Obscura 官方 GitHub Release 下载固定版本 v0.1.10，并校验 SHA-256；

3. 生成本机 MCP Bearer token，写入权限为 0600 的配置文件；

4. 停止并删除旧版本遗留的 launchd / systemd user 常驻服务；

5. 自动配置检测到的 Codex、Claude Code、Cursor、Gemini CLI、Grok CLI、 OpenCode 和 Pi，让它们执行固定版本的 npx -y read-my-chatgpt@<version> connect。

首次运行会先要求确认风险。自动化安装需同时显式设置环境变量并确认：

READ_MY_CHATGPT_ACCESS_TOKEN='…' \
  npx -y read-my-chatgpt@latest init --yes

完成后重启一次 AI 客户端。MCP 初始化和 tools/list 只经过 connector， 不会启动 daemon 或 Obscura。第一次 tools/call 才会启动共享 runtime； 同一台电脑上的多个客户端会复用它。daemon 只监听 loopback，不会暴露到局域网 或公网。

Related MCP server: agentify-desktop

从旧包迁移

如果本机安装过 conversation-reader-mcp：

npx -y read-my-chatgpt@latest init --yes
npm uninstall -g conversation-reader-mcp

init 会停止旧后台服务，把原有 token、Obscura、浏览器 profile 和日志迁移到 read-my-chatgpt 路径，并把 AI 客户端中的 conversation-reader 条目替换为 read-my-chatgpt。正常迁移不需要重新输入 token。

从曾经使用常驻 HTTP 架构的 read-my-chatgpt 升级时，也只需重新运行 init：它会卸载本项目旧的 launchd / systemd 服务，并把客户端切换为按需 connector。

获取 access token

1. 登录 chatgpt.com；

2. 打开开发者工具的 Network；

3. 找到任意 /backend-api/* 请求；

4. 复制 Authorization: Bearer … 中 Bearer 后面的内容。

token 会过期。失效后重新运行 npx -y read-my-chatgpt@latest init 输入新 token；本机配置和客户端 connector 版本会一起更新。

不要把 token 提交到 Git、Issue、日志或聊天消息中。

输出时区

MCP 默认以 UTC 输出 RFC 3339 时间，以保持现有调用兼容。若希望 AI 直接使用 本地时间，可设置 IANA 时区并重新运行 init：

READ_MY_CHATGPT_OUTPUT_TIMEZONE=Asia/Shanghai \
  npx -y read-my-chatgpt@latest init --yes

已有安装会复用原来的 access token；后续再次运行 init 也会保留这个配置。 源码或 stdio 模式同样读取 READ_MY_CHATGPT_OUTPUT_TIMEZONE。例如上海时区会 输出：

2026-07-24T15:58:07.513+08:00

get_conversation 的 created_at、updated_at 和 messages[].created_at 会使用配置时区。list_conversations 和 search_conversations 继续保留上游 create_time / update_time 字段， 同时新增适合展示的 created_at / updated_at。包含时间的工具结果还会返回 time_zone，MCP instructions 会要求客户端优先使用格式化字段。

该配置只控制 MCP 时间输出；READ_MY_CHATGPT_OBSCURA_TIMEZONE 控制浏览器 sidecar，两者用途不同。

日常命令

# 检查 Node、配置权限、Obscura、旧常驻服务和按需 daemon 状态
npx -y read-my-chatgpt@latest doctor

# 输出便于脚本读取的诊断结果（不包含任何 token）
npx -y read-my-chatgpt@latest doctor --json

# 再次配置已检测到的客户端
npx -y read-my-chatgpt@latest configure

# 指定客户端；也可以用 all 创建全部 7 份配置
npx -y read-my-chatgpt@latest configure codex cursor gemini
npx -y read-my-chatgpt@latest configure all

# 停止遗留服务并从客户端移除 MCP 条目；默认保留 token 与浏览器 profile
npx -y read-my-chatgpt@latest uninstall

# 同时删除本项目保存的配置、token、Obscura 和 profile
npx -y read-my-chatgpt@latest uninstall --purge

修改客户端配置前会创建 .bak 备份；若 .bak 已存在，则创建带时间戳的新 备份。客户端配置中不再写入 access token 或 MCP Bearer token；敏感值只保存在 本机 service.json。修改后的文件及备份仍会收紧为 0600。

支持的客户端

Pi 本身不内置 MCP；先执行 pi install npm:pi-mcp-adapter。init 检测到该 adapter 后才会自动写入 Pi 配置。

其他支持 stdio MCP 的客户端可手动使用：

{
  "command": "npx",
  "args": ["-y", "read-my-chatgpt@<初始化时的版本>", "connect"]
}

connector 会读取 ~/.config/read-my-chatgpt/service.json。该文件保存 access token 和 daemon 内部使用的 Bearer token；不要分享它。分享的是 npm 包或 GitHub 仓库，不是你的本机配置。

MCP tools

get_conversation 保留原有 messages[].content 文本字段；仅在消息含有富内容时 增加 messages[].rich_content：

{
  "links": [{ "kind": "web", "url": "https://…", "title": "…" }],
  "citations": [{ "url": "https://…", "title": "…", "reference_type": "sources_footnote" }],
  "diagrams": [{ "format": "mermaid", "source": "graph TD\n  A --> B" }],
  "assets": [{
    "asset_id": "asset_…",
    "kind": "image",
    "name": "chart.png",
    "mime_type": "image/png",
    "size_bytes": 1234,
    "width": 1024,
    "height": 768
  }]
}

读取图片/附件需要把同一个 conversation_id 和上面的 asset_id 传给 get_asset。图片以 MCP image content 返回；其他文件以带 Base64 blob 的 MCP embedded resource 返回。默认单个资产上限为 10 MiB，可用 READ_MY_CHATGPT_MAX_ASSET_BYTES 调整（最大 32 MiB）。

边界：

• 只读，不发送、修改、归档或分享会话；

• 读取 live Web 数据，不创建本地会话归档；

• 支持读取已完成的云端 Work 会话；返回 experience 和 completion_status，隐藏内部推理、子代理事件与工具执行；

• 支持当前可见消息直接引用的图片与普通文件附件；

• 不跟踪运行中的 Work，也不复现 Canvas/HTML/React 预览、Apps 卡片、 Work Sites、Google Docs/Sheets/Slides 或其他交互运行时；

• search_conversations 只搜索标题；

• 只处理个人账号，不添加 Team/Workspace headers；

• token 过期后需要手动更新。

架构

Codex / Claude / Cursor / Gemini / Grok / OpenCode / Pi
                         │
       每个客户端 1 个轻量 stdio connector
             （initialize / tools/list 本地完成）
                         │
                  第一次 tools/call
                         │
       1 个共享的按需 Node daemon（loopback HTTP）
                         │
             1 个 Obscura sidecar
                         │
       chatgpt.com/backend-api（只读白名单）

connector 进程随各客户端启动和退出，但不持有浏览器资源。daemon 中每个 connector 有独立 MCP session，同时共享一个上游浏览器 runtime。最后一次 tool 调用完成后，10 分钟没有新 tool 调用，daemon 和 Obscura 会退出；即使 client 仍保持连接也一样。下一次调用会透明地重新启动并重连。

tools/list、ping 和其他握手流量不会延长这 10 分钟。正在执行的 tool 不会被 空闲定时器中断；计时从最后一个并发 tool 完成后开始。可用 READ_MY_CHATGPT_DAEMON_IDLE_MS 调整空闲超时。冷启动默认最多等待 2 分钟， 可用 READ_MY_CHATGPT_DAEMON_START_TIMEOUT_MS 调整。

ChatGPT access token 只经本机 CDP 注入页面内 XHR，不放进 Obscura argv 或 日志。

允许的上游 endpoint 只有：

GET /backend-api/conversations
GET /backend-api/conversation/{id}
GET /backend-api/files/download/{file_id}?conversation_id={id}&inline=false

最后一个 endpoint 只为已经出现在该会话当前可见分支中的 asset_id 获取一次性 下载地址。随后只访问上游返回的 HTTPS 资产地址；只有与配置的 ChatGPT baseUrl 同源时才携带现有 access token，跨域下载绝不携带。签名地址不会出现 在 MCP 返回值或错误信息中。下载前后都会执行大小限制，并校验 MIME；HTML 响应和“图片却返回非图片 MIME”会被拒绝。

隐私与本机文件

默认位置：

~/.config/read-my-chatgpt/service.json
~/.local/share/read-my-chatgpt/obscura/
~/.local/share/read-my-chatgpt/obscura-profile/

service.json 含 access token 与 daemon 内部 Bearer token； obscura-profile/ 可能含 cookie 和 localStorage，两者都应按账号敏感数据保护。 项目不提供云端中转，也不会遥测上传这些数据。

init 不安装 launchd / systemd 服务，也不会让 daemon 在没有 tool 调用时 常驻。旧版本遗留的日志会保留到执行 uninstall --purge，以避免升级时意外 删除诊断资料。

兼容 stdio

旧客户端可直接启动 CLI；这种模式不会提供“全客户端单例”：

export READ_MY_CHATGPT_ACCESS_TOKEN='…'
read-my-chatgpt

首次启动仍会自动下载并校验 Obscura。也可以指定已有的兼容版本：

export READ_MY_CHATGPT_OBSCURA_BIN='/absolute/path/to/obscura'

从源码开发

git clone https://github.com/Async23/read-my-chatgpt.git
cd read-my-chatgpt
npm ci
npm run check

需要真实账号联调时：

export READ_MY_CHATGPT_ACCESS_TOKEN='…'
npm run smoke
npm run smoke:stability

安全与依赖

• 安全问题请按 SECURITY.md 私下报告。

• Obscura 由其官方 Release 在首次 init 时单独下载，不包含在 npm tarball 中； 版本、校验值和许可证信息见 THIRD_PARTY_NOTICES.md。

• OpenAI 使用条款与品牌规范可能变化，请以 Terms of Use 和 Brand guidelines 为准。

参与和支持

• 使用问题与脱敏要求：SUPPORT.md

• 贡献流程与本地检查：CONTRIBUTING.md

• 安全漏洞私密报告：SECURITY.md

• 行为准则：CODE_OF_CONDUCT.md

• 版本变化：CHANGELOG.md

License

MIT