mcpserver.nvim

mcpserver.nvim

Unix ソケットを通じて外部の MCP クライアントが Neovim とやり取りできるようにする、MCP（Model Context Protocol）サーバーを実装した Neovim プラグインです。

機能

• get_buffer_content：現在のバッファーの内容を取得します

インストール

lazy.nvim を使用する場合：

{
  dir = "/path/to/mcpserver.nvim", -- Use your local path
  -- Server starts automatically on VimEnter
}

使用方法

Neovim プラグイン

手動での制御

MCP サーバーを起動します：

:MCPServerStart

MCP サーバーを停止します：

:MCPServerStop

ソケットパスの取得

local mcpserver = require('mcpserver')
local socket_path = mcpserver.get_socket_path()
print(socket_path) -- e.g., "/tmp/nvim-mcp-server-12345.sock"

ソケットの場所

サーバーは、<PID> が Neovim プロセスの ID を表す /tmp/nvim-mcp-server-<PID>.sock に、一意の Unix ソケットを作成します。これにより、複数の Neovim インスタンスで MCP サーバーを同時に実行できます。

スタンドアロン MCP サーバー

stdio 経由で通信する外部 MCP クライアントで使用します：

# Auto-detect running Neovim instance
lua standalone.lua

# Specify Neovim socket path
lua standalone.lua /tmp/nvim-mcp-server-12345.sock

スタンドアロンサーバーは以下のとおりです：

• stdio（stdin/stdout 経由の JSON-RPC）で通信します
• 実行中の Neovim MCP サーバーソケットを自動検出します
• リクエストを Neovim インスタンスに転送します
• stdio トランスポートをサポートするすべての MCP クライアントで動作します

利用可能なツール

get_buffer_content

以下を含む JSON を返します：

• filename：現在のバッファーファイルのパス
• content：バッファーの全文
• line_count：バッファー内の行数

MCP クライアントでの使用方法

ソケットへの直接接続

/tmp/nvim-mcp-server-<PID>.sock の Unix ソケットに接続し、標準の MCP プロトコルを使用します：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_buffer_content",
    "arguments": {}
  }
}

stdio 接続

stdio ベースの MCP クライアントには、スタンドアロンサーバーを使用します：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_buffer_content","arguments":{}}}' | lua standalone.lua

開発

プラグインの構成：

• lua/mcpserver/init.lua：MCP サーバーのコア実装
• lua/mcpserver/tools.lua：ツールの実装
• plugin/mcpserver.lua：プラグインのセットアップとコマンド
• standalone.lua：stdio 通信向けのスタンドアロン MCP サーバー

要件

• Lua をサポートする Neovim
• スタンドアロンモードの場合：Unix ソケット通信に netcat（nc）が必要