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 令牌。