适合谁
- 已使用 Aiven 平台并希望用 AI 助手管理资源的开发者与运维团队
- 需要同时管理 PostgreSQL 和 Kafka 的团队
- 希望缩小 AI 可用工具面（只读、限定 scope）的安全敏感用户
A
64FMRS · C
由 Aiven 官方维护的成熟 MCP 服务器，工具覆盖全面（项目管理、服务生命周期、Kafka、PostgreSQL、应用部署），并提供只读模式、工具范围裁剪和写操作白名单等安全控制，适合 Aiven 用户在 AI 助手中管理其数据基础设施。
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）裁剪工具面，以及写操作白名单。
工具能力
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
创建服务
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 官方文档（仅在托管服务器上可用）
安装接入
远程方式（推荐）：在 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 查询参数控制工具范围。
claude_desktop_config.json
{"mcpServers":{"aiven-mcp":{"command":"npx","args":["-y","mcp-aiven"],"env":{"AIVEN_TOKEN":"your-token-here"}}}}
选型与风险
不适合谁
- 未使用 Aiven 平台的用户
- 不希望授权 AI 代理执行破坏性操作（删库、删服务）的生产环境
- 本地 stdio 部署无法使用 aiven_docs_search 工具
所需权限
- 本地 stdio 模式需要 Aiven API 令牌（AIVEN_TOKEN）
- 远程模式通过 OAuth 授权，使用你 Aiven 账号对应的用户权限
- 服务器只能执行该 Aiven 用户被允许的操作
风险与副作用
- AI 代理可能根据对提示词的理解执行破坏性操作，如删库、删除服务、生产消息
- 启用 AIVEN_ALLOW_SECRETS 后，connection-info 工具会将真实凭据（密码、连接 URI、证书）暴露到对话中
- 对生产环境使用前应审查代理行为、做风险评估并遵守组织安全策略
常见排障
- 确认 AIVEN_TOKEN 已正确设置且有效（stdio 模式必需）
- 本地运行需 Node.js 18+
- 远程模式需在 MCP 客户端中完成 Aiven OAuth 授权
- 若工具过少，检查 services_scope 配置是否限定了范围
- 云市场（AWS/Azure/GCP）客户需在 URL 中加入对应市场路径段，如 /mcp/aws
使用场景
通过 AI 助手开通和管理 PostgreSQL 服务
使用自然语言管理 Apache Kafka 主题、消息和 Connect 连接器
查看服务指标、日志、查询活动和项目事件
部署和重新部署 Docker 化应用
以只读模式安全浏览 Aiven 项目与服务
支持客户端
Claude Code完整支持
Cursor完整支持
VS Code / Copilot完整支持