İç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

Bu adım adım kılavuz, bir kodlama asistanının yapılandırıldığı Model Context Protocol sunucularını — ikisini asistan bir komut satırından başlatır, birini ise başka biri çalıştırır — içe aktarır ve bir kümede çalışan bir ajanın aynı araçlara ulaşabilmesi için sunucuları Kubernetes için derler. İçe aktarma, derlemenin okuduğu her dosyayı taslak olarak hazırlar: her sunucunun komut satırı veya adresi, onu çalıştıran gerçekleştirme ve GitHub sunucusunun belirtecinin nereden geldiği. Aşağıdaki her dosya ve her çıktı bloğu gerçek bir çalıştırmadan gelir; yapılandırma ve kılavuzun her aşaması import-mcp örneğindedir; orada bir denetim betiği içe aktarmayı yeniden çalıştırır, yazdıklarını, yazdırdıklarını ve bu sayfanın alıntıladığı blokları orada tutulan dosyalarla karşılaştırır ve içe aktarmanın yazdıklarını doğrulayıp derler.

Örneği oluşturun

Bu içe aktarmayı bu sayfadaki komutlarla çalıştırabilir ya da yapay zekâ asistanınıza sizin için ç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; ondan sonraki, aşağıda, yeni klasörün içindeki, bu sayfanın içe aktardıklarını barındıran ve içe aktarmanın çalıştığı yer olan source klasörüne geçer:

Terminal window
cd import-mcp

Visual Studio Code'da açılmış, iskeleti oluşturulan örneğin source klasörü; github, fetch ve docs-search olmak üzere üç sunucu içeren MCP yapılandırmasını gösteriyor.

Yapılandırma

Claude Code’un bir projenin kökündeki .mcp.json dosyası:

{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
}
},
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
},
"docs-search": {
"type": "http",
"url": "https://mcp.example.com/docs/mcp",
"headers": {
"Authorization": "Bearer ${DOCS_API_KEY}"
}
}
}
}

İçe aktarma, Claude Desktop’ın claude_desktop_config.json, Cursor’ın .cursor/mcp.json, Visual Studio Code’un .vscode/mcp.json dosyalarını ve bir MCP kayıt defterinin server.json dosyasını da aynı şekilde okur. Yapılandırmanın yanındaki bir .aggrega-config.yaml, klasörü bir çalışma alanı yapar:

# The workspace key marks this directory as the workspace root, so an import run
# here writes its drafts beside .mcp.json.
workspace: {}
# The registry the importer is fetched from the first time an import needs it.
default_registry: hub.aggrega.ai

--target, kataloğun Recipes’inden bir Manifest taslağı oluşturur. Çalışma alanı hiçbir katalog klasörü belirtmediği için içe aktarma, standart kütüphane kataloğunu içe aktarıcısını getirdiği kayıt defterinden okur. Bu, yayımlanmış kataloğun imzalı bir anlık görüntüsüdür: ilk içe aktarma onu getirir, doğrular ve çalışma alanının içerik önbelleğinde tutar; içe aktarmanın taslaklarının yanına yazdığı kayıt da onu özetiyle adlandırır. Kendi katalog klasörlerini AGGREGA_CATALOG_DIRS içinde veya workspace.catalog_dirs altında belirten bir çalışma alanı ise bunun yerine bunlara göre içe aktarır.

Yanıt dosyası

Kubernetes’te GitHub sunucusu belirtecini kümenin tuttuğu bir Secret’tan okur ve hiçbir MCP yapılandırması bu Secret’ı adlandırmaz: yapılandırma belirteci kabuğunuzun GITHUB_TOKEN değişkeninden okur. Bu nedenle içe aktarma, Secret’ın adını sorar. Örnek, yanıtı içe aktarmanın onu aradığı yerde, .mcp.json’un yanındaki import-answers.yaml dosyasında tutar:

