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 (defaultINFO).
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
1 maintainer
Metadata
1 maintainer
Release files for hyprpilot-nvim-mcp 3.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| hyprpilot_nvim_mcp-3.0.0.tar.gz | 19.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| hyprpilot_nvim_mcp-3.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 30.6 kB
Release files / hyprpilot_nvim_mcp-3.0.0.tar.gz
| Download URL | hyprpilot_nvim_mcp-3.0.0.tar.gz |
|---|---|
| Size | 19.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
70a3cc2047ed1850cf3e6d266f7e3751a287ad46c24e9f8e730a0d03fb530b75
|
|
BLAKE2b-256 checksum How to use checksums |
8f746a0000d32688552a46ef3b8a6579b65b54035d225cff64d0529d9efbbb11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 5, 2026.
Transparency logRelease files / hyprpilot_nvim_mcp-3.0.0-py3-none-any.whl
| Download URL | hyprpilot_nvim_mcp-3.0.0-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f3c8954ef905ee4d3ee3e3424a5093a16393eb6b59ae56b3c58eecaad8b7e2b9
|
|
BLAKE2b-256 checksum How to use checksums |
fede98506b931297fe1526f65e78f52e92dc0a212cc36f5e696bf284d0c267c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 5, 2026.
Transparency log
