Skip to content

Installation

Requirements

  • Python 3.11 or newer (3.11, 3.12, and 3.13 are tested in CI)
  • macOS, Linux, or Windows

Not on PyPI yet

conmcp is pre-release and not published to PyPI. All installs below pull straight from the GitHub repo. A PyPI release is on the roadmap.

uv is the fastest way to get a working conmcp command:

uv tool install git+https://github.com/ContractorKeith/conmcp.git

Or skip installing entirely and run it on demand with uvx — this is also the cleanest way to launch the server from MCP client configs:

uvx --from git+https://github.com/ContractorKeith/conmcp.git conmcp version

Option 2: pipx

pipx install git+https://github.com/ContractorKeith/conmcp.git

Option 3: pip

Into a virtual environment of your choosing:

pip install git+https://github.com/ContractorKeith/conmcp.git

Option 4: from a clone (for development)

If you want to hack on conmcp or run the tests:

git clone https://github.com/ContractorKeith/conmcp.git
cd conmcp
uv sync --all-extras

Everything then runs through uv run — no manual venv activation:

uv run conmcp version
uv run pytest

Verify the install

Generate the synthetic sample plan (a 4-sheet commercial fence project — no real plan documents ship with conmcp) and read it back:

conmcp version
conmcp sample
conmcp overview sample_plan.pdf

You should see the version string, then Sample plan written to sample_plan.pdf, then a sheet index table showing four sheets: G-001 cover, C-101 site plan, C-501 fence details, and C-601 schedules & general notes.

From a clone, the same thing is:

uv run conmcp version
uv run conmcp sample
uv run conmcp overview sample_plan.pdf

If that works, head to the Quickstart to run a full takeoff, or straight to Connecting MCP clients to wire it into Claude Desktop, Claude Code, or Cursor.