Bring your own MCP server to kagent reference architecture

Ringkasan

Solusi ini menjawab kebutuhan akan mekanisme yang terstandardisasi, aman, dan skalabel untuk mengintegrasikan server Model Context Protocol (MCP) ke lingkungan Distributed Cloud software only (GDC) dengan kagent yang di-deploy sebagai platform AI agentic.

Masalah inti yang diatasi adalah tidak adanya antarmuka terpadu untuk menghubungkan aplikasi model bahasa besar (LLM) ke sumber data dan alat yang dilokalkan dalam cluster GDC yang diatur. Arsitektur ini menyediakan framework Bring Your Own (BYO) yang memungkinkan developer men-deploy server MCP kustom yang mengekspos kemampuan perusahaan tertentu sebagai alat untuk agen AI.

Arsitektur ini mencakup protokol komunikasi antara kagent dan server MCP serta topologi komponen di GDC. Diagram ini tidak mencakup logika internal server MCP pihak ketiga.

Audiens target untuk dokumen ini mencakup administrator platform GDC, developer aplikasi AI, dan peninjau keamanan yang bertanggung jawab untuk menyetujui integrasi alat eksternal.

Fitur dan kemampuan

kagent menyediakan framework fleksibel yang memungkinkan organisasi menggunakan server MCP BYO untuk mengintegrasikan LLM dengan alat lokal atau eksklusif. Dengan kemampuan ini, agen dapat berinteraksi dengan sumber data khusus dan melakukan tugas kompleks dalam perimeter cluster GDC.

Komponen dan tanggung jawab fungsional

Arsitektur ini mencakup komponen fungsional berikut:

  • Platform agen AI (kagent): Bertindak sebagai orchestrator pusat. Alat ini mengelola siklus proses sesi agentic, mengarahkan kueri pengguna ke LLM, dan mengoordinasikan eksekusi alat melalui klien MCP.
  • LLM: Menangani natural language understanding dan penalaran. Model ini menentukan kapan alat tertentu diperlukan untuk memenuhi permintaan dan menghasilkan parameter yang diperlukan untuk memanggil alat tersebut.
  • Server MCP: Mengekspos alat tertentu melalui MCP sebagai layanan mandiri. Layanan ini menangani logika tingkat rendah dalam berinteraksi dengan sistem perusahaan backend atau repositori data.

Antarmuka dan aliran data

Arsitektur end-to-end mengandalkan antarmuka standar untuk menjaga interoperabilitas dan keamanan:

  • Transport MCP: kagent berkomunikasi dengan server MCP menggunakan JSON-RPC standar melalui transport MCP yang didukung, seperti HTTP yang Dapat Di-streaming (atau HTTP dengan SSE) atau stdio. Antarmuka ini menentukan cara alat ditemukan, dideskripsikan, dan dipanggil.
  • Aliran data: Siklus proses permintaan mengikuti langkah-langkah berikut:
    1. Pengguna mengirim perintah ke kagent.
    2. kagent meneruskan perintah ke LLM.
    3. LLM mengidentifikasi panggilan alat dan menampilkannya ke kagent.
    4. kagent meneruskan permintaan ke server MCP.
    5. Server MCP menjalankan alat terhadap sumber data lokal dan menampilkan hasilnya.
    6. kagent mengirimkan hasilnya kembali ke LLM untuk menghasilkan respons akhir.

Arsitektur

Untuk menunjukkan cara men-deploy dan menggunakan server MCP BYO, arsitektur referensi ini menggunakan aplikasi Nextcloud open source, server MCP-nya, dan agen Nextcloud di Solo Enterprise untuk kagent.

Contoh ini menyajikan model Gemma 4 menggunakan vLLM.

Arsitektur ini menghubungkan Nextcloud, kagent, dan model Gemma 4 dalam lingkungan GDC. Dalam konfigurasi ini, kagent menggunakan Nextcloud sebagai repositori data sehingga model Gemma 4 dapat mengakses dan memproses informasi di Nextcloud melalui antarmuka MCP yang terstandardisasi.

Nextcloud adalah platform kolaborasi dan penyimpanan cloud open source yang dihosting sendiri, yang mendukung deployment lokal untuk membantu Anda mempertahankan kontrol dan privasi atas data pengguna. Ini adalah komponen openDesk.

Nextcloud mencakup fitur berikut:

  • Sinkronisasi dan berbagi file: Simpan file, sinkronkan di seluruh perangkat desktop dan seluler melalui aplikasi khusus, dan bagikan menggunakan link.
  • Alat produktivitas: Gunakan kalender, kontak, pengelolaan tugas, dan program email bawaan.
  • Kolaborasi: Integrasikan suite office, seperti Collabora Online atau ONLYOFFICE, langsung ke Nextcloud untuk mengedit bersama dokumen, spreadsheet, dan presentasi secara real time.
  • Ekstensibilitas: Instal plugin dari app store untuk menambahkan fitur seperti pengelola sandi, papan Kanban, atau pemutar musik.

Solusi ini memerlukan GDC dengan kagent dan vLLM yang menyajikan model Gemma 4. Diagram berikut mengilustrasikan penyiapan validasi:

Penyiapan validasi dengan GDC, kagent, Nextcloud, dan vLLM yang menyajikan Gemma 4.

Materi tambahan