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

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.0.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for cenk1cenk2 from gravatar.com cenk1cenk2

Credits

Author: Cenk Kilic

License expression

MIT
View SPDX License List

Requires

Python >=3.14

Report project as malware

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.2.0.tar.gz (19.2 kB view details)

Uploaded Source

Built Distribution

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

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: hyprpilot_nvim_mcp-2.2.0.tar.gz
  • Upload date:
  • Size: 19.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for hyprpilot_nvim_mcp-2.2.0.tar.gz
Algorithm Hash digest
SHA256 9a943f0d09f64d840ed2ca3ecc7629f40bbe3c819f3eb7254f27bfce189193e9
MD5 5f7ae53a239aee17e6afe1c1bc1b5e40
BLAKE2b-256 b4db93f01ed5a0b1ece67c18d96b368d94c6cb5ef9aec21ae0ecc6849e5be4cb

See more details on using hashes here.

Provenance

The following attestation bundles were made for hyprpilot_nvim_mcp-2.2.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.

File details

Details for the file hyprpilot_nvim_mcp-2.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for hyprpilot_nvim_mcp-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f930061554af2f32184f56f2e224821cd7f56f5fa639a8ce0534ad326223af60
MD5 b4fda6dbf659950f8eda5847824c5a54
BLAKE2b-256 dd193e62917d1839511e23ae083366cdf670c9665feb7f34fa5f0911056ce355

See more details on using hashes here.

Provenance

The following attestation bundles were made for hyprpilot_nvim_mcp-2.2.0-py3-none-any.whl:

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.

Release history Release notifications | RSS feed

3.0.0

2 files

2.3.0

2 files

2.2.2

2 files

2.2.1

2 files

This release

2.2.0 This release

2 files

2.1.0

2 files

2.0.0

2 files

1.17.0

2 files

1.16.0

2 files

1.15.0

2 files

1.14.1

2 files

1.14.0

2 files

1.13.1

2 files

1.13.0

2 files

1.12.5

2 files

1.12.4

2 files

1.12.3

2 files

1.12.2

2 files

1.12.1

2 files

1.12.0

2 files

1.11.0

2 files

1.10.2

2 files

1.10.1

2 files

1.10.0

2 files

1.9.1

2 files

1.9.0

2 files

1.8.0

2 files

1.7.0

2 files

1.6.2

2 files

1.6.1

2 files

1.6.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.1

2 files

1.3.0

2 files

1.2.0

2 files

1.1.2

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page