paulburgess1357/nvim-mcp

v1.0.0 Feature

This release adds 3 notable features for engineering teams evaluating rollout.

Published 16d MCP Developer Tools

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai artificial-intelligence claude claude-code codex cursor

+11 more

llm mcp mcp-server model-context-protocol msgpack-rpc neovim neovim-config nvim openai text-editor vim

Summary

AI summary

MCP virtual text support adds annotated annotations with add_virtual_text, add_virtual_texts, and clear_virtual_texts.

Changes in this release

Type	Severity	Summary	CVE
Breaking
Breaking	Medium	Promotes PyPI metadata from `Development Status :: 3 - Alpha` to `5 - Production/Stable`. Promotes PyPI metadata from `Development Status :: 3 - Alpha` to `5 - Production/Stable`. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Breaking	Medium	MCP surface (state, buffers, windows, navigation, commands, highlights, virtual text) now under semantic versioning. MCP surface (state, buffers, windows, navigation, commands, highlights, virtual text) now under semantic versioning. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: low	—
Breaking	Medium	MCP surface is now committed under semantic versioning. MCP surface is now committed under semantic versioning. Source: granite4.1:30b@2026-05-19-audit Confidence: low	—
Feature
Feature	Medium	`nvim-mcp` exposes a virtual-text surface mirroring highlight surface. `nvim-mcp` exposes a virtual-text surface mirroring highlight surface. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Feature	Medium	Three new tools: `add_virtual_text`, `add_virtual_texts`, and `clear_virtual_texts` for annotations. Three new tools: `add_virtual_text`, `add_virtual_texts`, and `clear_virtual_texts` for annotations. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Feature	Medium	`get_state` now reports an `mcp_virtual_text` list per window alongside `mcp_highlights`. `get_state` now reports an `mcp_virtual_text` list per window alongside `mcp_highlights`. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Feature	Medium	Batched `add_virtual_texts` documents partial-failure semantics: earlier items stay applied if later fails. Batched `add_virtual_texts` documents partial-failure semantics: earlier items stay applied if later fails. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Feature	Medium	`:McpClearVirtualTexts` user command documented for users to wipe annotations from Neovim. `:McpClearVirtualTexts` user command documented for users to wipe annotations from Neovim. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Feature	Medium	Agent rule prefers Neovim's semantic highlight groups (`DiagnosticError`, `DiagnosticWarn`, `Comment`, …). Agent rule prefers Neovim's semantic highlight groups (`DiagnosticError`, `DiagnosticWarn`, `Comment`, …). Source: granite4.1:8b-q6_K@2026-05-19 Confidence: high	—
Feature	Medium	`tests/TEST_PROMPT.md` updated with Section 10 covering new virtual-text tools. `tests/TEST_PROMPT.md` updated with Section 10 covering new virtual-text tools. Source: granite4.1:8b-q6_K@2026-05-19 Confidence: low	—

Full changelog

What's New

MCP virtual text support

nvim-mcp now exposes a virtual-text surface that mirrors the existing highlight surface. Three new tools — add_virtual_text, the batched add_virtual_texts, and clear_virtual_texts — let agents pin contextual annotations to specific lines using extmarks in a dedicated mcp_virtual_text namespace. Positions can be eol, above, or below, and colors accept either a hex foreground or a Neovim highlight-group name, so annotations adapt to the user's colorscheme.

get_state now reports an mcp_virtual_text list per window alongside the existing mcp_highlights field, so agents can see what they've already annotated. The batched add_virtual_texts tool documents its partial-failure semantics: items 0..N-1 stay applied if item N fails — use clear_virtual_texts to roll back. A :McpClearVirtualTexts user command is also documented for users who'd rather wipe annotations from inside Neovim.

The agent rule (config/AGENTS-EXAMPLE.md and the regenerated rules/nvim-mcp.mdc) gains a virtual-text section telling agents to prefer Neovim's semantic highlight groups (DiagnosticError, DiagnosticWarn, Comment, …) so the colors track the user's theme. tests/TEST_PROMPT.md grows a parallel Section 10 covering the new tools.

1.0 milestone

This release promotes the PyPI metadata from Development Status :: 3 - Alpha to 5 - Production/Stable. The MCP surface (state, buffers, windows, navigation, commands, highlights, virtual text) has been stable across the 0.x line and is now committed to under semantic versioning.

Other Changes

Refreshed uv.lock
Tweaked assets/avatar.png background

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track paulburgess1357/nvim-mcp

Get notified when new releases ship.

About paulburgess1357/nvim-mcp

MCP server providing AI assistants with full control of Neovim instances via msgpack-RPC. Read/edit buffers, run commands, send keys, query LSP diagnostics, and annotate code with highlights. No plugin required.

All releases →