Cara Mengintegrasikan Server MCP NeoVim Menggunakan MCPHub.nvim

Bayangkan memberi tahu editor kode Anda, "Buat komponen React baru bernama Button" dan menyaksikannya terwujud di depan mata Anda. Itulah keajaiban dari MCPHub.nvim - plugin yang mengubah permainan yang membawa alat bertenaga AI langsung ke alur kerja NeoVim Anda. Dalam panduan langsung ini, kita akan mengubah editor teks Anda menjadi pendamping pengembangan cerdas menggunakan server Model Context Protocol (MCP).

Apa itu NeoVim?

NeoVim adalah editor teks modern, kuat, dan sangat dapat disesuaikan yang dibangun di atas fondasi Vim. Itu dibuat sebagai cabang dari Vim dengan tujuan memberikan pengalaman pengguna yang lebih baik dan basis kode yang lebih modern. Hal ini memungkinkan pengembangan plugin dan integrasi yang lebih mudah dengan alat eksternal, menjadikannya pilihan serbaguna untuk pengembang.

Fitur Utama NeoVim

1. Peningkatan Stabilitas: Basis kode NeoVim telah difaktorkan ulang untuk stabilitas dan kinerja yang lebih baik dibandingkan dengan pendahulunya, Vim.
2. Sistem Plugin yang Ditingkatkan: NeoVim menawarkan sistem plugin yang lebih ramah pengguna, sehingga lebih mudah untuk memperluas fungsionalitasnya dengan berbagai plugin. Ini termasuk dukungan untuk pengelola plugin populer seperti Packer, Lazy, dan Plug.
3. API Asinkron: NeoVim memiliki API asinkron, yang berarti plugin tidak akan membekukan editor selama eksekusi. Ini adalah peningkatan signifikan dibandingkan Vim, yang memiliki masalah dengan eksekusi plugin sinkron.
4. Terminal Tertanam: NeoVim menyertakan emulator terminal bawaan, memungkinkan Anda menjalankan perintah shell dan alat langsung di dalam editor.
5. Kustomisasi: Pengguna dapat menyesuaikan NeoVim secara ekstensif dengan menulis file konfigurasi mereka sendiri. Fleksibilitas ini memungkinkan pengembang untuk menyesuaikan lingkungan pengeditan mereka dengan kebutuhan dan preferensi khusus mereka.

Mode Operasi NeoVim

NeoVim beroperasi terutama dalam dua mode:

• Mode Sisip: Mode ini digunakan untuk mengetik dan mengedit teks. Anda dapat memasuki Mode Sisip dengan menekan tombol i.
• Mode Normal: Ini adalah mode default di mana Anda dapat menjalankan perintah dan menavigasi melalui file Anda. Anda dapat beralih ke Mode Normal dengan menekan tombol Esc.

Apa itu MCPHub.nvim?

MCPHub.nvim adalah plugin NeoVim yang kuat yang dirancang untuk mengintegrasikan server Model Context Protocol (MCP) ke dalam alur kerja Anda. Ini menyediakan antarmuka manajemen terpusat untuk server MCP, memungkinkan pengembang untuk mengonfigurasi, mengelola, dan berinteraksi dengan server ini langsung di dalam NeoVim.

Arsitektur dan Fungsionalitas

MCPHub.nvim menggunakan arsitektur klien-server, di mana klien Neovim berinteraksi dengan server Express (mcp-hub) yang mengelola server MCP. Arsitektur ini memastikan manajemen server yang konsisten, pemantauan status waktu nyata, dan penggunaan sumber daya yang efisien.

Saat Anda menyiapkan MCPHub.nvim, itu memulai server mcp-hub dengan port dan file konfigurasi yang Anda tentukan. Plugin ini kemudian menyediakan antarmuka REST API untuk mengelola server dan alat MCP, memungkinkan dukungan multi-klien dan pembersihan otomatis.

Mengapa MCPHub.nvim Penting untuk Pengembang

MCPHub.nvim bertindak sebagai pusat komando pribadi Anda untuk pengembangan yang dibantu AI. Alih-alih menyulap beberapa alat AI, Anda mendapatkan:

• Kontrol terpusat dari semua server MCP
• Kolaborasi waktu nyata antara model AI yang berbeda
• Manajemen sumber daya cerdas yang beradaptasi dengan alur kerja Anda
• Integrasi tanpa batas dengan plugin obrolan populer seperti CodeCompanion

Mari tingkatkan lingkungan NeoVim Anda dengan kemampuan futuristik ini.

Panduan Instalasi & Pengaturan untuk MCPHub.nvim

Persyaratan Sistem MCPHub.nvim

Sebelum instalasi, verifikasi lingkungan Anda memenuhi persyaratan ini:

Tip Pro: Instal UVX (Universal Version Executor) untuk manajemen server yang lebih baik:

npm install -g uvx

Instalasi MCPHub.nvim melalui lazy.nvim

Tambahkan konfigurasi ini ke pengaturan Neovim Anda:

