Aiven

🚀 Aiven MCP 服務器

Aiven MCP 服務器是 Aiven Model Context Protocol (MCP) 的一個服務器實現，專為 Aiven 量身打造。該服務器提供了對 Aiven 上的 PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 服務，以及更廣泛的 Aiven 生態系統中本機連接器的訪問能力，助力大型語言模型 (LLMs) 構建適用於所有用例的完整堆棧解決方案。

🚀 快速開始

配置用於 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 作為變量。

✨ 主要特性

工具

• list_projects：列出您在 Aiven 帳戶中的所有項目。
• list_services：在特定的 Aiven 項目中列出所有服務。
• get_service_details：獲取特定 Aiven 項目中的服務詳細信息。

📦 安裝指南

開發環境配置

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