JinDaGe - Aiven MCP Details

article

README

🚀 Aiven MCP 服务器

Aiven MCP 服务器是 Aiven Model Context Protocol (MCP) 的一个服务器实现，专为 Aiven 量身打造。该服务器提供了对 Aiven 上的 PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 服务，以及更广泛的 Aiven 生态系统中本机连接器的访问能力，助力大型语言模型 (LLMs) 构建适用于所有用例的完整堆栈解决方案。

🚀 快速开始

配置用于 Claude Desktop

打开位于以下位置的 Claude Desktop 配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.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"
      }
    }
  }
}

更新环境变量：

$REPOSITORY_DIRECTORY 指向包含仓库的文件夹
AIVEN_TOKEN 设置为 Aiven 登录令牌。

找到命令条目“uv”并用绝对路径替换它，以确保启动服务器时使用正确的“uv”版本。在 macOS 上，可以使用 which uv 查找该路径。
重启 Claude Desktop 以应用更改。

配置用于 Cursor

在 Cursor 中导航到设置 -> Cursor 设置。
选择“MCP 服务器”。
添加一个新的服务器：
- 名称: 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 作为变量。

✨ 主要特性

工具

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

📦 安装指南

开发环境配置

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

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

安装“uv”工具：
- 在 macOS 上使用 brew install uv toolkit/tap/uv。
- 在 Linux 上参考 uv 安装文档。
同步依赖项：

npm install

启动测试服务器：

npm start

🔧 技术细节

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

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

Aiven