# Values the import could not draft from the source, keyed by the drafted file and the key path inside
# it. Write each one beside its key; an import of the same source, and a sync, read them from here and
# ask nothing. A secret is never written here: its key asks where the secret comes from — a variable
# name, ${NAME}, or the name of a Kubernetes Secret.
release.yaml:
# The origin of the secret value, written by the operator in the Release. Read exactly as
# values.origin is. Write it here or in values.origin, never in both. A secret: name where it comes
# from, never the value.
spec.components.github.features.server_env.infra.origin: "github-mcp-token"

İçe aktarma, yanıt olmadan ilk kez çalıştırıldığında dosyayı kendisi yazdı: soru soracağı bir terminal olmadığından geri kalan her şeyin taslağını oluşturdu, Secret’ın adını boş bıraktı, anahtarı dosyada listeledi ve şu iletiyle durdu

1 value the drafts leave empty is still owed, listed in the answers file <workspace>/import-answers.yaml: write it beside its key there, then run the import again

Bir terminalde ise bunun yerine soruyu sorar ve yanıtı bir sonraki içe aktarma için dosyaya yazar. Yanıt, Secret’ın adı olan github-mcp-token’dır, asla belirtecin kendisi değildir. İçe aktarma yanıtları dosyası dosyayı ve soruları eksiksiz açıklar.

aggrega import, komutun aldığı her bayrağı listeler; bunlar arasında başka bir yerde tutulan bir yanıtlar dosyasını adlandıran --answers da vardır.

source klasörüne geçin:

Terminal window
cd source

İçe aktarmayı çalıştırma

Terminal window
aggrega import .mcp.json --target helm

Standart çıktıda yazdıklarını listeler:

wrote aggregate.yaml
wrote release.yaml
wrote manifest.yaml
wrote .aggrega-import.json

Standart hatada, <workspace> onu çalıştırdığınız klasörü temsil edecek şekilde:

[… omitted: a warning that the importer runs unverified, printed where its module is read from beside its Plugin entity in a catalog folder rather than fetched]
read as the mcp format, with drafted paths relative to <workspace>
warn: the value of infra.stdio_command.0 of node github is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
warn: the value of infra.stdio_command.1 of node github is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
warn: the value of infra.stdio_command.2 of node github is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
warn: the value of infra.stdio_command.0 of node fetch is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
warn: the value of infra.stdio_command.1 of node fetch is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
warn: the value of headers.Authorization of node docs-search is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
warn: the value of infra.endpoint of node docs-search is carried as written in the Release the draft writes: the field belongs to an MCP server's configuration, which can carry a key, and setting empty_credentials to marked or all writes it empty
Pull complete: <workspace>/release.lock (entities=7, source_artifacts=0, external_inputs=0)

Düzenleyiciden çalıştırılan içe aktarma: taslağı oluşturulan Aggregate, Release ve Manifest MCP yapılandırmasının yanında görünüyor, Aggrega çıktısı yazıldığı gibi taşınan değerleri ve yazılan dosyaları listeliyor ve bir bildirim, içe aktarmanın mcp olarak tanınan 3 dosyanın taslağını oluşturduğunu söylüyor.

Her sunucu, standart kütüphanenin MCP aracı olan core/ai-tool/mcp’nin bir örneğidir; bu nedenle içe aktarma hiçbir adayı tartmaz ve hiçbir mapped satırı yazdırmaz.

  • warn satırları, bir sunucunun yapılandırmasının tuttuğu değerleri adlandırır. Hiçbir MCP istemcisi bunların hiçbirini kimlik bilgisi olarak işaretlemez ve herhangi biri bir kimlik bilgisi taşıyabilir — bir komut satırı bağımsız değişkenindeki bir anahtar, bir adresteki bir belirteç —; bu nedenle içe aktarma, yapılandırmanın taşıdığı her komut satırı öğesini, her üst bilgiyi ve her adresi sunucusu ve konumuyla adlandırır, asla değeriyle adlandırmaz. Taslağı paylaşmadan önce bunları okuyun. env içindeki ${GITHUB_TOKEN} değeri bir değişken başvurusundan başka bir şey değildir; bu nedenle kendine ait bir değer tutmaz ve hiçbir uyarı onu adlandırmaz.
  • Pull complete satırı, içe aktarmanın taslağı oluşturulan Release’in bağlı olduğu şeyleri aggrega pull gibi release.lock içine getirmesidir; böylece taslaklar hemen doğrulanır ve derlenir. --offline ile içe aktarma hiçbir şey çekmez ve çalıştırılacak aggrega pull komutunu belirtir.

