Aiven MCP Server

官方

用 AI 助手直接管理 Aiven 云数据平台

分类: 数据库第 13 / 58
Stars: ★ 28 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js 18+ · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: Apache-2.0
最近提交: 8 天前
工具数: 46

64FMRS · C

由 Aiven 官方维护的成熟 MCP 服务器，工具覆盖全面（项目管理、服务生命周期、Kafka、PostgreSQL、应用部署），并提供只读模式、工具范围裁剪和写操作白名单等安全控制，适合 Aiven 用户在 AI 助手中管理其数据基础设施。

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

11/20

维护活跃度

13/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: README 中工具列表（Core/Kafka/PostgreSQL/Applications/Documentation）与 server.json 中声明的 npm 包及远程 streamable-http 端点在描述层面基本一致，环境变量门控逻辑（AIVEN_READ_ONLY、AIVEN_SERVICES_SCOPE、AIVEN_ALLOW_SECRETS）说明清晰、自洽。但提供的证据中不包含任何 CI 工作流文件或测试代码，无法验证 MCP init/tool-list 握手在实际运行中可复现，也无法验证声明行为与真实实现一致。按静态核查规则，缺少可验证的执行证据时可靠性不得超过 12 分，故给出 10 分，反映'happy path 看似合理但边界情况和错误处理未经证实'。
安全与权限 11/20: 该服务器暴露了高风险操作：aiven_pg_write（任意写 SQL）、aiven_service_update/create、aiven_kafka_topic_delete、aiven_kafka_topic_message_produce、aiven_application_deploy 等，默认（未设置 AIVEN_READ_ONLY）情况下这些破坏性操作全部可用，且服务器本身未内置逐操作的二次确认机制，完全依赖下游客户端或用户自身判断，README 也明确声明'用户对由此产生的操作完全负责'。缓解措施较为具体：只读模式与 write_allowlist 可选、服务范围可裁剪（scopes）、connection-info 工具默认对凭证做 [REDACTED] 脱敏且需显式 AIVEN_ALLOW_SECRETS 才能返回明文凭证、只读模式下自动禁用该功能，远程模式还实现了限流与可选的 Edge 认证防护。权限本质上继承 Aiven 账户自身权限（最小权限原则部分成立）。由于主要风险已被充分披露且有配置层面的缓解手段，但服务器层面缺乏针对破坏性操作的强制确认步骤，未达到红线（0-4）但也未达到'确认机制完整'的高分标准，故评为 11 分。
维护活跃度 13/20: 仓库由 Aiven-Open 官方组织维护，属于厂商官方支持项目，version 字段为 1.11.2，表明经历过多次迭代发布；许可证为 Apache-2.0，清晰明确；README 引用了 CONTRIBUTING.md，说明存在贡献流程。但给出的证据中未见 SECURITY.md 或明确的安全响应渠道说明，仓库仅 26 星、5 个未解决 issue，无法从现有材料判断 issue 响应速度或社区活跃程度。综合评定为 13 分：有明确所有权和版本演进，但治理文档（安全响应、发布节奏说明）存在缺口。
文档质量 16/20: README 文档层次丰富：分别给出远程托管（OAuth）与本地 stdio 两种接入方式，附 Claude Code/Cursor/VS Code 的具体配置示例；环境变量表格完整列出必需性、默认值与作用；工具按功能模块（Core/Kafka/PostgreSQL/Applications/Documentation）分类列表并逐一说明；专门章节说明 Edge Protection 灰度上线步骤与限流参数。不足之处：缺少专门的故障排查（troubleshooting）章节，也未充分说明使用工具触发实际云资源创建/变更所产生的费用风险（仅有笼统安全警告，未结合具体计费场景说明）。综合评为 16 分。
安装易用性 14/20: 提供两条清晰路径：远程托管一条命令即可在 Claude Code 中添加（或 JSON 配置片段用于 Cursor/VS Code），无需本地构建；本地 stdio 方式仅需 npx 一行命令加 AIVEN_TOKEN 环境变量，步骤少、跨平台（Node.js 18+）。文档同时给出针对云市场客户（AWS/Azure/GCP）的专属路径说明，覆盖面较全。但由于未在证据中发现可验证的 CI/测试文件证明这些安装路径被自动化验证过，按静态核查规则，安装易用性上限为 15 分，故评为 14 分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据连接数据库

适合谁

已使用 Aiven 平台并希望用 AI 助手管理资源的开发者与运维团队
需要同时管理 PostgreSQL 和 Kafka 的团队
希望缩小 AI 可用工具面（只读、限定 scope）的安全敏感用户

不适合谁

未使用 Aiven 平台的用户
不希望授权 AI 代理执行破坏性操作（删库、删服务）的生产环境
本地 stdio 部署无法使用 aiven_docs_search 工具

所需权限

本地 stdio 模式需要 Aiven API 令牌（AIVEN_TOKEN）
远程模式通过 OAuth 授权，使用你 Aiven 账号对应的用户权限
服务器只能执行该 Aiven 用户被允许的操作

风险与副作用

AI 代理可能根据对提示词的理解执行破坏性操作，如删库、删除服务、生产消息
启用 AIVEN_ALLOW_SECRETS 后，connection-info 工具会将真实凭据（密码、连接 URI、证书）暴露到对话中
对生产环境使用前应审查代理行为、做风险评估并遵守组织安全策略

安装接入

准备工作

运行环境：Node.js 18+ · 远程托管（无需本地环境）

AIVEN_TOKEN 必填密钥 Aiven API token（本地 stdio 模式必填），可在 https://console.aiven.io/profile/tokens 创建。

MCP_EDGE_AUTH_SECRET 可选密钥与 Cloudflare 注入的 X-Edge-Auth 匹配的共享密钥，EXTRA_PROTECTION=true 时必填。

其他可选配置项（9 个）

AIVEN_READ_ONLY 可选设为 true 仅暴露只读工具，默认 false。

AIVEN_SERVICES_SCOPE 可选逗号分隔的工具范围（pg、kafka、application、integrations、core、all），用于缩减暴露的工具面。

AIVEN_ALLOW_SECRETS 可选设为 true 时允许 connection-info 工具返回真实凭据而非 [REDACTED]，默认 false。

AIVEN_WRITE_ALLOWLIST 可选只读模式下逗号分隔的白名单工具名，用于重新启用个别写操作。

MCP_HOST 可选覆盖 OAuth protected resource 主机，默认 https://mcp.aiven.live。

MCP_TRANSPORT 可选传输方式，默认 stdio，设为 http 启动 HTTP 服务器。

MCP_HTTP_RATE_LIMIT_MAX 可选 HTTP 传输下 POST /mcp 每个 Bearer token 在窗口内的最大请求数，默认 1000。

MCP_HTTP_RATE_LIMIT_WINDOW_MS 可选速率限制窗口长度（毫秒），默认 60000。

EXTRA_PROTECTION 可选 HTTP 部署时设为 true 要求每个请求带有效的 X-Edge-Auth 头（GET /health 除外）。

远程方式（推荐）：在 Claude Code 中运行 claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp"；或在 Cursor / VS Code 的 MCP 配置中添加该 URL，客户端会引导你在 Aiven 上完成 OAuth 授权。本地 stdio 方式：需要 Node.js 18+，在 https://console.aiven.io/profile/tokens 创建 API 令牌，然后运行 claude mcp add --scope user aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven，或在配置中设置 command 为 npx、args 为 ["-y","mcp-aiven"] 并提供 AIVEN_TOKEN 环境变量。可通过 AIVEN_READ_ONLY、AIVEN_SERVICES_SCOPE 等环境变量或 URL 查询参数控制工具范围。

.mcp.json

