refactor: consolidate nvim crates, extract server library, and update workspace dependencies
This commit is contained in:
1 parent
a083719cf1
commit
533adfd41b
53 files changed
+5967
-1230
No files matched your search
@@ -1,16 +1,15 @@
|
||||
# Neovim MCP Architecture (Dual-OS)
|
||||
# Neovim MCP Architecture (Cross-Platform)
|
||||
|
||||
We use a modular, multi-binary approach for MCP Neovim integration to cleanly separate Windows and Linux concerns, avoiding complex cross-OS `wsl.exe` bridging within the main `mcp-memory-server`.
|
||||
We use a modular, cross-platform approach for MCP Neovim integration to cleanly connect with Neovim instances across Windows and WSL.
|
||||
|
||||
## The Architecture
|
||||
1. **`mcp-memory-server`:** The core Windows daemon (handles state, lock-files, and global graph).
|
||||
2. **`mcp-memory-stub`:** The WSL proxy that forwards standard json-rpc to the Windows daemon.
|
||||
3. **`mcp-memory-win-nvim`:** A dedicated Windows-native MCP server. Its sole responsibility is finding active Neovim instances running natively on Windows and sending RPC commands to them.
|
||||
4. **`mcp-memory-linux-nvim`:** A dedicated Linux-native MCP server running inside WSL. Its sole responsibility is finding active Neovim instances inside WSL (including Tmux sessions) and sending RPC commands to them.
|
||||
3. **`mcp-memory-nvim`:** The unified cross-platform Neovim MCP server binary (`mcp-memory-nvim.exe` on Windows, `mcp-memory-nvim` on Linux). Its sole responsibility is finding active Neovim instances (via named pipes on Windows or domain sockets on Unix/WSL) and sending RPC commands to them.
|
||||
|
||||
This isolates editor-control logic to the native OS where the editor is actually running.
|
||||
This isolates editor-control logic natively to whichever OS environment execution is running in.
|
||||
|
||||
## How the Respective MCP Servers Get Called
|
||||
## How the MCP Server Gets Called
|
||||
|
||||
The Antigravity CLI (`agy`) acts as the MCP Client and automatically manages the lifecycle of these servers.
|
||||
|
||||
@@ -19,18 +18,18 @@ The Antigravity CLI (`agy`) acts as the MCP Client and automatically manages the
|
||||
- Windows: `C:\Users\reazul.ashraf\.gemini\config\mcp_config.json`
|
||||
|
||||
2. **Execution:**
|
||||
When `agy` starts up, it reads `mcp_config.json`. If it finds `"linux-nvim": { "command": "/home/riz/.local/bin/mcp-memory-linux-nvim" }`, it will spawn that binary as a background subprocess using standard `stdio`.
|
||||
When `agy` starts up, it reads `mcp_config.json`. If it finds `"win-nvim": { "command": "C:\\Users\\reazul.ashraf\\.local\\bin\\mcp-memory-nvim.exe" }`, it will spawn that binary as a background subprocess using standard `stdio`.
|
||||
|
||||
3. **Communication:**
|
||||
- The LLM requests to use a tool (e.g., `nvim_goto_line`).
|
||||
- The `agy` CLI sends a JSON-RPC request to the `mcp-memory-linux-nvim` subprocess via its `stdin`.
|
||||
- The Rust MCP Server receives the request, connects to the Neovim active socket (`~/.gemini/active_nvim.txt`), sends the Msgpack-RPC command, and writes the JSON-RPC response back to `stdout`.
|
||||
- The `agy` CLI sends a JSON-RPC request to the `mcp-memory-nvim` subprocess via its `stdin`.
|
||||
- The Rust MCP Server receives the request, connects to the Neovim active socket/pipe (`~/.gemini/active_nvim.txt` or `\\.\pipe\nvim.*`), sends the Msgpack-RPC command, and writes the JSON-RPC response back to `stdout`.
|
||||
- The `agy` CLI reads the response from `stdout` and returns it to the LLM context.
|
||||
|
||||
## Capabilities & Requirements
|
||||
To use this architecture, Neovim must run the `gemini-integration.lua` script to broadcast its active socket to `~/.gemini/active_nvim.txt`.
|
||||
|
||||
The MCP servers provide 5 core tools:
|
||||
The MCP server provides core tools including:
|
||||
1. **`nvim_goto_line`**
|
||||
2. **`nvim_set_diagnostics`**
|
||||
3. **`nvim_get_active_buffer`**
|
||||
|
||||
Reference in new issue
Block a user