Ne yazar

Aggregate, Release ve Manifest, bir istemcinin yapılandırması kendi adını taşımadığı için dosyadan, .mcp.json, imported/mcp olarak adlandırılır — bir kayıt defterinin server.json dosyası kendi name değerinden adlandırılır — ve içe aktarıcının target_namespace ayarının belirlediği ad alanı altında yer alır; bu ad alanı, başka birini ayarlamadığınız sürece imported olur (Ayarlar).

aggregate.yaml — sunucu başına bir örnek ve henüz bunları kullanan hiçbir şey yok:

apiVersion: aggrega.ai/v1beta1
kind: Aggregate
metadata:
name: imported/mcp
version: 0.1.0
description: Draft Aggregate imported from a source in the mcp format.
spec:
components:
github:
type: core/ai-tool/mcp
fetch:
type: core/ai-tool/mcp
docs-search:
type: core/ai-tool/mcp

release.yaml — her sunucunun, yapılandırmanın belirttiği şekilde nasıl çalıştırıldığı ya da ona nasıl erişildiği ve GitHub sunucusunun belirtecinin okunduğu Secret:

apiVersion: aggrega.ai/v1beta1
kind: Release
metadata:
name: imported/mcp
# environment is a drafted default, since no source names the environment this Release deploys to; change it to name the one it deploys to.
environment: development
version: 0.1.0
description: Draft Release imported from a source in the mcp format.
spec:
aggregate: imported/mcp
manifest: imported/mcp
components:
github:
infra:
stdio_command:
- "npx"
- "-y"
- "@modelcontextprotocol/server-github"
stdio_runtime: npm
features:
server_env:
type: core/referenced-secret
infra:
# Left for the Release, since the source cannot supply it: the name of a Kubernetes Secret already in the namespace holding the environment github is started with, one data key per variable, each named as the variable it holds: GITHUB_PERSONAL_ACCESS_TOKEN.
origin: "github-mcp-token"
fetch:
infra:
stdio_command:
- "uvx"
- "mcp-server-fetch"
stdio_runtime: pypi
# The headers the source sends this server, which no infrastructure key of core/ai-tool/mcp takes, since a remote server's credential is held by each consumer, on its connection to the tool:
# - Authorization: "Bearer ${DOCS_API_KEY}"
docs-search:
infra:
endpoint: "https://mcp.example.com/docs/mcp"
  • Ortam, development, hiçbir yapılandırma bir ortam adlandırmadığı için içe aktarmanın yazdığı bir varsayılandır; Release başka bir yere dağıtılıyorsa onu değiştirin.
  • stdio_runtime her komuttan okunur: npx bir npm paketi, uvx ise bir PyPI paketi çalıştırır.
  • GitHub belirteci. Sunucunun ortamı onun server_env yuvası olur. Kubernetes’te core/referenced-secret-set’in gerçekleştirmesi olan helm/k8s-secret-set, kendisine verilen değerleri derlemenin oluşturduğu bir Secret’e yazar; bu da belirteci bir dosyaya koyardı. Bu yüzden --target helm için içe aktarma bunun yerine core/referenced-secret’i ekler ve kümenin zaten tuttuğu bir Secret’i — yanıt olan github-mcp-token’ı — değişken başına bir veri anahtarıyla, GITHUB_PERSONAL_ACCESS_TOKEN ile adlandırır. Köprü, o Secret’in her veri anahtarını aynı adlı bir değişken olarak içe aktarır; böylece sunucu belirtecini makinenizde olduğu gibi okur ve hiçbir oluşturulmuş dosya onu taşımaz.
  • Authorization üst bilgisi bir yorum olarak kalır. Uzak bir sunucunun kimlik bilgisi, onu çağıran tarafta, o çağıranın araca olan kendi bağlantısında tutulur ve bu çalışma alanında henüz bir çağıran yoktur. Bir ajanı docs-search’e bağladığınızda üst bilgi o bağlantıya konur.

