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

Uploaded Python 3

File details

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

File metadata

  • Download URL: hyprpilot_nvim_mcp-2.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 3313f02993aadf2cfb7e8cb4f2e15d2958ec16128acaa34c2980693489ace708
MD5 ec24a598d550e891e0580a0c3cb9125c
BLAKE2b-256 1dff61fa8296d5fdc9d45a9dabaa27d130d7f8bfc05a860ba9b2d3c3147bb5ba

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for hyprpilot_nvim_mcp-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9cb931420853624a9a4479e7a2f8e554f8c5b970b718f8fb43965c3221ced244
MD5 40ca5b763364b4f59a45ef14586d9591
BLAKE2b-256 96156ca3ce2fdc2bbe1fb870c94e4984485bea4413d002ba5333830960051090

See more details on using hashes here.

Provenance

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

This release

2.2.1 This release

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