はじめに
最近よく聞くMCPですが、Neovimでも使えるようです。
今回はmcphubというプラグインを使用します。
前提
-
Neovimと生成AIを統合するプラグインで主流なものとしてavanteとcodecompanionの2つがありますが、今回はavanteを使った手順を紹介します
-
プラグインマネージャはlazyを使用しますが、他のプラグインを使っている方は適宜置き換えてください
MCPサーバを利用する場合、AIが意図しないリソースへアクセスする場合があります。
ツール利用の自動承認をOFFにする(今回紹介するプラグインではデフォルトでOFFになっています)などして、業務コードなどの秘匿情報は各自の責任で保護してください。
インストール手順
1. avanteのインストール
mcphubはチャットツールがないと使えないので、まずはavanteをインストールします。
公式のインストール手順をコピペします。
{
"yetone/avante.nvim",
event = "VeryLazy",
version = false, -- Never set this value to "*"! Never!
opts = {
-- add any opts here
-- for example
provider = "openai",
openai = {
endpoint = "https://api.openai.com/v1",
model = "gpt-4o", -- your desired model (or use gpt-4o, etc.)
timeout = 30000, -- Timeout in milliseconds, increase this for reasoning models
temperature = 0,
max_completion_tokens = 8192, -- Increase this to include reasoning tokens (for reasoning models)
--reasoning_effort = "medium", -- low|medium|high, only used for reasoning models
},
},
-- if you want to build from source then do `make BUILD_FROM_SOURCE=true`
build = "make",
-- build = "powershell -ExecutionPolicy Bypass -File Build.ps1 -BuildFromSource false" -- for windows
dependencies = {
"nvim-treesitter/nvim-treesitter",
"stevearc/dressing.nvim",
"nvim-lua/plenary.nvim",
"MunifTanjim/nui.nvim",
--- The below dependencies are optional,
"echasnovski/mini.pick", -- for file_selector provider mini.pick
"nvim-telescope/telescope.nvim", -- for file_selector provider telescope
"hrsh7th/nvim-cmp", -- autocompletion for avante commands and mentions
"ibhagwan/fzf-lua", -- for file_selector provider fzf
"nvim-tree/nvim-web-devicons", -- or echasnovski/mini.icons
"zbirenbaum/copilot.lua", -- for providers='copilot'
{
-- support for image pasting
"HakonHarnes/img-clip.nvim",
event = "VeryLazy",
opts = {
-- recommended settings
default = {
embed_image_as_base64 = false,
prompt_for_file_name = false,
drag_and_drop = {
insert_mode = true,
},
-- required for Windows users
use_absolute_path = true,
},
},
},
{
-- Make sure to set this up properly if you have lazy=true
'MeanderingProgrammer/render-markdown.nvim',
opts = {
file_types = { "markdown", "Avante" },
},
ft = { "markdown", "Avante" },
},
},
}
その後、接続するプロバイダによってシェルに環境変数を設定します。
↓公式から引用
For Claude:
export ANTHROPIC_API_KEY=your-api-key
For OpenAI:
export OPENAI_API_KEY=your-api-key
For Azure OpenAI:
export AZURE_OPENAI_API_KEY=your-api-key
For Amazon Bedrock:
export BEDROCK_KEYS=aws_access_key_id,aws_secret_access_key,aws_region[,aws_session_token]
Note: The aws_session_token is optional and only needed when using temporary AWS credentials
自分は.zshrcで自動的に設定するようにしています。
if [ -f "$HOME/openai_api_key" ]; then
export OPENAI_API_KEY=$(cat "$HOME/openai_api_key")
fi
環境変数の設定が済んだら、Neovimからavanteを起動します。
デフォルトのキーバインドは<leader>aaです。
こんな感じで右側にプロンプトが表示されれば成功です。
avante単体でも触ってて面白いと思うので、mcphubのインストールに進む前に色々触ってみてください。
2. mcphubのインストール
avanteを使えるようになったので、次にmcphubをインストールします。
mcphubをインストールする前に、以下をターミナルで実行しておいてください。
mcphubが参照するファイルが存在しない場合、Neovim実行時エラーになるので事前に手動で作成します。
mkdir -p ~/.config/mcphub
echo '{ "mcpServers": {} }' > ~/.config/mcphub/servers.json
ではプラグインのインストールです。
公式のインストール手順をコピペします。
{
"ravitemer/mcphub.nvim",
dependencies = {
"nvim-lua/plenary.nvim", -- Required for Job and HTTP requests
},
-- uncomment the following line to load hub lazily
--cmd = "MCPHub", -- lazy load
build = "npm install -g mcp-hub@latest", -- Installs required mcp-hub npm module
-- uncomment this if you don't want mcp-hub to be available globally or can't use -g
-- build = "bundled_build.lua", -- Use this and set use_bundled_binary = true in opts (see Advanced configuration)
config = function()
require("mcphub").setup()
end,
keys = {
{ "<leader>m", "<cmd>MCPHub<cr>", desc = "Open MCPHub" },
},
}
追加で自分は<leader>mでmcphubのUIを起動するキーバインドを組んでいます。
お好みに変更してください。
次に、avanteとmcphubを統合するためにavante側の設定を書き換えます。
以下をコピペします。
{
"yetone/avante.nvim",
event = "VeryLazy",
version = false, -- Never set this value to "*"! Never!
opts = {
-- add any opts here
-- for example
provider = "openai",
openai = {
endpoint = "https://api.openai.com/v1",
model = "gpt-4o", -- your desired model (or use gpt-4o, etc.)
timeout = 30000, -- Timeout in milliseconds, increase this for reasoning models
temperature = 0,
max_completion_tokens = 8192, -- Increase this to include reasoning tokens (for reasoning models)
--reasoning_effort = "medium", -- low|medium|high, only used for reasoning models
},
-- system_prompt as function ensures LLM always has latest MCP server state
-- This is evaluated for every message, even in existing chats
system_prompt = function()
local hub = require("mcphub").get_hub_instance()
return hub:get_active_servers_prompt()
end,
-- Using function prevents requiring mcphub before it's loaded
custom_tools = function()
return {
require("mcphub.extensions.avante").mcp_tool(),
}
end,
disabled_tools = {
"list_files",
"search_files",
"read_file",
"create_file",
"rename_file",
"delete_file",
"create_dir",
"rename_dir",
"delete_dir",
"bash",
},
},
-- if you want to build from source then do `make BUILD_FROM_SOURCE=true`
build = "make",
-- build = "powershell -ExecutionPolicy Bypass -File Build.ps1 -BuildFromSource false" -- for windows
dependencies = {
"ravitemer/mcphub.nvim",
"nvim-treesitter/nvim-treesitter",
"stevearc/dressing.nvim",
"nvim-lua/plenary.nvim",
"MunifTanjim/nui.nvim",
--- The below dependencies are optional,
"echasnovski/mini.pick", -- for file_selector provider mini.pick
"nvim-telescope/telescope.nvim", -- for file_selector provider telescope
"hrsh7th/nvim-cmp", -- autocompletion for avante commands and mentions
"ibhagwan/fzf-lua", -- for file_selector provider fzf
"nvim-tree/nvim-web-devicons", -- or echasnovski/mini.icons
"zbirenbaum/copilot.lua", -- for providers='copilot'
{
-- support for image pasting
"HakonHarnes/img-clip.nvim",
event = "VeryLazy",
opts = {
-- recommended settings
default = {
embed_image_as_base64 = false,
prompt_for_file_name = false,
drag_and_drop = {
insert_mode = true,
},
-- required for Windows users
use_absolute_path = true,
},
},
},
{
-- Make sure to set this up properly if you have lazy=true
'MeanderingProgrammer/render-markdown.nvim',
opts = {
file_types = { "markdown", "Avante" },
},
ft = { "markdown", "Avante" },
},
},
}
mcphubのインストールが完了したら、:MCPHubを実行します。
keysでキーバインドを設定している方はキーバインドで実行しても問題ないです。
こんな感じになったら成功です
使ってみる
サーバのインストール
早速mcphub経由でmcpサーバをインストールしてみます。
今回はfile-systemとGit Toolsのサーバをインストールしてみます。
mcphubのUIでCを押して設定ファイルを開いた後、eを押して編集に入ります。
以下をコピペします。フォルダ指定のところだけ書き換えてください。
{
"mcpServers": {
"file-system": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/allowed/dir"
]
},
"git-tools": {
"command": "uvx",
"displayed": false,
"args": ["mcp-server-git"]
}
}
}
各サーバのインストール過程でnpxとuvxを使うので、用意してください。
その後、mcphubのUIでHを押してホームに戻りRで再起動します。
再起動後、このようになっていれば成功です！
インストールできるサーバ一覧はmcphubのUIでMを押すとみれます。
本来サーバをインストールするときはavante経由でインストールできるのですが、実行時すると~/.config/mcphub/servers.jsonの編集権限がなく実行できなかったので今回は自動インストールにしています。
チャットで指示する
適当なプロジェクトをNeovimで開いて、avanteのプロンプトで修正指示やコミットの指示を投げてみてください。
AIがツールを使ってファイル修正やコミットをしてくれると思います。
最後に
Neovimがまだまだ現役で活躍してくれそうで嬉しいです！