Aiven MCP Server

Aiven MCP Server

site icon
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 构建全栈解决方案。

核心功能

  1. 工具列表
  2. list_projects:列出 Aiven 账户中的所有项目。
  3. list_services:列出特定 Aiven 项目中的所有服务。
  4. get_service_details:获取特定 Aiven 项目中服务的详细信息。

  5. 适用场景

  6. 通过 LLMs 构建全栈解决方案。
  7. 管理和监控 Aiven 平台上的多种数据库和服务。
  8. 自动化开发流程,提高开发效率。

常见问题解答

  • 权限控制:AI Agents 的访问权限由 API 令牌的权限控制,开发者需谨慎管理权限。
  • 凭证安全:AI Agents 可能需要访问敏感凭证(如数据库连接字符串),需谨慎处理。
  • API 令牌管理:遵循最小权限原则,定期轮换和安全管理 API 令牌。

使用教程

使用依赖

  1. 安装 uv 工具,参考 官方文档
  2. 创建 .env 文件并配置以下环境变量: AIVEN_BASE_URL=https://api.aiven.io AIVEN_TOKEN=$AIVEN_TOKEN

安装教程

  1. 运行以下命令安装依赖: bash uv sync source .venv/bin/activate
  2. 启动 MCP 服务器: bash mcp dev mcp_aiven/mcp_server.py

调试方式

  1. 确保环境变量已正确配置。
  2. 检查 uv 工具的路径是否正确。
  3. 重启 Claude Desktop 或 Cursor 以应用配置更改。

配置示例

Claude Desktop 配置

  1. 编辑配置文件 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 配置

  1. 在 Cursor 设置中添加 MCP 服务器:
  2. 名称:mcp-aiven
  3. 类型:command
  4. 命令:uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。