
Aiven MCP Server

2025.04.09
5
Python数据库管理开发工具数据库开发效率
mcp-aiven 是一个基于 Model Context Protocol (MCP) 的服务器,专门为 Aiven 平台设计。它提供了对 Aiven 平台上运行的 PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 服务的访问,并支持 Aiven 生态系统的原生连接器。通过该服务,LLMs(大型语言模型)能够构建全栈解决方案,适用于各种用例。
View on GitHub
Overview
基本能力
产品定位
mcp-aiven 是一个用于访问和管理 Aiven 平台服务的 MCP 服务器,旨在为开发者提供便捷的工具和接口,以便通过 LLMs 构建全栈解决方案。
核心功能
- 工具列表
list_projects
:列出 Aiven 账户中的所有项目。list_services
:列出特定 Aiven 项目中的所有服务。-
get_service_details
:获取特定 Aiven 项目中服务的详细信息。 -
适用场景
- 通过 LLMs 构建全栈解决方案。
- 管理和监控 Aiven 平台上的多种数据库和服务。
- 自动化开发流程,提高开发效率。
常见问题解答
- 权限控制:AI Agents 的访问权限由 API 令牌的权限控制,开发者需谨慎管理权限。
- 凭证安全:AI Agents 可能需要访问敏感凭证(如数据库连接字符串),需谨慎处理。
- API 令牌管理:遵循最小权限原则,定期轮换和安全管理 API 令牌。
使用教程
使用依赖
- 安装
uv
工具,参考 官方文档。 - 创建
.env
文件并配置以下环境变量:AIVEN_BASE_URL=https://api.aiven.io AIVEN_TOKEN=$AIVEN_TOKEN
安装教程
- 运行以下命令安装依赖:
bash uv sync source .venv/bin/activate
- 启动 MCP 服务器:
bash mcp dev mcp_aiven/mcp_server.py
调试方式
- 确保环境变量已正确配置。
- 检查
uv
工具的路径是否正确。 - 重启 Claude Desktop 或 Cursor 以应用配置更改。
配置示例
Claude Desktop 配置
- 编辑配置文件
claude_desktop_config.json
,添加以下内容:json { "mcpServers": { "mcp-aiven": { "command": "uv", "args": [ "--directory", "$REPOSITORY_DIRECTORY", "run", "--with-editable", "$REPOSITORY_DIRECTORY", "--python", "3.13", "mcp-aiven" ], "env": { "AIVEN_BASE_URL": "https://api.aiven.io", "AIVEN_TOKEN": "$AIVEN_TOKEN" } } } }
Cursor 配置
- 在 Cursor 设置中添加 MCP 服务器:
- 名称:
mcp-aiven
- 类型:
command
- 命令:
uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven