金大哥 - mcp-aiven MCP 详情

article

README

🚀 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）

打开 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 登录令牌。 3. 找到命令条目 uv 并将其替换为 uv 可执行文件的绝对路径。这确保了启动服务器时使用正确的 uv 版本。在 macOS 上，您可以使用 which uv 查找该路径。 4. 重启 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 作为变量。

💻 使用示例

基础用法

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

🔧 技术细节

开发步骤

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

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

安装依赖项：

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

📄 许可证

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

⚠️ 重要提示

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

mcp-aiven