Vim MCP

🚀 vim-mcp

VimとClaude CodeにシンプルなMCP（Model Context Protocol）を統合します。

🚀 クイックスタート

vim-mcpは、VimとClaude Codeを連携させるためのツールです。以下の手順に従ってインストールと設定を行い、VimとClaude Codeを連携して利用しましょう。

✨ 主な機能

• Claude CodeをVimインスタンスに接続する
• Vimの状態（バッファ、ウィンドウ、カーソル位置など）を問い合わせる
• 実行中のVimが1つのみの場合、自動的にインスタンスを選択する
• 選択プロンプトを使った複数のVimインスタンスのサポート

📦 インストール

1. Vimプラグインのインストール

好みのプラグインマネージャを使って .vimrc に追加します。

" Using vim-plug
Plug '~/Project/vim-mcp2/vim-mcp-plugin'

" Or manually copy vim-mcp.vim to ~/.vim/plugin/

2. Node.js依存関係のインストール

cd ~/Project/vim-mcp2/vim-mcp-server
npm install

3. Claude Codeの設定

Claude CodeのMCP設定ファイル (~/.config/claude-code/mcp-servers.json) に以下を追加します。

{
  "mcpServers": {
    "vim-mcp": {
      "command": "node",
      "args": ["/Users/iirianto/Project/vim-mcp2/vim-mcp-server/index.js"]
    }
  }
}

💻 使用例

基本的な使用法

Claude Codeでの基本コマンド

1. Vimへの接続

   • "Connect to Vim" - Vimインスタンスに接続します（実行中のVimが1つのみの場合は自動選択）
   • "List Vim instances" - 利用可能なすべてのVimインスタンスを表示します
   • "Select vim instance [id]" - 特定のインスタンスに接続します

2. Vimの状態の問い合わせ

   • "How many buffers do I have?"
   • "What buffers are open?"
   • "What is my cursor position?"
   • "Show me the current buffer content"
   • "What windows are open?"

Vimコマンド

プラグインはVimが開くと自動的に起動します。以下のコマンドも利用できます。

• :VimMCPStatus - プラグインが実行中かどうかを確認します
• :VimMCPRestart - MCP接続を再起動します
• :VimMCPStop - MCPサーバーを停止します

🔧 技術詳細

仕組み

1. 各Vimインスタンスは /tmp/vim-mcp-{instance-id}-state.json に状態ファイルを作成します
2. Vimは /tmp/vim-mcp-registry.json に自身を登録します
3. Vimは状態ファイルを継続的に更新します（1秒ごと）
4. MCPサーバーは状態ファイルを直接読み取り、Vimの状態を問い合わせます
5. Claude CodeはModel Context Protocolを介してMCPサーバーと通信します

必要条件

• Vim 8+ または Neovim 0.5+
• Node.js 18+
• /tmp ディレクトリへのファイルシステムアクセス
• クロスプラットフォーム対応（Linux/macOS/Windows）

トラブルシューティング

1. Vimインスタンスが見つからない場合

   • Vimがプラグインとともに実行されていることを確認します
   • Vimで :VimMCPStatus を確認します
   • 状態ファイルが存在することを確認します: ls /tmp/vim-mcp-*-state.json

2. 状態読み取りエラーの場合

   • レジストリファイルを確認します: cat /tmp/vim-mcp-registry.json
   • 状態ファイルを確認します: cat /tmp/vim-mcp-{instance-id}-state.json
   • Vimプラグインを再起動します: :VimMCPRestart
   • Vimのエラーを確認します: :messages

3. 古いファイルのクリーンアップ

rm /tmp/vim-mcp-*-state.json
rm /tmp/vim-mcp-registry.json

開発

MCPサーバーを直接実行するには、以下のコマンドを実行します。

cd vim-mcp-server
node index.js

サーバーはMCP通信にstdioを使用し、Vimの状態をJSON状態ファイルから読み取ります。

プロジェクト構造

vim-mcp2/
├── vim-mcp-plugin/          # Vimプラグインディレクトリ
│   └── vim-mcp.vim         # VimScriptプラグインファイル
├── vim-mcp-server/          # Node.js MCPサーバー
│   ├── index.js            # メインサーバーファイル
│   ├── package.json        # Node.js依存関係
│   └── package-lock.json   # 依存関係のロックファイル
├── docs/                    # ドキュメント
└── README.md               # このファイル