nvim-mcp-server 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37f1c2ca44998304a9abe21e2df12e7723312c0e339e236e1552606823ce9f7c
-  data.tar.gz: 026a645ec357568819a87c76739a32e2efb0cc4d4736488df17d116f6ccc95c2
+  metadata.gz: 6fb63496112d2e52b2107995965bc2af9f5b335c0119e64c9a08c2a8725904ed
+  data.tar.gz: 3653a0dd083d33c1f876d5ad8b990031e6a1a32f5e02ce68cb4c8d4139ce7bc0
 SHA512:
-  metadata.gz: d7852a33dda675213414deb6fa3710490723a9663d2d4741dfd775d01815465828c84d1ccefc9409c33c3246d463e4a43f931ecb5104e0ab4ae5a2169bb89633
-  data.tar.gz: 2dcbe478aa2e51f754f1c842c10bec02c90a140abb722e69caf9245fd578c2a2bace4756562dbb0a390faf2b8d032b4490e8cf3bf0f2dabe72fd0fe7e150fff4
+  metadata.gz: 2f2b647116afb3904e3d29f95eecc70d642d02c997046030b6556621ddc595f8e787ad2d7e8655d04ac0f56b94326144ef7f84c02ff1d5157ee0dce6afba43e6
+  data.tar.gz: 1b9a694bf4a198e342814eb066ae4e0382bca37073ec6ea93aa771c05287b0d536772982d75ceb0faf9b765a24b832e04fac271d10689622430ebe73f3135fdf

data/CHANGELOG.md

@@ -1,5 +1,57 @@
+# 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.1] - 2025-07-21
+
+### Added
+
+- **Network Access Support**: New `--bind-all` flag for HTTP mode to allow access from local network
+  - Binds to `0.0.0.0` instead of `localhost` when enabled
+  - Allows connections from local network IP ranges (192.168.x.x, 10.x.x.x, 172.16.x.x)
+  - Accepts connections from `.local` domain names (e.g., `my-computer.local`)
+  - Maintains security features with origin validation and IP filtering
+
+### Improved
+
+- **Security Configuration**: Enhanced allowed origins and IP configuration when using `--bind-all`
+  - Automatically configures appropriate security settings for local network access
+  - Preserves localhost-only mode by default for security
+  - Clear documentation of security implications
+
+### Changed
+
+- HTTP server binding address is now configurable via `--bind-all` flag
+- Updated help text to include new network access option
+- Fixed typo in default response text (was showing "Rails MCP Server" instead of "Neovim MCP Server")
+
+## [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.
@@ -53,6 +53,9 @@ nvim-mcp-server --mode http
 
 # Start in HTTP mode on a custom port
 nvim-mcp-server --mode http -p 8080
+
+# Start in HTTP mode binding to all interfaces (for local network access)
+nvim-mcp-server --mode http --bind-all
 ```
 
 When running in HTTP mode, the server provides two endpoints:
@@ -60,6 +63,27 @@ When running in HTTP mode, the server provides two endpoints:
 - JSON-RPC endpoint: `http://localhost:<port>/mcp/messages`
 - SSE endpoint: `http://localhost:<port>/mcp/sse`
 
+### Network Access (HTTP Mode)
+
+By default, the HTTP server only binds to localhost for security. If you need to access the server from other machines on your local network (e.g., for testing with multiple devices), you can use the `--bind-all` flag:
+
+```bash
+# Allow access from any machine on your local network
+nvim-mcp-server --mode http --bind-all
+
+# With a custom port
+nvim-mcp-server --mode http --bind-all -p 8080
+```
+
+When using `--bind-all`:
+
+- The server binds to `0.0.0.0` instead of `localhost`
+- Access is allowed from local network IP ranges (192.168.x.x, 10.x.x.x, 172.16.x.x)
+- The server accepts connections from `.local` domain names (e.g., `my-computer.local`)
+- Security features remain active to prevent unauthorized access
+
+**Security Note**: Only use `--bind-all` on trusted networks. The server includes built-in security features to validate origins and IP addresses, but exposing any service to your network increases the attack surface.
+
 ### Logging Options
 
 The server logs to a file in your config directory by default. You can customize logging with these options:
@@ -77,12 +101,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 +220,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

@@ -32,11 +32,13 @@ if ARGV[0] == "--help" || ARGV[0] == "-h"
   puts "  --log-level LEVEL      Log level: debug, info, warn, error (default: info)"
   puts "  --mode MODE            Server mode: http or stdio (default: stdio)"
   puts "  -p, --port PORT        Port to listen on (default: 6030)"
+  puts "  --bind-all             Bind to 0.0.0.0 instead of localhost (HTTP mode only)"
   puts "  version                Display version information"
   puts "  --help, -h             Display this help message"
   puts ""
   puts "Example:"
   puts "  #{File.basename($0)} --log-level debug -p 6060"
+  puts "  #{File.basename($0)} --mode http --bind-all"
   puts "  #{File.basename($0)} --mode stdio"
   exit 0
 end
@@ -44,6 +46,7 @@ end
 # Default values
 port = 6030
 mode = "stdio"
+bind_all = false
 
 # Parse command-line arguments
 i = 0
@@ -62,6 +65,9 @@ while i < ARGV.length
       exit 1
     end
     i += 2
+  when "--bind-all"
+    bind_all = true
+    i += 1
   else
     i += 1
   end
@@ -75,15 +81,17 @@ 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
 when "http"
+  bind_address = bind_all ? "0.0.0.0" : "localhost"
+
   puts "Starting Rack application with MCP middleware on http://localhost:#{port}"
   puts "MCP endpoints:"
-  puts "  - http://localhost:#{port}/mcp/sse (SSE endpoint)"
-  puts "  - http://localhost:#{port}/mcp/messages (JSON-RPC endpoint)"
+  puts "  - http://#{bind_address}:#{port}/mcp/sse (SSE endpoint)"
+  puts "  - http://#{bind_address}:#{port}/mcp/messages (JSON-RPC endpoint)"
   puts ""
   puts "Version #{NvimMcpServer::VERSION}"
   puts ""
@@ -95,12 +103,15 @@ when "http"
   mcp_app = FastMcp.rack_middleware(
     rack_app,
     name: "nvim-mcp-server", version: NvimMcpServer::VERSION,
+    allowed_origins: bind_all ? ["127.0.0.1", "localhost", /.*\.local$/] : ["127.0.0.1", "localhost"],
+    localhost_only: !bind_all,
+    allowed_ips: bind_all ? ["192.168.0.0/16", "10.0.0.0/8", "172.16.0.0/12"] : ["127.0.0.1", "::1"],
     logger: NvimMcpServer.logger
   ) { |server| setup_mcp_tools(server) }
 
   app = Rack::Builder.new { run mcp_app }
   config = Puma::Configuration.new do |user_config|
-    user_config.bind "tcp://localhost:#{port}"
+    user_config.bind "tcp://#{bind_address}:#{port}"
     user_config.app app
   end
 

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.1"
 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,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: nvim-mcp-server
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Mario Alberto Chávez
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fast-mcp
@@ -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
@@ -137,7 +138,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 3.6.2
 specification_version: 4
 summary: MCP server for Neovim
 test_files: []