Skip to content

Install neon-mcp

neon-mcp is a Python 3.11+ package with one command, neon-mcp. The recommended installer is uv1, which keeps the server in its own environment.

PyPI release

Until the first PyPI release, install from GitHub as shown below. After it, uv tool install neon-mcp and uvx neon-mcp work directly.

uv tool install git+https://github.com/idss-mesa/neon-mcp
uv tool install "neon-mcp[pdf] @ git+https://github.com/idss-mesa/neon-mcp"   # with PDF text extraction

This puts neon-mcp on your PATH (~/.local/bin). Upgrade with uv tool upgrade neon-mcp.

uvx --from git+https://github.com/idss-mesa/neon-mcp neon-mcp --version

pipx install git+https://github.com/idss-mesa/neon-mcp
# or, inside a virtual environment:
pip install "git+https://github.com/idss-mesa/neon-mcp"

git clone https://github.com/idss-mesa/neon-mcp
cd neon-mcp
uv sync --all-extras          # creates .venv with the package and dev tools
uv run neon-mcp --version

MCP clients can then run /absolute/path/to/neon-mcp/.venv/bin/neon-mcp.

Verify

neon-mcp --version     # neon-mcp 0.1.0
neon-mcp --check       # {"ok": true, "version": "0.1.0", "tokenConfigured": false, "apiReachable": true, ...}

--check loads your configuration, makes one small anonymous NEON request and exits 0 when NEON is reachable. --print-config shows the effective settings with the token masked.

Next: connect a client and add your NEON API token.

  1. uv documentation. https://docs.astral.sh/uv/ ↩

  2. neon-mcp source repository. https://github.com/idss-mesa/neon-mcp ↩