使用说明

项目简介

Aiven MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在让LLM应用能够访问和操作Aiven云平台上的服务，如PostgreSQL、Kafka、ClickHouse等。通过预定义的工具，LLM可以查询Aiven项目和服务信息，从而构建更强大的云原生应用。

主要功能点

列出项目 (list_projects): 获取您Aiven账户下的所有项目列表。
列出服务 (list_services): 获取指定Aiven项目中的所有服务列表。
获取服务详情 (get_service_details): 获取指定Aiven项目中服务的详细配置和状态信息。

安装步骤

克隆仓库: 将仓库 'mcp-aiven' 克隆到本地。
安装 uv: 根据 uv 安装指南安装 'uv' 包管理器。
安装依赖: 在仓库根目录下，运行 'uv sync' 命令安装项目依赖。
配置环境变量: 复制仓库根目录下的 '.env.example' 文件为 '.env'，并根据您的 Aiven 账户信息配置 'AIVEN_TOKEN'。如果您需要连接到非官方的Aiven API，请配置 'AIVEN_BASE_URL'。

服务器配置

对于 MCP 客户端 (例如 Claude Desktop, Cursor 等)，您需要配置以下服务器信息以连接到 Aiven MCP Server。请注意，以下配置为 JSON 格式，您需要将其添加到 MCP 客户端的服务器配置中。

{
  "serverName": "mcp-aiven",  //  服务器名称，在客户端中用于唯一标识
  "command": "uv",           //  启动服务器的命令，这里使用 uv 包管理器
  "args": [                   //  命令参数
    "--directory",
    "$REPOSITORY_DIRECTORY", //  请替换为仓库在您本地的绝对路径
    "run",
    "--with-editable",
    "$REPOSITORY_DIRECTORY",
    "--python",
    "3.13",                  //  指定 Python 3.13 版本运行
    "mcp-aiven"             //  运行 mcp-aiven 入口
  ],
  "env": {                     //  环境变量配置
    "AIVEN_BASE_URL": "https://api.aiven.io", //  Aiven API 的基础 URL，默认为官方 API 地址，通常无需修改
    "AIVEN_TOKEN": "$AIVEN_TOKEN"             //  请替换为您的 Aiven API Token
  }
}

基本使用方法

启动服务器: 在仓库根目录下，运行命令 'mcp dev mcp_aiven/mcp_server.py' 启动 Aiven MCP 服务器。
配置客户端: 将上述服务器配置 JSON 添加到您的 MCP 客户端 (如 Claude Desktop 或 Cursor) 的服务器配置中，并确保 '$REPOSITORY_DIRECTORY' 和 '$AIVEN_TOKEN' 变量已正确配置。
连接与使用: 在 MCP 客户端中连接到 'mcp-aiven' 服务器后，即可通过客户端界面或命令调用 'list_projects', 'list_services', 'get_service_details' 等工具，与您的 Aiven 云服务进行交互。

关键词

使用说明

信息