project-mcp

# Project MCP 把一个本地项目作为 token 保护的 MCP 服务暴露给 ChatGPT。 Project MCP 故意保持很小： - 一个本地项目根目录 - 一个固定项目 token - 一个 Streamable HTTP MCP 端点：`/mcp` - 通过 Cloudflare quick tunnel 暴露公网 HTTPS - 不做登录、不做托管 relay、不做 ChatGPT 自定义 UI 卡片 ## 快速开始 不安装，直接运行： ```bash uvx project-mcp ``` 或安装成持久 CLI： ```bash uv tool install project-mcp project-mcp ``` 默认会把当前目录作为项目目录，并输出 ChatGPT 需要粘贴的 Server URL，例如： ```text https://example.trycloudflare.com/mcp?project_mcp_token=pmcp_... ``` 如果保存的本地端口被占用，`start` 会自动换一个空闲端口继续启动；公网 tunnel URL 不受影响。 Cloudflare quick tunnel 的 `*.trycloudflare.com` Host 会被默认允许，其他公网 Host 默认拒绝。 在 ChatGPT Developer Mode 里创建 app/connector： ```text Connection: Server URL Authentication: None / No Authentication ``` ## 命令 ```bash project-mcp project-mcp --root /path/to/project project-mcp --read-only project-mcp --no-bash project-mcp setup --root . --port 8080 project-mcp start --root . project-mcp doctor project-mcp token rotate project-mcp settings show ``` 项目配置保存在仓库外： ```text ~/.project-mcp/workspaces/<sha256-realpath>.json ``` token 按“设备 + 项目根目录”固定保存，直到你显式轮换它。 ## MCP 工具 Project MCP 暴露： - `server_config` - `workspace_info` - `tree` - `search` - `grep` - `read_file` - `write_file` - `edit_file` - `show_changes` - `run_check` `--read-only` 会隐藏 `write_file` 和 `edit_file`。`--no-bash` 会隐藏 `run_check`。 `grep` 是 `search` 的安全别名，方便 ChatGPT 按直觉查代码；它不会执行 shell `grep`，仍然遵守项目 root、blocked globs、二进制拒绝和结果数量限制。 `run_check` 默认使用安全白名单，覆盖 codexpro 风格的只读/验证命令，并额外支持更多常见检查器： - `pwd`、`ls`、`find` - `git status`、`git diff`、`git log`、`git show`、`git branch`、`git rev-parse`、`git ls-files` - `pytest`、`python -m pytest`、`python -m unittest`、`uv run pytest` - `npm/pnpm/yarn/bun test|lint|typecheck|build|check|validate` - `npm/pnpm/yarn/bun run build:clients`、`bun run smoke:network-propagation` 这类带冒号后缀的检查/验证脚本 - `bun --filter @scope/pkg smoke:case-name` 这类 Bun monorepo 定向验证脚本 - `go test`、`cargo test/check/clippy` - `tsc`、`eslint`、`biome check`、`prettier --check` - `ruff check`、`ruff format --…