{
    "ravitemer/mcphub.nvim",
    dependencies = {
        "nvim-lua/plenary.nvim",  -- Diperlukan untuk operasi asinkron
    },
    build = "npm install -g mcp-hub@latest",  -- Menginstal server MCP Hub inti
    config = function()
        require("mcphub").setup({
            -- Konfigurasi yang diperlukan
            port = 3000,  -- Port hub default
            config = vim.fn.expand("~/.config/nvim/mcpservers.json"),  -- Jalur absolut diperlukan
            
            -- Kustomisasi opsional
            log = {
                level = vim.log.levels.WARN,  -- DEBUG, INFO, WARN, ERROR
                to_file = true,  -- Membuat ~/.local/state/nvim/mcphub.log
            },
            on_ready = function()
                vim.notify("MCP Hub sedang online!")
            end
        })
    end
}

Langkah-Langkah Pasca-Instalasi:

1. Mulai ulang NeoVim
2. Verifikasi instalasi dengan :checkhealth mcphub
3. Konfirmasikan server mcp-hub sedang berjalan:

curl http://localhost:3000/api/status

Konfigurasi Server MCPHub.nvim

Buat file konfigurasi server MCP Anda di ~/.config/nvim/mcpservers.json:

{
  "mcpServers": {
    "codegen": {
      "command": "uvx",
      "args": ["mcp-server-codegen"],
      "env": {
        "OPENAI_KEY": "${ENV_YOUR_OPENAI_KEY}"  # Gunakan variabel lingkungan untuk keamanan
      }
    },
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "disabled": true,  # Aktifkan secara manual saat dibutuhkan
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

Opsi Konfigurasi Utama:

• disabled: Mulai server secara manual melalui :MCPHubStart <name>
• env: Variabel lingkungan untuk kunci API
• autostart: Atur ke false untuk server yang memakan banyak sumber daya

Panduan Pengaturan Pertama Kali MCPHub.nvim

Buka UI MCP Hub:

:MCPHub

Di antarmuka interaktif:

• Tekan S untuk memulai/menghentikan server
• Tekan T untuk mengaktifkan/menonaktifkan alat
• Tekan L untuk melihat log waktu nyata

Uji koneksi server:

:lua require("mcphub").get_hub_instance():call_tool("codegen", "ping", {}, { return_text = true })

Tip Pro: Tandai :help mcphub untuk referensi cepat ke semua perintah dan konfigurasi.

Integrasi MCPHub.nvim dengan Plugin Obrolan

Pengaturan CodeCompanion:

require("codecompanion").setup({
    strategies = {
        chat = {
            tools = {
                ["mcp"] = {
                    callback = function() 
                        return require("mcphub.extensions.codecompanion") 
                    end,
                    opts = {
                      requires_approval = true,  -- Tombol keamanan
                      temperature = 0.7  # Kontrol kreativitas
                    }
                }
            }
        }
    }
})

Integrasi Avante:

require("avante").setup({
    system_prompt = function()
        local hub = require("mcphub").get_hub_instance()
        return hub:get_active_servers_prompt()  # Prompt dinamis dengan alat yang tersedia
    end,
    custom_tools = {
        require("mcphub.extensions.avante").mcp_tool()
    }
})

Daftar Periksa Pemecahan Masalah MCPHub.nvim

Tip Pro: Untuk debugging lanjutan:

MCP_HUB_DEBUG=1 nvim  # Mengaktifkan pencatatan verbose

Kesimpulan

Dengan MCPHub.nvim, Anda tidak hanya menginstal plugin lain—Anda membuka paradigma baru pengembangan yang diperkuat AI. Dengan mengintegrasikan server MCP langsung ke NeoVim, Anda mendapatkan:

1. Otomatisasi Mudah – Hasilkan kode, refaktor sistem lama, dan kelola tugas dengan perintah sederhana.
2. Integrasi Tanpa Batas – Terhubung dengan CodeCompanion, Avante, dan plugin obrolan lainnya untuk kolaborasi AI yang lancar.
3. Alur Kerja yang Dioptimalkan – Aktifkan/nonaktifkan alat secara dinamis untuk menyeimbangkan kinerja dan penggunaan token.

Apa Selanjutnya?

1. Jelajahi Pasar MCP – Temukan server yang dibangun komunitas untuk tugas khusus (Docker, Kubernetes, pengujian API)
2. Bangun Alat Kustom – Perluas dengan Lua untuk membuat asisten AI khusus domain
3. Bergabung dengan Evolusi – Berkontribusi ke GitHub MCPHub dan bentuk masa depan pengembangan berbasis AI

Giliran Anda untuk bereksperimen! Coba perintah pemula ini:

:MCPHubCall codegen "Tulis endpoint Python Flask untuk login pengguna"  
:lua require("mcphub").toggle_server("todoist")  

Masa depan pengkodean bukan tentang mengganti pengembang—tetapi tentang memperkuat kemampuan mereka. Dengan MCPHub.nvim, masa depan itu sekarang ada di ujung jari Anda.

Dan sementara Anda melakukannya, jangan lupa untuk memeriksa Apidog untuk mempercepat alur kerja pengembangan MCP dan API Anda! 🚀