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.3.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.3.0-py3-none-any.whl (11.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: hyprpilot_nvim_mcp-2.3.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.3.0.tar.gz
Algorithm Hash digest
SHA256 6b30363204dcf11c90756a65b479c6e31fd8f919b0eb326293889247a73b622a
MD5 0567ca22baf57f3aef56204933b7d6ee
BLAKE2b-256 3ebf055a8f4fd97d044b50af3541dfcbced9c1821fc342cdd3a49a82764435da

See more details on using hashes here.

Provenance

The following attestation bundles were made for hyprpilot_nvim_mcp-2.3.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.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for hyprpilot_nvim_mcp-2.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fbbd5e32a6fcb5b467e62884acbce0a4a2a9bd05e69bf215ec3aad8bf8585635
MD5 90dcfda809304930641fa95059d02b1a
BLAKE2b-256 a0df613c56162522437ce8302b64b2c7415ba68e98e12fa6c7789c2daa61d095

See more details on using hashes here.

Provenance

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

This release

2.3.0 This release

2 files

2.2.2

2 files

2.2.1

2 files

2.2.0

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