nvim-mcp-server 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37f1c2ca44998304a9abe21e2df12e7723312c0e339e236e1552606823ce9f7c
-  data.tar.gz: 026a645ec357568819a87c76739a32e2efb0cc4d4736488df17d116f6ccc95c2
+  metadata.gz: acdfba1e3fa12dbc46655893c542c90e616e5524ba340dd45dea65d16eda2ede
+  data.tar.gz: ebf73d6c98f0fd5c755020607b3015492a17b4551de04268b91ff7ca5e28859b
 SHA512:
-  metadata.gz: d7852a33dda675213414deb6fa3710490723a9663d2d4741dfd775d01815465828c84d1ccefc9409c33c3246d463e4a43f931ecb5104e0ab4ae5a2169bb89633
-  data.tar.gz: 2dcbe478aa2e51f754f1c842c10bec02c90a140abb722e69caf9245fd578c2a2bace4756562dbb0a390faf2b8d032b4490e8cf3bf0f2dabe72fd0fe7e150fff4
+  metadata.gz: 4d0533967f34381dab20aa02fc59eacae836cb3480ee99ac0ac88801ab720eb5b7d43f7d19ef472599abe9882e876730b796783e7c3a04577c487a0ada38b3a3
+  data.tar.gz: 89fa8935a7965fed00f27b308603b947f4e47ee74844a31d2ed96a4d96b64f3f08c8204c9d39e0f6eebb3fb2b6f692512a5db8afa5c94e0c661c38c782484ef1

data/CHANGELOG.md

@@ -1,5 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
 ## [Unreleased]
 
+## [0.2.0] - 2025-07-08
+
+### Added
+
+- New `update_buffer` tool that allows MCP clients to update buffer content in Neovim
+- Ability to save updated buffers to disk and reload them automatically
+- Support for external tools (like AI assistants) to modify files open in Neovim
+
+### Changed
+
+- Updated tool registration to include both `GetProjectBuffersTool` and `UpdateBufferTool`
+
 ## [0.1.0] - 2025-05-17
 
+### Added
+
 - Initial release
+- Basic MCP server implementation for Neovim
+- Support for both STDIO and HTTP modes
+- `get_project_buffers` tool to query open buffers in Neovim instances
+- Integration with Claude Desktop
+- Logging functionality with configurable log levels
+- XDG Base Directory Specification compliance for configuration files
+- Support for multiple Neovim instances via Unix sockets
+- MCP Inspector compatibility for testing and debugging

data/README.md

@@ -12,6 +12,7 @@ This Neovim MCP Server implements the MCP specification to give AI models access
 
 - Connect to running Neovim instances
 - Query buffers across multiple Neovim sessions
+- Update and save buffers with new content
 - Follow the Model Context Protocol standard
 - Seamless integration with LLM clients
 
@@ -30,7 +31,6 @@ After installation, the `nvim-mcp-server` executable will be available in your P
 The Neovim MCP Server follows the XDG Base Directory Specification for configuration files:
 
 - On macOS: `$XDG_CONFIG_HOME/nvim-mcp` or `~/.config/nvim-mcp` if XDG_CONFIG_HOME is not set
-- On Linux: `$XDG_CONFIG_HOME/nvim-mcp` or `~/.config/nvim-mcp` if XDG_CONFIG_HOME is not set
 - On Windows: `%APPDATA%\nvim-mcp`
 
 The server will automatically create these directories and a log file the first time it runs.
@@ -77,12 +77,10 @@ The Neovim MCP Server can be used with Claude Desktop by manually configuring th
 
 1. Create the appropriate config directory for your platform:
    - macOS: `$XDG_CONFIG_HOME/nvim-mcp` or `~/.config/nvim-mcp` if XDG_CONFIG_HOME is not set
-   - Linux: `$XDG_CONFIG_HOME/nvim-mcp` or `~/.config/nvim-mcp` if XDG_CONFIG_HOME is not set
    - Windows: `%APPDATA%\nvim-mcp`
 
 2. Find or create the Claude Desktop configuration file:
    - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-   - Linux: `~/.config/Claude/claude_desktop_config.json`
    - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
 3. Add or update the MCP server configuration:
