** keymaps 및 MCP 도구로 작업하는 Lua 도구. **

---

나는 다른 편집기를 떠나지 않고 Neovim에서 AI 툴링을 원했습니다. 그래서 나는 이것을 만들었습니다.

buddy.nvim는 Neovim 내부 MCP 서버를 실행합니다. Claude, OpenCode 또는 MCP 클라이언트가 연결하고 실제로 편집기를 제어 할 수 있습니다. 버퍼, 파일 편집, 명령 실행, 탐색. 그냥 채팅.

Lua에서 도구를 작성합니다. 그들은 MCP 도구 (AI 호출)로 작동 and 정규적인 Neovim 플러그인 (keymaps, 명령, autocmds). 동일한 부호, 둘 다 공용영역.

---

설치

게으른.nvim

패커.nvim

수동

Neovim 패키지 디렉토리에 Clone:

---

MCP 클라이언트 연결

buddy.nvim는 ** HTTP + Server-Sent Events (SSE)**를 사용하여 현대 MCP 클라이언트와 호환됩니다.

연결할 수있는 두 가지 방법이 있습니다.

옵션 A: 프록시를 통해 (추천)

buddy-mcp-proxy 자동적으로 네오빅 세션을 실행하고, auth 토큰을 전달하고, 여러 인스턴스 사이의 전환을 지원합니다. 포트 구성이 필요 없습니다. Node.js 20+를 요구합니다.

오픈코드

~/.config/opencode/opencode.jsonc에 추가:

Claude 데스크탑

Claude 데스크탑 구성에 추가:

buddy.nvim

Lua tools that work as keymaps AND as MCP tools.

---

I wanted AI tooling in Neovim without leaving for another editor. So I built this.

buddy.nvim runs an MCP server inside Neovim. Claude, OpenCode, or any MCP client can connect and actually control your editor: read buffers, edit files, run commands, navigate. Not just chat.

You write tools in Lua. They work as MCP tools (AI calls them) and as regular Neovim plugins (keymaps, commands, autocmds). Same code, both interfaces.

---

Installation

lazy.nvim

{
  "arismoko/buddy.nvim",
  dependencies = {
    "nvim-mini/mini.nvim",
    "nvim-neotest/nvim-nio",
  },
  lazy = false,
  config = function()
    require("buddy").setup({
      auto_start = true,
      port = 7234,
    })
  end,
}

packer.nvim

use {
  "arismoko/buddy.nvim",
  requires = {
    "nvim-mini/mini.nvim",
    "nvim-neotest/nvim-nio",
  },
  config = function()
    require("buddy").setup({
      auto_start = true,
      port = 7234,
    })
  end,
}

Manual

Clone to your Neovim packages directory:

git clone https://github.com/arismoko/buddy.nvim ~/.local/share/nvim/site/pack/plugins/start/buddy.nvim

---

Connecting MCP Clients

buddy.nvim uses HTTP + Server-Sent Events (SSE) transport, compatible with modern MCP clients.

There are two ways to connect:

Option A: Via Proxy (Recommended)

The buddy-mcp-proxy automatically discovers running Neovim sessions, forwards auth tokens for you, and supports switching between multiple instances. No port configuration needed. Requires Node.js 20+.

npm install -g buddy-mcp-proxy

OpenCode

Add to ~/.config/opencode/opencode.jsonc:

{
  "mcp": {
    "vim": {
      "type": "local",
      "command": ["npx", "buddy-mcp-proxy"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vim": {
      "command": "npx",
      "args": ["buddy-mcp-proxy"]
    }
  }
}

Option B: Direct SSE Connection

Connect directly to a specific Neovim instance by URL. Simpler, but you must know the port and can only connect to one session.