MCP

唯讀查詢 Aiven 上的 PostgreSQL 服務

適合要在助手裡查看 Aiven PostgreSQL 或 Kafka 服務的人,前提是用託管 HTTP 接入並加上 read_only=true,否則助手可能刪除服務或生產訊息。

官方來源 · Aiven MCP

安裝

claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp?read_only=true"

適合誰

如果你要在助手裡管理 Aiven 上的 PostgreSQL、Apache Kafka、應用和其他服務,mcp-aiven 對口。官方點名的助手包括 Claude、Cursor 和 VS Code Copilot。

它適合已經有 Aiven 帳號、並能完成瀏覽器授權的人。託管入口:

https://mcp.aiven.live/mcp

倉庫:

https://github.com/Aiven-Open/mcp-aiven

該服務能代表你建立、修改和刪除 Aiven 服務與資料。助手可能按它的理解執行破壞性動作(刪除資料庫、刪除服務、向 Kafka 生產訊息)。責任在你。第一次必須走唯讀。

3 分鐘完成第一次嘗試

官方主路徑是託管 HTTP,不要先配本機 token。先決條件:已登入 Aiven 的瀏覽器工作階段。用戶端會提示你授權。唯讀模式把所有寫操作從 MCP 裡排除。唯讀位址:

https://mcp.aiven.live/mcp?read_only=true

安裝位置是 Claude Code 的使用者級 MCP。第一次用唯讀位址新增(官方新增命令的傳輸和名字保持不變,只換官方給出的唯讀 URL):

claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp?read_only=true"

完成授權後,立刻做一次有依據的真實呼叫,而不是只看端點是否通:讓助手查詢你帳號下現有的 PostgreSQL 服務(官方能力就是管理 PostgreSQL)。摘錄沒有給出工具函式名,因此不要喊發明的 list_*;就按「PostgreSQL 服務」提問,讓已註冊的唯讀工具回傳服務資訊。

可觀察成功信號:助手說出至少一個專案或 PostgreSQL 服務的名稱/狀態,或明確說帳號下沒有。若只有「已連線」而沒有任何服務查詢結果,這次嘗試還沒完成。

使用案例

案例一:查看 PostgreSQL 服務。對應能力是直接管理 Aiven PostgreSQL。在 read_only=true 下讓助手讀出實例名、狀態或連線相關唯讀資訊。官方沒有寫欄位表。不要 drop 資料庫。

案例二:查看 Apache Kafka 服務。對應能力是管理 Kafka。同樣唯讀查詢叢集或服務狀態。官方點名的危險寫操作是 producing messages;唯讀模式下寫操作應被排除,仍不要主動要求生產訊息或刪除服務。

applications 和其他 Aiven 服務也被點名可管理,但第一次不要擴到寫。

使用邊界

本機備選是 Node.js 18+ 下 npx -y mcp-aiven,並設定 AIVEN_TOKEN。這不是第一次主路徑。不要把文件裡的示意 token 值貼進去。

完整託管位址也可以不加唯讀參數,但那樣寫工具會註冊。存取權限跟隨已授權的 Aiven 使用者。沒有寫服務名冊以外的雲廠商。

read_only=true 不是零風險:仍會讀取你的雲專案,授權會打開 Aiven。未出現的工具名不要發明。