@@ -198,6 +196,30 @@ I'd like to know what files I'm currently working on in the "blog" project.
 List all the buffers for the "nvim-mcp-server" project.
 ```
 
+### 2. `update_buffer`
+
+**Description:** Updates a buffer with new content provided by the MCP client, saves it to disk, and reloads it. This tool connects to a running Neovim instance, replaces the entire buffer content with the provided content, writes it to disk, and then reloads the buffer. This is useful for applying external changes (like from an AI assistant) to files open in Neovim.
+
+**Parameters:**
+
+- `project_name`: (String, required) The name of the project directory. This is used to locate the Neovim socket at /tmp/nvim-{project_name}.sock.
+- `file_path`: (String, required) The absolute or relative file path of the buffer to update. This should match the path as shown in Neovim's buffer list.
+- `content`: (String, required) The new content to write to the buffer. This will replace the entire current content of the buffer.
+
+#### Examples
+
+```
+Please update the file "src/main.rb" in my "my-project" Neovim instance with the refactored code.
+```
+
+```
+Replace the content of "/home/user/projects/blog/app/controllers/posts_controller.rb" in the "blog" project with the updated controller code.
+```
+
+```
+Update the README.md file in the "nvim-mcp-server" project with the new documentation.
+```
+
 ## Testing and Debugging
 
 The easiest way to test and debug the Neovim MCP Server is by using the MCP Inspector, a developer tool designed specifically for testing and debugging MCP servers.

data/exe/nvim-mcp-server

@@ -75,7 +75,7 @@ NvimMcpServer.log(:info, "Starting Neovim MCP Server in #{mode} mode...")
 
 # Create tools configuration for both modes
 def setup_mcp_tools(server)
-  server.register_tools(NvimMcpServer::GetProjectBuffersTool)
+  server.register_tools(NvimMcpServer::GetProjectBuffersTool, NvimMcpServer::UpdateBufferTool)
 end
 
 case mode

data/lib/nvim-mcp-server/tools/update_buffer_tool.rb

@@ -0,0 +1,114 @@
+module NvimMcpServer
+  class UpdateBufferTool < BaseTool
+    tool_name "update_buffer"
+
+    description "Updates a buffer with new content provided by the MCP client, saves it to disk, and reloads it. This tool connects to a running Neovim instance, replaces the entire buffer content with the provided content, writes it to disk, and then reloads the buffer. This is useful for applying external changes (like from an AI assistant) to files open in Neovim."
+
+    arguments do
+      required(:project_name).filled(:string).description("The name of the project directory. This is used to locate the Neovim socket at /tmp/nvim-{project_name}.sock.")
+      required(:file_path).filled(:string).description("The absolute or relative file path of the buffer to update. This should match the path as shown in Neovim's buffer list.")
+      required(:content).filled(:string).description("The new content to write to the buffer. This will replace the entire current content of the buffer.")
+    end
+
+    def call(project_name:, file_path:, content:)
+      socket_path = "/tmp/nvim-#{project_name}.sock"
+      log(:info, "Updating buffer #{file_path} for project #{project_name} using socket #{socket_path}")
+
+      result = {
+        status: "success",
+        project_name: project_name,
+        socket_path: socket_path,
+        file_path: file_path,
+        updated: false,
+        saved: false,
+        reloaded: false
+      }
+
+      begin
+        # Check if socket exists
+        unless File.exist?(socket_path)
+          result[:status] = "error"
+          result[:message] = "Neovim socket not found: #{socket_path}"
+          return result
+        end
+
+        # Connect to Neovim
+        client = Neovim.attach_unix(socket_path)
+
+        # Get all buffers to find the one with the specified file
+        all_buffers = client.list_bufs
+        target_buffer = nil
+
+        all_buffers.each do |buffer|
+          buffer_name = buffer.name
+
+          # Skip unnamed buffers
+          next if buffer_name.nil? || buffer_name.empty?
+
+          # Check if this buffer matches the file path (exact match or ends with the path)
+          if buffer_name == file_path || buffer_name.end_with?(file_path)
+            target_buffer = buffer
+            result[:actual_path] = buffer_name
+            break
+          end
+        end
+
+        if target_buffer.nil?
+          result[:status] = "error"
+          result[:message] = "Buffer not found for file: #{file_path}"
+          return result
+        end
+
+        # Store original content info
+        original_line_count = target_buffer.line_count
+        result[:original_line_count] = original_line_count
+
+        # Find a window displaying this buffer or use the current window
+        windows = client.list_wins
+        target_window = windows.find { |win| win.buffer.number == target_buffer.number }
+
+        if target_window
+          # If we found a window with this buffer, switch to it
+          client.set_current_win(target_window)
+        else
+          # Otherwise, load the buffer in the current window
+          client.command("buffer #{target_buffer.number}")
+        end
+
+        # Split content into lines
+        new_lines = content.split("\n")
+        result[:new_line_count] = new_lines.length
+
+        # Replace the entire buffer content
+        # First, delete all existing lines
+        target_buffer.lines = new_lines
+        result[:updated] = true
+
+        # Save the buffer to disk
+        client.command("write")
+        result[:saved] = true
+        log(:info, "Saved updated buffer: #{result[:actual_path]}")
+
+        # Reload the buffer to ensure it's in sync
+        client.command("edit")
+        result[:reloaded] = true
+
+        result[:message] = "Successfully updated, saved, and reloaded buffer"
+
+        # Close the connection
+        client.shutdown
+      rescue => e
+        log(:error, "Error updating buffer in Neovim using socket #{socket_path}: #{e.message}")
+
+        # Handle connection and other errors gracefully
+        result[:status] = "error"
+        result[:message] = e.message
+        result[:updated] = false
+        result[:saved] = false
+        result[:reloaded] = false
+      end
+
+      result
+    end
+  end
+end

data/lib/nvim-mcp-server/version.rb

@@ -1,3 +1,3 @@
 module NvimMcpServer
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/nvim_mcp_server.rb

@@ -5,6 +5,7 @@ require_relative "nvim-mcp-server/version"
 require_relative "nvim-mcp-server/config"
 require_relative "nvim-mcp-server/tools/base_tool"
 require_relative "nvim-mcp-server/tools/get_project_buffers_tool"
+require_relative "nvim-mcp-server/tools/update_buffer_tool"
 
 module NvimMcpServer
   @levels = {debug: Logger::DEBUG, info: Logger::INFO, error: Logger::ERROR}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nvim-mcp-server
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Mario Alberto Chávez
@@ -112,6 +112,7 @@ files:
 - lib/nvim-mcp-server/config.rb
 - lib/nvim-mcp-server/tools/base_tool.rb
 - lib/nvim-mcp-server/tools/get_project_buffers_tool.rb
+- lib/nvim-mcp-server/tools/update_buffer_tool.rb
 - lib/nvim-mcp-server/version.rb
 - lib/nvim_mcp_server.rb
 - sig/nvim/mcp/server.rbs