# Codexmanager

> 贴一个路径，让 ChatGPT 读懂你的本机和服务器项目。路径直读、双端工作区、连接诊断与 Codex 管理。

- **Type:** MCP server
- **Install:** `agentstack add mcp-3241288994-codexmanager`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [3241288994](https://agentstack.voostack.com/s/3241288994)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [3241288994](https://github.com/3241288994)
- **Source:** https://github.com/3241288994/codexmanager

## Install

```sh
agentstack add mcp-3241288994-codexmanager
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 贴一个路径，让 ChatGPT 读懂你的本机和服务器项目

  CodexManager · 从一个绝对路径开始的本机 / 服务器项目理解入口

  
  
  

复制一个本机或服务器绝对路径，ChatGPT 就能在你授权的范围内查看目录、找到入口文件、继续读取
关键代码与文档，并解释整个项目是做什么的——无需先上传项目，也无需先注册工作区。

> **一句话卖点：把路径贴给 ChatGPT，让它直接读懂你电脑和服务器上的真实项目。**

[交给 Agent 安装](INSTALL.md) · [路径直读与工作区](docs/local-workspaces.md) · [连接 ChatGPT](docs/open-source/03-openai-plugin-and-tunnel.md) · [服务器部署](docs/open-source/01-server-deployment.md)

English: **Paste a path and let ChatGPT understand a project on your computer or server.** CodexManager connects authorized ChatGPT workflows to bounded, read-only project tools while keeping administration and credentials private.

  
    
  

## 一眼看懂它怎么用

下面是一段典型流程。路径只是示例，实际可使用你已经授权的本机或服务器目录。

```text
你：
请读取服务器上的 /srv/research/web-agent，先看目录，再找到入口文件，告诉我这个项目怎么运行。

ChatGPT：
✓ 已确认来源：服务器
✓ 已读取两层目录：README.md、pyproject.toml、src/、tests/、configs/
✓ 找到主要入口：src/main.py
✓ 继续检查 README.md、pyproject.toml 与入口模块

这是一个用于网页任务规划与执行的 Agent 项目：
- src/main.py 负责启动任务和加载配置
- src/agent/ 保存规划、动作选择与错误恢复逻辑
- configs/ 定义模型、浏览器环境和实验参数
- tests/ 覆盖页面解析与任务执行

建议先从 README.md 的 Quick Start 启动，再查看 configs/default.yaml。
```

这个过程由四步组成：

| 你做什么 | ChatGPT 做什么 |
| --- | --- |
| 1. 粘贴绝对路径 | 判断它来自本机还是服务器，并交给正确的 Provider |
| 2. 要求“先看目录” | 返回有限深度的目录树，不把整个项目塞进上下文 |
| 3. 要求“找到入口” | 按需读取 README、依赖配置和候选入口文件 |
| 4. 继续追问 | 解释模块关系、运行方法、研究目标，或固定为长期工作区 |

你也可以直接这样问：

```text
请查看本地电脑的 /Users/me/Documents/project，找到入口文件并解释项目结构。
请读取服务器 /srv/research/paper-a/README.md，总结当前研究目标与运行方法。
请在服务器 /srv/research/experiments 下列出两层目录，并比较两个实验的结果文件。
```

## 本机、服务器，或者两边一起

| 模式 | 能访问什么 | 适合谁 |
| --- | --- | --- |
| `local` | 本机明确授权的目录 | 代码、论文和资料都在个人电脑上 |
| `server` | SSH 后面的服务器授权目录 | 主要在科研服务器、工作站或私有云工作 |
| `hybrid`（推荐） | 同一个 ChatGPT 连接中的本机 + 服务器 | 本机写作、服务器训练，希望上下文连贯 |

两端完全解耦：只需要本机就不必安装服务器组件，只需要服务器也不必开放本机文件。访问范围始终由
各端 Provider 的 `registry.allowed_roots` 控制；根目录、凭据、隐藏密钥和不支持的二进制不会因为
贴了路径就自动开放。

## 两种使用方式

### 路径直读：临时、快速、零注册

`inspect_path` 适合“现在帮我看看这个目录/文件”。Provider 0.8.0 支持：

- 有限深度目录树；
- 安全文本和源代码；
- HTML 可见正文，不加载外部资源；
- 文本型 PDF 的分页读取与搜索；
- 扫描型 PDF 的明确 OCR 提示，而不是猜测内容。

### 工作区：长期项目上下文

需要持续研究时，再把路径固定为工作区。工作区可以维护项目概述、证据索引、实验结果、研究图、
分析任务和最近 Codex 会话衔接。路径直读与工作区共用同一套目录授权，但互不强制：先读懂，再决定
是否长期管理。

## 最省事的安装方式：交给 Agent

不用逐行复制部署命令。把下面内容交给能操作目标电脑和服务器的编码 Agent：

```text
请安装 https://github.com/3241288994/codexmanager ，模式为 hybrid。
服务器 SSH Host 是 ；本机允许读取 ，服务器允许读取 。
请先完整阅读仓库中的 AGENTS.md 和 INSTALL.md，按其中的 Agent 执行契约操作；
沿用已有 SSH 配置和密钥，不在对话或日志中输出凭据。只有必须由我在 OpenAI 页面完成时再通知我。
```

只使用一端时把模式改为 `local` 或 `server`。[`INSTALL.md`](INSTALL.md) 定义了只读盘点、备份、
组件安装、人工授权检查点与真实调用验收，Agent 不应把“端口已打开”误报成“已经完全连通”。

## 它是如何连接起来的

日常使用只需要记住 `labcontext`；下面的组件可以分别安装、升级和替换：

```text
ChatGPT 网页版
      │
      ▼
Secure MCP Tunnel
      │
      ▼
LabContext Router · 127.0.0.1:1460/mcp
      ├── local Provider  ── 本机授权目录
      └── server Provider ── SSH bridge ── 服务器授权目录

CodexManager Web · 127.0.0.1:48761
      └── 连接中心 / 工作区 / 研究图 / 用量与会话管理
```

- **Provider** 负责受限、只读地理解文件与项目；
- **Router** 把本机与服务器组合成一个稳定 MCP 工具面；
- **Tunnel** 让 ChatGPT 在无需开放入站公网端口的情况下访问 Router；
- **CodexManager** 提供连接诊断、工作区管理，以及 Codex 账号、额度、用量与会话辅助能力。

完整端口、SSH、Tunnel 和故障排查见[统一 LabContext Router](docs/labcontext-router.md)。

## 不只是路径读取

路径直读是主入口，下面这些能力为长期研究提供配套：

- **可验证的连接中心**：逐层检查 Router、Provider 身份与版本、真实 MCP 调用、SSH 子进程和 Tunnel；端口占用不会被误判为成功。
- **项目工作区**：管理模型可见资产、工具策略、项目概述、证据、实验、分析任务与研究图。
- **账号与额度**：通过官方设备授权添加账号，显示实际生效身份、套餐信号与额度快照，并切换服务器 Codex 凭据。
- **用量分析**：保存 Credits、Token 与交互历史，提供趋势图、JSON/CSV 导出和非账单性质的 USD 参考估算。
- **会话恢复**：读取 `state_5.sqlite` 元数据搜索本地会话并生成 `codex resume` 命令，不导出原始对话。

## 界面预览

### 工作区与连接中心

查看更多界面：工作区、研究图、账号、用量与会话

#### 工作区与研究图

#### 账号与额度

#### 用量分析

#### 会话恢复

## 重要边界

- 只有 `registry.allowed_roots` 下经过验证的路径可读；目录深度、条目数、文件大小、PDF 页数和单次响应均有限制。
- 默认部署只监听回环地址；数据库、管理 RPC、账号令牌和 LabContext admin token 不应公开。
- CodexManager service 本身不是 MCP endpoint；ChatGPT 连接的是独立 Router 的 `/mcp`，不是 `/api/rpc`、`/rpc` 或 `/admin`。
- 当前公开版不提供公共 OpenAI 兼容 `/v1` 网关。Secure MCP Tunnel 适合私有连接和开发测试，不是公共插件分发机制。
- 请只读取你有权访问的本机和服务器目录，并遵守 OpenAI、Codex 与目标项目的适用条款。

详细边界见 [SECURITY.md](SECURITY.md) 和 [OpenAI 插件与 Tunnel 说明](docs/open-source/03-openai-plugin-and-tunnel.md)。

## 手动部署与开发

| 目标 | 文档 |
| --- | --- |
| Agent 自动安装 | [INSTALL.md](INSTALL.md) |
| 服务器安全部署 | [docs/open-source/01-server-deployment.md](docs/open-source/01-server-deployment.md) |
| 本机路径与工作区 | [docs/local-workspaces.md](docs/local-workspaces.md) |
| Router 与三种模式 | [docs/labcontext-router.md](docs/labcontext-router.md) |
| ChatGPT、插件与 Tunnel | [docs/open-source/03-openai-plugin-and-tunnel.md](docs/open-source/03-openai-plugin-and-tunnel.md) |
| 测试与发布 | [TESTING.md](TESTING.md) · [公开发布清单](docs/open-source/04-public-release-checklist.md) |

本地开发要求 Node.js 20+、Python 3.11+、Rust stable；桌面打包还需要对应平台的 Tauri 依赖。

```bash
corepack pnpm@10.30.3 -C apps install --frozen-lockfile
corepack pnpm@10.30.3 -C apps run build:desktop
corepack pnpm@10.30.3 -C apps run test:runtime
cargo test --workspace --locked -- --test-threads=1
cargo test --manifest-path apps/src-tauri/Cargo.toml --locked --lib
scripts/open-source/preflight.sh
```

## 代码结构

```text
labcontext-provider/     路径直读、工作区、证据与研究工具的只读 Provider
scripts/labcontext*.py   本机 / 服务器统一 Router、SSH bridge 与启动诊断
apps/                    Next.js 管理界面与 Tauri 桌面壳
crates/web/              Web 运行壳、认证与受保护的 RPC 代理
crates/service/          账号、额度、会话、用量和 LabContext 管理适配
crates/core/             SQLite、认证与共享数据结构
crates/start/            service + web 启动器
deploy/                  安全 Compose 与 Router 示例配置
plugins/                 不含用户连接 ID 的公开插件模板
docs/                    路径、部署、Tunnel、安全与发布文档
```

## 贡献、许可与来源

- 安全问题请遵循 [SECURITY.md](SECURITY.md)，不要在公开 Issue 中提交凭据或可利用细节。
- 贡献流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。
- 项目采用 [MIT License](LICENSE)，基于 `qxcnm/Codex-Manager` 的 MIT 许可代码演进而来；详见 [NOTICE](NOTICE) 与[第三方声明](THIRD_PARTY_NOTICES.md)。

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [3241288994](https://github.com/3241288994)
- **Source:** [3241288994/codexmanager](https://github.com/3241288994/codexmanager)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-3241288994-codexmanager
- Seller: https://agentstack.voostack.com/s/3241288994
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.