manifest.yaml — adına göre sunucu başına bir gerçekleştirme ve Secret’in gerçekleştirmesi:

apiVersion: aggrega.ai/v1beta1
kind: Manifest
metadata:
name: imported/mcp
version: 0.1.0
spec:
mappings:
components:
type: {}
name:
github: helm/mcp-stdio-bridge
fetch: helm/mcp-stdio-bridge
docs-search: helm/mcp-remote
features:
type:
core/referenced-secret: helm/k8s-existing-secret

Kubernetes için üç Recipes core/ai-tool/mcp’yi gerçekleştirir — biri imaj olarak yayımlanmış bir sunucu için, biri bir köprünün arkasında çalıştırılan bir paket için, biri başka birinin çalıştırdığı bir sunucu için — ve hangisinin uygun olduğu, yapılandırmanın belirttiği, her sunucunun bir özelliğidir. Bu yüzden içe aktarma her örneği adıyla eşler: bir komut satırından başlatılan github ve fetch, stdio köprüsü helm/mcp-stdio-bridge arkasında çalışır; başka birinin çalıştırdığı docs-search, hiçbir şey çalıştırmayan ve adresi yayımlayan helm/mcp-remote ile eşlenir. Belirtecin Secret’i, bir Secret yazmak yerine bir Secret’e başvuran helm/k8s-existing-secret ile eşlenir.

release.lock, Release’in çözümlendiği katalog varlıklarını özetleriyle (digest) kaydeder; .aggrega-import.json ise içe aktarmanın yazdıklarının kaydıdır ve sonraki bir aggrega import --sync onu okur.

Docker Compose üzerinde

Sunucular Docker Compose üzerinde de çalışır. aggrega import .mcp.json --target compose, github ve fetch’i compose/mcp-stdio-bridge ile, docs-search’ü compose/mcp-remote ile eşler ve GitHub sunucusunun ortamını yapılandırmanın yazdığı gibi korur: değeri ${GITHUB_TOKEN} değişken başvurusu olan bir core/referenced-secret-set girdisi; bunu, başvuruyu hizmetin ortamına yazıldığı gibi yazan compose/dotenv-secret-set gerçekleştirir, böylece Docker Compose yığın başladığında onu kabuğunuzdan doldurur. Bu içe aktarma hiçbir şey sormaz ve Secret’in adını kullanmadan yanıt dosyasında tutar.

Doğrulama ve derleme

Terminal window
aggrega validate --release release.yaml
aggrega build --release release.yaml

Doğrulandıktan sonra düzenleyicide açılan taslak Release; Aggrega çıktısı ve bir bildirim, ikisi de hiçbir sorun bulunmadığını bildiriyor.

Taslak Release'in derlemesi: Gezgin'de bir dist klasörü görünüyor, Aggrega çıktısı her sunucu için bir Deployment ve bir Service listeliyor ve bir bildirim 5 dosyanın yazıldığını söylüyor.

Doğrulama şunu yazdırır:

notice: LINT: Feature "core/referenced-secret" at core/referenced-secret:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)
release dependency validation passed: release.yaml (schema-pillar + dependency pillars)

ve derleme; burada <workspace>, onu çalıştırdığınız klasörü temsil eder:

notice: LINT: Feature "core/referenced-secret" at core/referenced-secret:1.0.0 declares property "origin" in both values: and infra: pillars (path: origin)
[… omitted: a total build time, which differs per run]
Build completed: 5 files written to <workspace>/dist

notice satırı tavsiye niteliğindedir: Feature, origin değerini Aggregate’in values alanından ya da Release’in infra alanından kabul eder ve bildirim bir yaprağın her ikisinde de bildirildiğini raporlar. Hiçbir kararı değiştirmez.

Derleme, dist/helm/ altına köprülenen iki sunucunun her biri için bir Deployment ve bir Service, docs-search için de bir Service yazar. GitHub sunucusunun dist/helm/github-deployment.yaml içindeki konteyneri, köprüyü sunucunun komut satırıyla çalıştırır ve ortamını Secret’ten alır:

containers:
- name: main
image: ghcr.io/supercorp-ai/supergateway:4.1.0@sha256:1938c43538a5308bce07d58028e9de00b7acfecb40b39b059b2f3931800ad910
args:
- --stdio
- '''npx'' ''-y'' ''@modelcontextprotocol/server-github'''
- --outputTransport
- streamableHttp
- --stateful
- --port
- "8080"
- --streamableHttpPath
- /mcp
- --healthEndpoint
- /healthz
ports:
- name: http
containerPort: 8080
env:
- name: MCP_TOOL_SIDE_EFFECTS
value: mutating
- name: MCP_TOOL_TIMEOUT_SECONDS
value: "30"
- name: MCP_TOOL_PORT
value: "8080"
envFrom:
- secretRef:
name: github-mcp-token
[… omitted: the container's resources and its readiness probe]

dist/helm/docs-search-service.yaml hiçbir şey çalıştırmaz: başka birinin çalıştırdığı sunucuya küme içinde bir ad verir.

apiVersion: v1
kind: Service
metadata:
name: docs-search
[… omitted: the labels and annotations the build writes on every resource]
spec:
type: ExternalName
externalName: mcp.example.com
ports:
- port: 443

Bir yapay zekâ asistanıyla

Aggrega’nın 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 ve kendin hiçbir klasör oluşturma. Workspace klasöründe henüz bir `import-mcp` klasörü yoksa, `example` değeri `import-mcp` olarak ayarlanmış ve `dir` olmadan `scaffold` aracını bir kez çağır: araç örneği, `source` klasörü bu sayfanın içe aktardıklarını içeren yeni bir `import-mcp` klasörüne yazar. Ardından `workspace_root` değeri `import-mcp/source`, `source` değeri `.mcp.json` ve `target` değeri `helm` olarak ayarlanmış şekilde `import` aracını çağır: 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 `workspace_root` değeri `import-mcp/source` ve `release` değeri `release.yaml` olarak ayarlanmış şekilde `validate` aracını, `workspace_root` değeri `import-mcp/source`, `release` değeri `release.yaml` ve `write` değeri true olarak ayarlanmış şekilde de `build` aracını çağır. Derlemenin hangi dosyaları yazdığını bana söyle; bunlar `import-mcp/source/dist/` altındadır.

VS Code’da açın

Visual Studio Code için Aggrega uzantısı yüklüyken, içe aktarmanın taslaklarını yazdığı import-mcp/source klasörünü VS Code’da açın. Klasörde tek bir Release, yani taslağı oluşturulan release.yaml bulunur; bu yüzden düzenleyici onu sizin için seçer ve siz taslakları düzenlerken onları bu Release’e göre denetleyip bulduklarını dosyada ve Sorunlar panelinde işaretler. Komut Paleti’ndeki Aggrega: Show topology graph, Release’in bileşenlerini ve aralarındaki bağlantıları çizer. Aggrega: Build, Aggrega: Preview build ve Aggrega: Pull aynı Release üzerinde çalışır ve her biri etkinlik çubuğundaki Aggrega görünümünün Commands panelinde bir düğme olarak da bulunur; Build dosyalarını klasörün dist/ dizinine yazar. Gerisini Aggrega’yı Visual Studio Code’da kullanma anlatır.

Çalıştırın

Derlemedeki hiçbir şey github-mcp-token Secret’ını yazmaz; bu yüzden dosyaları uygulamadan önce onu oluşturun. Token’ınızı github-token.env dosyasına tek satır olarak GITHUB_PERSONAL_ACCESS_TOKEN=<your token> şeklinde yazın ve Secret’ı bu dosyadan oluşturun. Artık token’ı küme tuttuğundan dosyayı silin:

Terminal window
kubectl create secret generic github-mcp-token --from-env-file=github-token.env
rm github-token.env
secret/github-mcp-token created

Derlemeyi, Bir içe aktarma nasıl çalışır bölümünün çalıştırma adımında açıklandığı gibi uygulayın ve iki sunucuyu bekleyin:

Terminal window
kubectl apply -R -f dist/helm/
kubectl wait --for=condition=Available deployment.apps/fetch deployment.apps/github --timeout=5m
service/docs-search created
service/fetch-default created
deployment.apps/fetch created
service/github-default created
deployment.apps/github created
deployment.apps/fetch condition met
deployment.apps/github condition met

Docker Compose’da, --target compose ile içe aktarılıp derlenmiş bir çalışma alanında, token’ınız kabuğunuzun GITHUB_TOKEN değişkenindeyken yığını başlatın; Docker Compose bunu yığın başlarken okur:

Terminal window
docker compose -p mcp -f dist/compose/docker-compose.yaml up -d --wait

Test edin

Köprü her sunucuyu MCP’nin Streamable HTTP taşıması üzerinden, 8080 numaralı porttaki /mcp adresinde sunar. fetch sunucusundan, hiçbir token okumayan MCP initialize isteğiyle bir oturum açmasını isteyin.

Docker Compose’da isteği, yığının ağı mcp_compose üzerindeki geçici bir konteynerden gönderin; bu ağda sunucunun adı fetch olur:

Terminal window
docker run --rm --network mcp_compose curlimages/curl:8.11.1 -sS http://fetch: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
[… omitted: the same comment, repeated while the server starts]
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"}}}

Kubernetes’te sunucunun Service’ine, fetch-default, yerel bir port yönlendirin ve komutu çalışır durumda bırakın:

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

Başka bir terminalden aynı isteği yönlendirilen porta gönderin:

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

Yanıt sunucunun adını verir: mcp-fetch. Bu biraz zaman alır: köprü her oturum için sunucunun komut satırını, uvx mcp-server-fetch, başlatır ve uvx önce sunucunun paketlerini indirip kurar — çalıştırmada Kubernetes’te yaklaşık yarım dakika, Docker Compose’da yaklaşık bir dakika sürdü. : keepalive satırları, akışın bu arada gönderdiği yorumlardır.

GitHub sunucusu aynı isteğe Docker Compose’da http://github:8080/mcp adresinde, Kubernetes’te ise kubectl port-forward svc/github-default 8080:8080 üzerinden yanıt verir. initialize hiçbir token okumaz; bu yüzden token ne içerirse içersin yanıt verir. Çalıştırmada yer tutucu bir token kullanıldı:

[… omitted: the keepalive comments, sent while npx installs the server]
event: message
data: {"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"github-mcp-server","version":"0.6.2"}},"jsonrpc":"2.0","id":1}

Port yönlendirmesini durdurun, ardından uyguladıklarınızı ve Secret’ı kaldırın:

Terminal window
kubectl delete -R -f dist/helm/
kubectl delete secret github-mcp-token

Docker Compose’da yığını durdurup kaldırın:

Terminal window
docker compose -p mcp -f dist/compose/docker-compose.yaml down