{"mcpServers":{"aiven-mcp":{"command":"npx","args":["-y","mcp-aiven"],"env":{"AIVEN_TOKEN":"your-token-here"}}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "aiven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "your-token-here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

连接后查看客户端工具列表中是否出现 aiven_project_list 等工具；也可以直接问“列出我的 Aiven 项目”，能返回项目列表即说明连接成功。

常见排障

确认 AIVEN_TOKEN 已正确设置且有效（stdio 模式必需）
本地运行需 Node.js 18+
远程模式需在 MCP 客户端中完成 Aiven OAuth 授权
若工具过少，检查 services_scope 配置是否限定了范围
云市场（AWS/Azure/GCP）客户需在 URL 中加入对应市场路径段，如 /mcp/aws

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我在 Aiven 的所有项目。
帮我创建一个新的 Kafka topic，然后查看它当前的消息。
查看我的 PostgreSQL 服务的查询统计，并给出优化建议。
把我的服务套餐换成更高配置的方案并查看价格。

工具能力 46

aiven_project_list 只读

列出项目

aiven_project_get 只读

获取项目详情

aiven_list_project_clouds 只读

列出项目可用的云平台

aiven_project_vpc_list 只读

列出项目的 VPC

aiven_service_list 只读

列出服务

aiven_service_type_plans 只读

列出各服务类型计划及其云可用性

aiven_service_plan_pricing 只读

获取指定云上某计划的价格

aiven_service_create 写入

创建服务

展开其余 38 个工具

aiven_service_get 只读

获取服务信息

aiven_service_update 写入

更新服务（计划、配置、电源状态）

aiven_service_metrics_fetch 只读

获取托管数据服务的指标

aiven_service_application_metrics_get 只读

获取应用程序服务的指标

aiven_project_get_service_logs 只读

获取服务日志条目

aiven_service_query_activity 只读

获取服务当前正在执行的查询

aiven_project_get_event_logs 只读

获取项目事件日志条目

aiven_kafka_topic_list 只读

列出 Kafka 主题

aiven_kafka_topic_create 写入

创建 Kafka 主题

aiven_kafka_topic_get 只读

获取 Kafka 主题信息

aiven_kafka_topic_update 写入

更新 Kafka 主题

aiven_kafka_topic_delete 破坏性

删除 Kafka 主题

aiven_kafka_topic_message_list 只读

读取 Kafka 主题中的消息

aiven_kafka_topic_message_produce 破坏性

向 Kafka 主题生产消息

aiven_kafka_connect_available_connectors 只读

列出可用的连接器类型

aiven_kafka_connect_list 只读

列出正在运行的连接器

aiven_kafka_connect_create_connector 写入

创建连接器

aiven_kafka_connect_edit_connector 写入

编辑连接器

aiven_kafka_connect_get_connector_status 只读

获取连接器状态

aiven_kafka_connect_pause_connector 写入

暂停连接器

aiven_kafka_connect_resume_connector 写入

恢复连接器

aiven_kafka_connect_restart_connector 写入

重启连接器

aiven_kafka_connect_delete_connector 破坏性

删除连接器

aiven_kafka_schema_registry_subjects 只读

列出 Schema Registry 主题（subjects）

aiven_kafka_schema_registry_subject_version_get 只读

获取 Schema Registry 主题的指定版本

aiven_pg_service_available_extensions 只读

列出可用的 PostgreSQL 扩展

aiven_pg_service_query_statistics 只读

获取查询统计信息

aiven_pg_bouncer_create 写入

创建 PgBouncer 连接池

aiven_pg_bouncer_update 写入

更新 PgBouncer 连接池

aiven_pg_bouncer_delete 破坏性

删除 PgBouncer 连接池

aiven_pg_read 只读

执行只读 SQL 查询

aiven_pg_write 破坏性

执行写 SQL 语句（INSERT、UPDATE、DELETE、CREATE TABLE 等）

aiven_pg_optimize_query 只读

AI 驱动的查询优化（EverSQL）

aiven_application_deploy 写入

将 Docker 化应用部署到 Aiven

aiven_application_redeploy 写入

重新构建并重新部署现有应用

aiven_vcs_integration_list 只读

列出已连接的 VCS（GitHub）账号

aiven_vcs_integration_repository_list 只读

列出 VCS 集成下的仓库

aiven_docs_search 只读

以自然语言搜索 Aiven 官方文档（仅在托管服务器上可用）

使用场景

通过 AI 助手开通和管理 PostgreSQL 服务

使用自然语言管理 Apache Kafka 主题、消息和 Connect 连接器

查看服务指标、日志、查询活动和项目事件

部署和重新部署 Docker 化应用

以只读模式安全浏览 Aiven 项目与服务

支持客户端

Claude Code

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Aiven MCP Server 是由 Aiven 官方维护的 Model Context Protocol 服务器，用于管理 Aiven 云数据平台。用户可以在 Claude、Cursor、VS Code Copilot 等 AI 助手中直接开通和管理 PostgreSQL、Apache Kafka 及应用程序部署。支持两种运行方式：由 Aiven 托管的远程 HTTP 服务器（OAuth 授权，https://mcp.aiven.live/mcp），或通过 npx mcp-aiven 在本地以 stdio 方式运行（需 Node.js 18+ 和 AIVEN_TOKEN API 令牌）。支持只读模式、按服务范围（pg、kafka、application、integrations、core）裁剪工具面，以及写操作白名单。