İçeriğe geç
AggregaAggrega
Dil seçin: Türkçe
Bu sayfa makine çevirisiyle çevrilmiştir. İngilizce orijinalini okuyun.

Bir MCP istemci yapılandırmasını içe aktarma — bir kodlama asistanının kullandığı üç sunucu

Üç Model Context Protocol sunucusunu listeleyen bir Claude Code .mcp.json dosyası — ikisi bir komut satırından başlatılan, biri başka birinin çalıştırdığı — aggrega import ile Aggrega dosyalarına taslak olarak aktarılmış, her sunucu nasıl çalıştığına karşılık gelen gerçekleştirime eşlenmiş ve Kubernetes için derlenmiş.

Bir MCP istemci yapılandırmasını içe aktarma bunu adım adım anlatır: komutu, yazdığı dosyaları ve her satırın neden orada olduğunu, derlemeyi ve çalışan sunucuları. Bu klasör, o adım adım anlatımın her aşamasını içerir:

klasör veya dosyaiçeriği
source/istemci yapılandırması, .mcp.json, klasörü bir çalışma alanı yapan .aggrega-config.yaml ve GitHub sunucusunun belirtecinin okunduğu Kubernetes Secret’ının adını içeren import-answers.yaml
draft/aggrega import .mcp.json --target helm komutunun yazdığı dosyalar, değiştirilmemiş haliyle, release.lock dahil, ve komutun yazdırdıkları: standart çıktıya stdout.txt, standart hataya import.txt

Belge deposunun bir checkout’unda check.sh, içe aktarmayı yeniden çalıştırır, yazdıklarını ve yazdırdıklarını draft/ ile karşılaştırır, adım adım anlatımın alıntıladığı blokları bu dosyalarla karşılaştırır ve içe aktarmanın yazdıklarını doğrulayıp derler. Standart kütüphane kataloğunun (nereden edinilir) bu deponun yanında checkout edilmiş olmasına ya da dizininin AGGREGA_CATALOG_DIRS içinde belirtilmesine ihtiyaç duyar.

Örneği oluşturun

Bu örneğin içe aktarmasını aşağıdaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin yerinize çalıştırtabilirsiniz.

Örneği, adını taşıyan yeni bir klasöre yazın:

Terminal window
aggrega scaffold --example import-mcp

Ardından sırada çalıştırılacak komutları yazdırır. İlki yeni klasöre geçer:

Terminal window
cd import-mcp

Derleme

İçe aktarma, Aggrega dosyalarını projenin yanında, source/ içinde taslak olarak oluşturur. Projeyi, çalışma alanının varsayılan kayıt defterinin imzalı bir anlık görüntü olarak yayımladığı standart kütüphane kataloğuyla karşılaştırır: ilk içe aktarma onu getirir, doğrular, çalışma alanının içerik önbelleğinde tutar ve taslakların yanına yazdığı kayıtta onu özet değeriyle adlandırır. Kendi katalog klasörlerini — AGGREGA_CATALOG_DIRS içinde veya workspace.catalog_dirs altında — belirten bir çalışma alanı bunun yerine bunlara göre içe aktarır. İçe aktarma, Secret’ın adını import-answers.yaml dosyasından okur, ardından taslak Release’in bağımlı olduğu şeyleri çeker; böylece derleme hemen ardından gelir:

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

Derleme, Kubernetes manifestlerini dist/helm/ altına yazar; Secret’ı oluşturmak ve manifestleri uygulamak yukarıda bağlantısı verilen adım adım anlatımda yer alır.

Bir yapay zekâ asistanıyla

Aggrega araçlarıyla kurulmuş bir yapay zekâ asistanı da aynısını yapabilir: bu istemi ona yapıştırın.

Yalnızca Aggrega araçlarını kullanın ve kendiniz hiçbir klasör oluşturmayın. Çalışma alanı klasöründe henüz bir `import-mcp` klasörü yoksa `scaffold` aracını `example` değeri `import-mcp` olacak şekilde ve `dir` olmadan bir kez çağırın: araç örneği yeni bir `import-mcp` klasörüne yazar; bu klasörün içindeki `source` klasörü, bu örneğin içe aktardığı şeyleri içerir. Ardından `import` aracını `workspace_root` değeri `import-mcp/source`, `source` değeri `.mcp.json` ve `target` değeri `helm` olacak şekilde çağırın: araç ihtiyaç duyduğu yanıtları `.mcp.json` dosyasının yanındaki `import-answers.yaml` dosyasından okur, taslaklarını `import-mcp/source` içine yazar ve taslakların ihtiyaç duyduklarını çeker. Ardından `validate` aracını `workspace_root` değeri `import-mcp/source` ve `release` değeri `release.yaml` olacak şekilde, `build` aracını da `workspace_root` değeri `import-mcp/source`, `release` değeri `release.yaml` ve `write` değeri true olacak şekilde çağırın. Derlemenin hangi dosyaları yazdığını bana söyleyin; bunlar `import-mcp/source/dist/` altındadır.

Test edin

Derleme uygulandıktan sonra yerel bir portu fetch sunucusunun Service’ine yönlendirin ve komutu çalışır durumda bırakın:

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

Başka bir terminalden, sunucudan MCP’nin initialize isteğiyle bir oturum açmasını isteyin:

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"}}}

Kılavuz aynı çağrıyı Docker Compose üzerinde ve GitHub sunucusuna da yapar.