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。未出现的工具名不要发明。