project-mcp 0.1.2

把一个本地项目作为 token 保护的 MCP 服务暴露给 ChatGPT。

Project MCP

把一个本地项目作为 token 保护的 MCP 服务暴露给 ChatGPT。

Project MCP 故意保持很小：

• 一个本地项目根目录
• 一个固定项目 token
• 一个 Streamable HTTP MCP 端点：/mcp
• 通过 Cloudflare quick tunnel 暴露公网 HTTPS
• 不做登录、不做托管 relay、不做 ChatGPT 自定义 UI 卡片

快速开始

不安装，直接运行：

uvx project-mcp setup --root .
uvx project-mcp start

或安装成持久 CLI：

uv tool install project-mcp
project-mcp setup --root .
project-mcp start

start 会输出 ChatGPT 需要粘贴的 Server URL，例如：

https://example.trycloudflare.com/mcp?project_mcp_token=pmcp_...

如果保存的本地端口被占用，start 会自动换一个空闲端口继续启动；公网 tunnel URL 不受影响。 Cloudflare quick tunnel 的 *.trycloudflare.com Host 会被默认允许，其他公网 Host 默认拒绝。

在 ChatGPT Developer Mode 里创建 app/connector：

Connection: Server URL
Authentication: None / No Authentication

命令

project-mcp setup --root . --port 8080
project-mcp start --root .
project-mcp start --read-only
project-mcp start --no-bash
project-mcp doctor
project-mcp token rotate
project-mcp settings show

项目配置保存在仓库外：

~/.project-mcp/workspaces/<sha256-realpath>.json

token 按“设备 + 项目根目录”固定保存，直到你显式轮换它。

MCP 工具

Project MCP 暴露：

• server_config
• workspace_info
• tree
• search
• read_file
• write_file
• edit_file
• show_changes
• run_check

--read-only 会隐藏 write_file 和 edit_file。--no-bash 会隐藏 run_check。

开发

uv sync
uv run ruff check .
uv run pytest
uv build
uv publish