Ưu, nhược và chỗ chưa rõ
| Ưu | README ghi: một server dùng được cho Postgres, MySQL, SQL Server, Oracle, MongoDB, Redis, Snowflake, ClickHouse cùng các database của Google Cloud. Cờ --prebuilt=postgres/data chỉ nạp nhóm tool SQL. | README, mục Prebuilt Tools |
|---|---|---|
| Ưu | Telemetry tắt cho tới khi bạn tự bật cờ; code không gửi số liệu về Google nếu bạn không bật. | flags.go |
| Ưu | Một bài phân tích của Agnost AI ghi server tự gom và tái dùng kết nối, tự thử lại khi lỗi, và có sẵn OpenTelemetry để theo dõi từng query. | Agnost AI |
| Nhược | Tool execute_sql trong bộ dựng sẵn cho Postgres chạy mọi câu SQL, và nguồn Postgres không có chế độ chỉ đọc (IsReadOnly luôn trả false). Muốn agent không sửa được dữ liệu, bạn phải tạo user database chỉ có quyền đọc. | postgres.go |
| Nhược | Cùng bài Agnost AI ghi: mặc định không giới hạn số dòng trả về và không che dữ liệu cá nhân. Một câu hỏi của agent có thể sinh 5 đến 10 query. | Agnost AI |
| Nhược | Một người nghiên cứu bảo mật kể trên Hacker News (25/08/2026): HTTP source từng đi theo redirect tới bất kỳ địa chỉ nào, kể cả địa chỉ chứa thông tin đăng nhập cloud (CVE-2026-14540, CVSS 8.0). Google sửa trong 8 ngày. Hãy dùng bản mới. | Hacker News |
| Nhược | Chưa có bản cho Linux ARM64: gói npm chỉ có 5 nền tảng, và issue xin bản ARM64 mở từ 16/03/2026, tới 28/07/2026 mới có PR liên kết. | Issue #2754 |
| Chưa rõ | README ghi cách chạy bằng npx là để tiện. Muốn chạy ổn định hơn, README khuyên tải binary hoặc dùng container. Mình chưa có số liệu so sánh hai cách. | README, mục Install & Run |
Khi nên dùng
- Bạn có nhiều loại database (ví dụ Postgres và BigQuery) và muốn một server MCP cho tất cả, hoặc muốn tự viết từng tool bằng file tools.yaml.
Khi không nên dùng
- Bạn chỉ dùng Supabase hoặc Neon (server của họ có sẵn chế độ chỉ đọc), hoặc máy bạn chạy Linux ARM64.
Cách cài
Claude Code
{"mcpServers":{"toolbox-postgres":{"command":"npx","args":["-y","@toolbox-sdk/[email protected]","--prebuilt=postgres","--stdio"]}}}Codex
command = "npx", args = ["-y", "@toolbox-sdk/[email protected]", "--prebuilt=postgres", "--stdio"] (README đưa một khối cấu hình chung cho mọi client)Nó chạm vào những gì
- File đọc và ghi
- Đọc tools.yaml khi bạn dùng --config và tự nạp lại khi file đổi (tắt bằng --disable-reload). Bộ dựng sẵn --prebuilt=postgres đọc thông tin kết nối từ biến môi trường.
- Gọi mạng
- Kết nối tới database bạn khai báo. Telemetry tắt mặc định; chỉ gửi đi khi bạn bật --telemetry-gcp (Google Cloud Monitoring) hoặc --telemetry-otlp (địa chỉ bạn chọn). Cờ --ui mở thêm web UI, mặc định tắt.
- Script lúc cài
- Gói npm không có postinstall. Script prepack tải binary từ storage.googleapis.com chỉ chạy lúc Google đóng gói, máy bạn không chạy.
- Tiến trình
- npx chạy bin/run.js, file này khởi động binary Go toolbox của đúng hệ điều hành. Trên macOS, run.js gỡ cờ quarantine của binary bằng xattr -d com.apple.quarantine.
Đọc từ: run.js#L40, package.json, flags.go#L35, root.go#L121, postgres.yaml#L15
Mục này chạy mã trên máy bạn với quyền của tài khoản bạn. Theo tài liệu Claude Code, hook và MCP server chạy ngoài sandbox. Đọc phần trên và file của tác giả trước khi cài. Tài liệu bảo mật plugin