Bỏ qua để đến nội dung
AggregaAggrega
Chọn ngôn ngữ: Tiếng Việt
Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

Nhập một cấu hình client MCP — ba máy chủ mà một trợ lý lập trình sử dụng

Một tệp .mcp.json của Claude Code liệt kê ba máy chủ Model Context Protocol — hai máy chủ được khởi động từ dòng lệnh và một máy chủ do người khác vận hành — được aggrega import soạn nháp thành các tệp Aggrega, mỗi máy chủ được ánh xạ tới hiện thực tương ứng với cách nó chạy, và được build cho Kubernetes.

Nhập một cấu hình client MCP hướng dẫn từng bước: lệnh, các tệp mà nó ghi và lý do mỗi dòng có mặt ở đó, quá trình build, và các máy chủ đang chạy. Thư mục này chứa từng giai đoạn của hướng dẫn đó:

thư mục hoặc tệpnội dung
source/cấu hình client, .mcp.json, .aggrega-config.yaml biến thư mục thành một không gian làm việc, và import-answers.yaml, tên của Secret Kubernetes mà token của máy chủ GitHub được đọc từ đó
draft/các tệp mà aggrega import .mcp.json --target helm đã ghi, không thay đổi, bao gồm cả release.lock, và những gì nó đã in ra: stdout.txt trên đầu ra chuẩn, import.txt trên đầu ra lỗi chuẩn

Trong một bản checkout của kho tài liệu, check.sh chạy lại quá trình nhập, so sánh những gì nó ghi và in ra với draft/, so sánh các khối mà hướng dẫn trích dẫn với các tệp này, và xác thực rồi build những gì quá trình nhập đã ghi. Nó cần catalog thư viện chuẩn (lấy ở đâu) được checkout bên cạnh kho này, hoặc thư mục của catalog đó được chỉ định trong AGGREGA_CATALOG_DIRS.

Tạo ví dụ

Bạn có thể chạy bước nhập của ví dụ này bằng các lệnh bên dưới, hoặc để trợ lý AI của bạn chạy thay bạn.

Ghi ví dụ vào một thư mục mới đặt theo tên của nó:

Terminal window
aggrega scaffold --example import-mcp

Sau đó nó in ra các lệnh cần chạy tiếp theo. Lệnh đầu tiên chuyển vào thư mục mới:

Terminal window
cd import-mcp

Build

Quá trình nhập soạn nháp các tệp Aggrega bên cạnh dự án, trong source/. Nó đối chiếu dự án với danh mục thư viện chuẩn, được registry mặc định của không gian làm việc xuất bản dưới dạng một snapshot có chữ ký: lần nhập đầu tiên tải nó về, xác minh nó, giữ nó trong bộ nhớ đệm nội dung của không gian làm việc và gọi tên nó bằng digest của nó trong bản ghi mà nó ghi bên cạnh các bản nháp. Một không gian làm việc chỉ định các thư mục danh mục riêng — trong AGGREGA_CATALOG_DIRS, hoặc dưới workspace.catalog_dirs — sẽ nhập dựa trên các thư mục đó thay thế. Quá trình nhập đọc tên của Secret từ import-answers.yaml, rồi kéo về những gì mà Release được soạn nháp phụ thuộc vào, để quá trình build có thể tiếp theo ngay:

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

Quá trình build ghi các manifest Kubernetes vào dist/helm/; việc tạo Secret và áp dụng các manifest đó có trong hướng dẫn được liên kết ở trên.

Với trợ lý AI

Một trợ lý AI được thiết lập với các công cụ của Aggrega cũng có thể làm như vậy: hãy dán prompt này vào trợ lý.

Chỉ dùng các công cụ của Aggrega và không tự tạo thư mục nào. Nếu thư mục không gian làm việc chưa có thư mục `import-mcp`, hãy gọi công cụ `scaffold` một lần với `example` đặt thành `import-mcp` và không có `dir`: công cụ này ghi ví dụ vào một thư mục `import-mcp` mới, trong đó thư mục `source` chứa những gì ví dụ này nhập. Sau đó gọi công cụ `import` với `workspace_root` đặt thành `import-mcp/source`, `source` đặt thành `.mcp.json` và `target` đặt thành `helm`: công cụ này đọc các câu trả lời nó cần từ `import-answers.yaml` bên cạnh `.mcp.json`, ghi các bản nháp vào `import-mcp/source` và kéo về những gì chúng cần. Sau đó gọi công cụ `validate` với `workspace_root` đặt thành `import-mcp/source` và `release` đặt thành `release.yaml`, và công cụ `build` với `workspace_root` đặt thành `import-mcp/source`, `release` đặt thành `release.yaml` và `write` đặt thành true. Cho tôi biết bản build đã ghi những tệp nào; chúng nằm trong `import-mcp/source/dist/`.

Kiểm thử

Sau khi áp dụng bản build, hãy chuyển tiếp một cổng cục bộ tới Service của máy chủ fetch và để lệnh tiếp tục chạy:

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

Từ một terminal khác, hãy yêu cầu máy chủ mở một phiên bằng yêu cầu initialize của 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"}}}

Hướng dẫn thực hiện cùng lời gọi đó trên Docker Compose và tới máy chủ GitHub.