project-mcp 0.1.0

Expose one local project as a token-protected MCP server for ChatGPT.

Project MCP

Expose one local project as a token-protected MCP server for ChatGPT.

Project MCP is intentionally small:

• one local project root
• one fixed project token
• one Streamable HTTP MCP endpoint at /mcp
• Cloudflare quick tunnel for public HTTPS access
• no login, no hosted relay, no ChatGPT widget UI

Quick Start

Run without installing:

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

Or install as a persistent tool:

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

start prints a ChatGPT Server URL like:

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

In ChatGPT Developer Mode, create an app/connector with:

Connection: Server URL
Authentication: None / No Authentication

Commands

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

Profiles are stored outside the repository:

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

The token is fixed per device and project root until you rotate it.

Tools

Project MCP exposes:

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

--read-only hides write_file and edit_file. --no-bash hides run_check.

Development

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