hyprpilot-nvim-mcp

uvx-runnable MCP server that bridges a running Neovim's editor state into the hyprpilot agent's tool surface.

It is a pure dispatcher: at boot it attaches to Neovim over its listen socket, queries require("hyprpilot.mcp").list() for the tools you registered on the Lua side (via the hyprpilot.nvim plugin), and re-exposes each one to the agent through FastMCP with its JSON Schema carried through verbatim. It dies at startup if the socket cannot be reached.

Install in `mcps.json`

"hyprpilot-nvim": {
  "command": "uvx",
  "args": ["hyprpilot-nvim-mcp"],
  "env": { "NVIM_LISTEN_ADDRESS": "/run/user/1000/nvim.sock" }
}

uvx fetches the package from PyPI on first run and caches it. The daemon does not expand ${NVIM_LISTEN_ADDRESS} — inline the literal socket path.

Run from source

uv sync
uv run hyprpilot-nvim-mcp --nvim-listen-address /run/user/1000/nvim.sock

Environment

The Neovim socket is resolved from --nvim-listen-address (aliases --nvim, -n), then $NVIM_LISTEN_ADDRESS, then $NVIM (set automatically by Neovim in its child processes). The server exits non-zero if none resolve or the socket is unreachable.

NVIM_LISTEN_ADDRESS — path to the running Neovim's listen socket.
NVIM — fallback socket; Neovim sets it in its child processes.
HYPRPILOT_NVIM_MCP_LOG_LEVEL — stderr log level (default INFO).

Built-in tools

Two management tools ship regardless of the Lua registry:

healthcheck — bridge version, socket, connection state, nvim version, registered tool count.
reload_dynamic_tools — re-discover the Lua registry and diff it against the live tool list.

Every other tool comes from the Lua side — this package ships no editor tool catalogue of its own.

Development

task install   # uv sync --all-groups
task lint      # ruff format --check + ruff check + mypy
task test      # pytest
task build     # uv build

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hyprpilot_nvim_mcp-2.1.0.tar.gz (19.2 kB view details)

Uploaded Jul 23, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hyprpilot_nvim_mcp-2.1.0-py3-none-any.whl (11.3 kB view details)

Uploaded Jul 23, 2026 Python 3

File details

Details for the file hyprpilot_nvim_mcp-2.1.0.tar.gz.

File metadata

Download URL: hyprpilot_nvim_mcp-2.1.0.tar.gz
Upload date: Jul 23, 2026
Size: 19.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for hyprpilot_nvim_mcp-2.1.0.tar.gz
Algorithm	Hash digest
SHA256	`93fa11088b44efe4b7572935040d6a25a5b406ed560eb0bf1af653dd8d11f6bd`
MD5	`8627232b004a8220c0df5f4747ffe5af`
BLAKE2b-256	`df06168864a6918dc0e7ad33a6eca4e09b142efaf57f36422978adcdd5d2dc69`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hyprpilot_nvim_mcp-2.1.0.tar.gz:

Publisher: release-please.yml on hyprpilot/hyprpilot.nvim

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hyprpilot_nvim_mcp-2.1.0.tar.gz
- Subject digest: 93fa11088b44efe4b7572935040d6a25a5b406ed560eb0bf1af653dd8d11f6bd
- Sigstore transparency entry: 2228523880
- Sigstore integration time: Jul 23, 2026
Source repository:
- Permalink: hyprpilot/hyprpilot.nvim@9306347193c41f15403f21af4433ec49fc4039a0
- Branch / Tag: refs/heads/main
- Owner: https://github.com/hyprpilot
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release-please.yml@9306347193c41f15403f21af4433ec49fc4039a0
- Trigger Event: push