MCP — Hubungkan Hermes dengan Ribuan Tools

MCP — Hubungkan Hermes dengan Ribuan Tools

Kalau kamu pernah berharap Hermes bisa memakai tools yang sudah ada di tempat lain — bot GitHub, klien database, file browser, API internal — MCP (Model Context Protocol) adalah cara terbersih untuk mewujudkannya.

MCP memungkinkan Hermes terhubung ke server tools eksternal, jadi agen bisa memakai tools yang berada di luar Hermes itu sendiri. Anggap saja ini sebagai adaptor universal: alih-alih menulis native Hermes tool dari nol, kamu tinggal mengarahkan Hermes ke server MCP dan dia akan otomatis mendeteksi tools apa saja yang tersedia.

Apa yang MCP berikan untukmu

• Akses ke ekosistem tools eksternal tanpa perlu menulis native Hermes tool terlebih dahulu
• Server lokal maupun remote — server stdio dan server HTTP MCP bekerja dalam konfigurasi yang sama
• Penemuan tools otomatis saat startup — Hermes menemukan dan mendaftarkan semuanya secara otomatis
• Wrapper utilitas untuk resource dan prompt MCP jika server mendukungnya
• Filter per-server — tampilkan hanya tools MCP yang benar-benar kamu ingin Hermes lihat

Mulai cepat

Dukungan MCP sudah termasuk dalam instalasi standar — tidak perlu langkah tambahan. Begini cara memulainya:

1. Tambahkan server MCP ke ~/.hermes/config.yaml:

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

2. Jalankan Hermes:

hermes chat

3. Minta Hermes untuk memakai kemampuan berbasis MCP.

Contohnya:

List the files in /home/user/projects and summarize the repo structure.

Hermes akan menemukan tools dari server MCP dan memakainya seperti tools lainnya. Itu saja — tanpa konfigurasi tambahan, tanpa sintaks khusus.

Katalog: instalasi sekali klik untuk MCP yang disetujui Nous

Hermes dilengkapi dengan katalog server MCP yang sudah dikurasi dan direview oleh staf Nous. Semuanya nonaktif secara bawaan — instal hanya yang benar-benar kamu butuhkan.

hermes mcp                # pemilih interaktif (bawaan)
hermes mcp catalog        # daftar teks biasa, bisa di-script
hermes mcp install n8n    # instal entri katalog berdasarkan nama

Pemilih menampilkan setiap entri beserta statusnya saat ini:

n8n          available              Manage and inspect n8n workflows from Hermes
linear       enabled                Linear issue/project management (remote OAuth)
github       installed (disabled)   GitHub repo + PR tools

Tekan Enter pada sebuah baris untuk menginstal, mengaktifkan, menonaktifkan, atau menghapus. Entri katalog bisa memerlukan berbagai jenis kredensial:

• API key — Hermes akan memintanya saat instalasi dan menulis nilainya ke ~/.hermes/.env
• OAuth (MCP remote) — ditulis sebagai auth: oauth di konfigurasimu; klien MCP akan membuka browser saat koneksi pertama
• OAuth (penyedia pihak ketiga) — Hermes akan mengarahkanmu ke hermes auth <provider> jika kamu belum melakukan autentikasi

Seleksi tools saat instalasi

Setelah kredensial dikonfigurasi, Hermes akan memeriksa server MCP untuk mendaftar semua tools yang tersedia dan menampilkan daftar centang:

Select tools for 'linear' (SPACE toggle, ENTER confirm)
  [x] find_issues       Find issues matching a query
  [x] get_issue         Get a single issue
  [x] create_issue      Create a new issue
  [ ] delete_workspace  Delete a Linear workspace
  ...

Baris yang sudah tercentang berasal dari:

1. Pilihanmu sebelumnya jika kamu pernah menginstal entri ini
2. tools.default_enabled dari manifest jika entri tersebut mendeklarasikannya
3. Semua tools jika tidak ada yang berlaku

Kirim daftar centang dengan ENTER. Hanya tools yang dicentang yang akan masuk ke mcp_servers.<name>.tools.include. Jika kamu memilih semuanya, tidak ada filter yang ditulis — bentuk konfigurasi paling bersih, perilaku yang identik.

Jika pemeriksaan gagal (server tidak dapat dijangkau, OAuth belum selesai), instalasi tetap berhasil: default dari manifest langsung diterapkan, atau tidak ada filter yang ditulis. Jalankan ulang hermes mcp configure <name> setelah server dapat dijangkau untuk menyempurnakan.

Model kepercayaan

Menginstal entri katalog akan menjalankan apa pun yang ditentukan manifest — git clone, perintah bootstrap, dan pada akhirnya kode server MCP itu sendiri. Manifest melalui review PR ke repositori hermes-agent, jadi Nous sudah mereview setiap entri sebelum dirilis — tetapi kamu tetap harus membaca manifest sebelum menginstal, terutama repositori di kolom source:, perintah install.bootstrap:, dan pemanggilan transport.command:.

Manifest berada di optional-mcps/<name>/manifest.yaml di GitHub. Pemilih akan menampilkan URL source: dari manifest saat instalasi sehingga kamu bisa memverifikasi repositori upstream dengan cepat. Dasbor web di halaman MCP menampilkan detail yang sama untuk setiap entri katalog — transport, tipe auth, URL endpoint, sumber instalasi git, perintah bootstrap, dan catatan pengaturan — dengan source: yang dirender sebagai tautan yang bisa diklik.

Kompatibilitas versi manifest

Manifest mengunci manifest_version. Katalog bersifat kompatibel ke depan: jika sebuah PR menambahkan entri dengan versi yang lebih baru dari yang dipahami Hermes yang kamu instal, pemilih akan menampilkan peringatan (⚠ '<name>' memerlukan Hermes yang lebih baru) alih-alih menyembunyikannya secara diam-diam. Jalankan hermes update untuk menginstal Hermes terbaru saat kamu melihat peringatan itu.

Substitusi ${ENV_VAR} saat runtime

Di dalam transport.command, transport.args, transport.url, dan headers sebuah entri, placeholder ${VAR} diselesaikan saat runtime dari environment-mu — jadi kamu bisa menyimpan rahasia di luar konfigurasi dan mereferensikannya secara dinamis.

Berpindah dari Claude Code?

Blok mcpServers di ~/.claude.json milikmu terpetakan ke mcp_servers di config.yaml Hermes — dan hermes import-agent claude-code akan memigrasikannya secara otomatis (beserta skills dan instructions).

MCP adalah cara tercepat untuk memberi Hermes kekuatan super tanpa harus menemukan kembali roda. Coba sekarang juga.