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

Uploaded Python 3

File details

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

File metadata

  • Download URL: hyprpilot_nvim_mcp-2.2.2.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.2.tar.gz
Algorithm Hash digest
SHA256 435623fe0ac17d1869ba90ad96c46d309e14dde4cbf542f278de9aac00b86e11
MD5 97e7c853b9d399ada7333da495971b05
BLAKE2b-256 e478718075989cb4e4b8eae4bc6e3a37fb653e6674d5ad8a959f828537d4673c

See more details on using hashes here.

Provenance

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

File metadata

File hashes

Hashes for hyprpilot_nvim_mcp-2.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d9515f2b3437951dc087ee17a13929d623312a979eeb75402a08fb7c5074cc96
MD5 7e3b113c4816fd631245740b841fcf84
BLAKE2b-256 80085c622221e1a9682a43222a405339233481aa5db3404f149f70400fa2c1f4

See more details on using hashes here.

Provenance

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

This release

2.2.2 This release

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