agent-connector: Công cụ triển khai đồng loạt máy chủ/móc MCP cho nhiều agent CLI cùng lúc
(github.com/ken-jo)Vấn đề hiện tại: phải tùy chỉnh riêng máy chủ/móc MCP cho từng agent CLI
Khi gắn máy chủ MCP vào nhiều agent CLI, bạn phải liên tục duy trì cùng một cấu hình dưới các định dạng khác nhau.
Ví dụ:
- Claude Code: JSON
mcpServers - Codex: TOML
[mcp_servers.*] - Cursor:
mcp.json+hooks.json - Gemini:
.gemini/settings.json
Chỉ riêng việc đăng ký máy chủ đã khá phiền, còn hooks thì còn phức tạp hơn.
Mỗi host có mô hình sự kiện khác nhau nên ngay cả cùng một hành vi cũng phải chỉnh lại theo từng CLI.
Vì vậy, để giảm bớt sự lặp lại này, tôi đã tạo ra agent-connector.
Cách giải quyết
Chỉ cần định nghĩa một lần bằng defineConnector(), công cụ sẽ render thành các tệp cấu hình gốc mà từng host thực sự đọc.
defineConnector({
server,
hooks,
plugins,
marketplace,
})
Đây không phải cách chạy một wrapper trung gian hay ép buộc dùng một định dạng riêng.
Thay vào đó, nó tạo ra đúng các tệp JSON, TOML, settings... mà từng CLI vốn dĩ sử dụng.
Phạm vi hỗ trợ
Hiện tại, ngoài việc đăng ký máy chủ MCP, công cụ còn xử lý các mảng sau.
- Đăng ký máy chủ MCP
- Chuyển đổi mô hình sự kiện hook theo từng host
- Đóng gói plugin / extension
- Luồng cài đặt marketplace của từng host
- Cài đặt hàng loạt cho nhiều CLI
- Xóa sạch cấu hình còn sót bằng
uninstall --purge - Telemetry token theo từng công cụ
- Tạo CLI thương hiệu riêng dựa trên SDK
Người dùng có thể dùng đại khái như sau.
$ agent-connector install
$ agent-connector uninstall --purge
# hoặc
$ plugin install brand-name
Trạng thái hiện tại
Đến nay tôi vẫn đang phát triển nó một mình.
Các phần chủ yếu đã dành nhiều thời gian gồm:
- Render cấu hình đa host
- Chuẩn hóa mô hình sự kiện hook
- Đóng gói plugin / extension
- Luồng cài đặt marketplace
- Telemetry
- Kiểm thử trên Linux / macOS / Windows
Hiện tại có thể tạo cấu hình cho 42 agent CLI.
Những gì đã kiểm chứng
Tôi đã thử port MCP hiện có là context-mode để kiểm thử thực tế.
Kết quả như sau.
- Mã triển khai theo từng host: 20.322 dòng → 76 dòng
- Script hook: 71 → 0
- CLI được hỗ trợ: 15 → 42
Tuy nhiên, đây không phải máy chủ MCP do tôi tự tạo ra, mà là một trường hợp di chuyển từ máy chủ hiện có.
Vì vậy tôi muốn thấy thêm các trường hợp bị lỗi với nhiều máy chủ MCP đa dạng hơn.
Phản hồi đang tìm kiếm
Nếu những người đang xây dựng máy chủ MCP có thể tự thử áp dụng và gửi phản hồi thì sẽ rất hữu ích.
Tôi đặc biệt muốn nhận các phản hồi như sau.
- Các trường hợp cấu hình bị lỗi trên một CLI cụ thể
- Các trường hợp mô hình sự kiện hook còn thiếu
- Những điểm gượng gạo trong luồng plugin / marketplace
- Những phần thiết kế API gây bất tiện
- Nhận xét về cấu trúc dự án OSS
Nếu MCP là lớp gắn công cụ thực tế cho agent, thì tôi nghĩ cần một cấu trúc không bị kéo theo mãi bởi cách cấu hình của từng CLI cụ thể.
- Demo: https://agent-connector.ai
- GitHub: https://github.com/ken-jo/agent-connector
- npm:
@ken-jo/agent-connector - License: Apache-2.0
Chưa có bình luận nào.