MCP Aiven

🚀 Aiven MCP 服务器

Aiven MCP 服务器基于 Model Context Protocol (MCP) 构建。该服务可访问在 Aiven 及其广泛生态系统中运行的 PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 等服务，还能通过原生连接器接入更多服务。借助它，大型语言模型 (LLM) 能够为各类用例构建完整的堆栈解决方案。

✨ 主要特性

工具

• list_projects：列出您 Aiven 账户中的所有项目。
• list_services：在特定 Aiven 项目中列出所有服务。
• get_service_details：获取特定 Aiven 项目中服务的详细信息。

📦 安装指南

配置指南（Claude Desktop）

1. 打开 Claude Desktop 配置文件，路径如下：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json
2. 添加以下内容：

{
  "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"
      }
    }
  }
}

更新环境变量： - $REPOSITORY_DIRECTORY 指向包含仓库的文件夹。 - AIVEN_TOKEN 设置为 Aiven 登录令牌。 3. 找到命令条目 uv 并将其替换为 uv 可执行文件的绝对路径。这确保了启动服务器时使用正确的 uv 版本。在 macOS 上，您可以使用 which uv 查找该路径。 4. 重启 Claude Desktop 以应用更改。

配置指南（Cursor）

1. 打开 Cursor -> 设置 -> Cursor 设置。
2. 选择 "MCP 服务器"。
3. 添加一个新的服务器：
   • 名称: mcp-aiven
   • 类型: command
   • 命令: uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven 其中 $REPOSITORY_DIRECTORY 是仓库的路径。您可能需要添加 AIVEN_BASE_URL、AIVEN_PROJECT_NAME 和 AIVEN_TOKEN 作为变量。

💻 使用示例

基础用法

from aiven_mcp import list_projects, list_services, get_service_details

# 示例用法
print("项目列表:", list_projects())
print("服务列表:", list_services(project_name))
print("服务详细信息:", get_service_details(service_id))

🔧 技术细节

开发步骤

1. 在根仓库目录中添加以下内容到 .env 文件：

AIVEN_BASE_URL=https://api.aiven.io
AIVEN_TOKEN=$AIVEN_TOKEN

2. 安装依赖项：

pip install "git+https://github.com/AivenXYZ/aiven-cli.git@main"

📄 许可证

暂未提及相关许可证信息。

⚠️ 重要提示

• 用户完全控制 MCP 的执行和安全。
• AI 代理权限直接与 API 令牌权限相关联。
• 提供凭据给 AI 代理时需极度谨慎。
• 严格遵守最小特权原则管理 API 令牌。