Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

Mengimpor konfigurasi klien MCP — tiga server yang digunakan asisten pemrograman

.mcp.json milik Claude Code yang mencantumkan tiga server Model Context Protocol — dua dijalankan dari baris perintah dan satu dijalankan oleh pihak lain — dijadikan draf berkas Aggrega oleh aggrega import, dengan setiap server dipetakan ke realisasi yang sesuai dengan cara server itu berjalan, dan di-build untuk Kubernetes.

Mengimpor konfigurasi klien MCP membahasnya langkah demi langkah: perintahnya, berkas yang ditulisnya dan alasan setiap barisnya ada, build-nya, serta server yang berjalan. Folder ini memuat setiap tahap dari panduan tersebut:

folder atau berkasisinya
source/konfigurasi klien, .mcp.json, .aggrega-config.yaml yang menjadikan folder ini ruang kerja, dan import-answers.yaml, nama Secret Kubernetes tempat token server GitHub dibaca
draft/berkas yang ditulis oleh aggrega import .mcp.json --target helm, tanpa diubah, termasuk release.lock, dan apa yang dicetaknya: stdout.txt pada keluaran standar, import.txt pada galat standar

Dalam checkout repositori dokumentasi, check.sh menjalankan impor lagi, membandingkan apa yang ditulis dan dicetaknya dengan draft/, membandingkan blok yang dikutip panduan dengan berkas-berkas ini, serta memvalidasi dan mem-build apa yang ditulis oleh impor. Skrip ini memerlukan katalog pustaka standar (cara mendapatkannya) yang di-checkout di samping repositori ini, atau direktorinya disebutkan dalam AGGREGA_CATALOG_DIRS.

Membuat contoh

Anda dapat menjalankan impor contoh ini dengan perintah di bawah, atau meminta asisten AI Anda menjalankannya untuk Anda.

Tulis contoh ke folder baru yang dinamai sesuai contoh itu:

Terminal window
aggrega scaffold --example import-mcp

Kemudian ia mencetak perintah yang dijalankan berikutnya. Perintah pertama berpindah ke folder baru:

Terminal window
cd import-mcp

Build

Impor membuat draf berkas Aggrega di samping proyek, di source/. Impor menimbang proyek terhadap katalog pustaka standar, yang diterbitkan oleh registri bawaan ruang kerja sebagai snapshot bertanda tangan: impor pertama mengambilnya, memverifikasinya, menyimpannya di cache konten ruang kerja, dan menyebutnya dengan digest-nya dalam catatan yang ditulisnya di samping draf. Ruang kerja yang menyebutkan folder katalognya sendiri — di AGGREGA_CATALOG_DIRS, atau di bawah workspace.catalog_dirs — mengimpor terhadap folder tersebut sebagai gantinya. Impor membaca nama Secret dari import-answers.yaml, lalu menarik apa yang menjadi dependensi Release hasil draf, sehingga build dapat langsung menyusul:

Terminal window
cd source
aggrega import .mcp.json --target helm
aggrega build --release release.yaml

Build menulis manifes Kubernetes di bawah dist/helm/; cara membuat Secret dan menerapkan manifes tersebut ada di panduan yang ditautkan di atas.

Dengan asisten AI

Asisten AI yang disiapkan dengan tool Aggrega dapat melakukan hal yang sama: tempelkan prompt ini ke asisten tersebut.

Gunakan hanya alat Aggrega, dan jangan membuat folder sendiri. Jika folder ruang kerja belum berisi folder `import-mcp`, panggil alat `scaffold` sekali dengan `example` diatur ke `import-mcp` dan tanpa `dir`: alat itu menulis contoh ke folder `import-mcp` yang baru, dengan folder `source` di dalamnya yang berisi apa yang diimpor contoh ini. Lalu panggil alat `import` dengan `workspace_root` diatur ke `import-mcp/source`, `source` diatur ke `.mcp.json`, dan `target` diatur ke `helm`: alat itu membaca jawaban yang dibutuhkannya dari `import-answers.yaml` di samping `.mcp.json`, menulis drafnya ke `import-mcp/source`, dan menarik apa yang dibutuhkan draf tersebut. Lalu panggil alat `validate` dengan `workspace_root` diatur ke `import-mcp/source` dan `release` diatur ke `release.yaml`, serta alat `build` dengan `workspace_root` diatur ke `import-mcp/source`, `release` diatur ke `release.yaml`, dan `write` diatur ke true. Beri tahu saya berkas mana yang ditulis build; berkas tersebut berada di bawah `import-mcp/source/dist/`.

Mengujinya

Setelah build diterapkan, teruskan sebuah port lokal ke Service milik server fetch dan biarkan perintah tetap berjalan:

Terminal window
kubectl port-forward svc/fetch-default 8080:8080

Dari terminal lain, minta server membuka sesi dengan permintaan initialize milik MCP:

Terminal window
curl -sS http://127.0.0.1:8080/mcp \
-H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test-it", "version": "1.0.0"}}}'
: keepalive
: keepalive
event: message
data: {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"prompts":{"listChanged":false},"resources":{"listChanged":false,"subscribe":false},"tools":{"listChanged":false}},"protocolVersion":"2025-06-18","serverInfo":{"name":"mcp-fetch","version":"2026.11.11"}}}

Panduan melakukan panggilan yang sama di Docker Compose dan ke server GitHub.