Aiven MCP 服务器

A Model Context Protocol (MCP) 服务器适用于 Aiven。

此服务可访问在 Aiven 和更广泛的 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 作为变量。

开发

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"
   

3. 在代码中使用：

   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))
   

注意事项

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