Aiven MCP 服务器

Aiven Model Context Protocol (MCP) 的一个服务器实现，专为 Aiven 设计。

此服务器提供对 Aiven 上的 PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 服务以及更广泛的 Aiven 生态系统中本机连接器的访问权限。使大型语言模型 (LLMs) 能够构建适用于所有用例的完整堆栈解决方案。

功能

工具

• 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”版本。在 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. 安装“uv”工具：

   • 在 macOS 上使用 brew install uv toolkit/tap/uv
   • 在 Linux 上参考 uv 安装文档

3. 同步依赖项：

   npm install
   

4. 启动测试服务器：

   npm start
   

与 MCP 和 AI 代理相关的开发者注意事项

• 用户保留对 MCP 执行的完整控制和责任。
• AI 代理权限直接与 API 令牌权限相关。
• 在提供凭据给 AI 代理时要极度小心。
• 严格遵守最小特权原则来管理 API 令牌。