AI导哈

Aiven Docker容器服务

一个简单的Docker容器，用于运行MCP Aiven服务器，提供项目和服务管理功能。

  • by JohnKennedyOSS
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 johnkennedyoss/mcp-demo

使用说明

MCP Aiven Docker

MCP Aiven服务器的简单Docker容器。

设置

  1. 创建一个 .env 使用您的Aiven凭据进行归档：
# Aiven API configuration
AIVEN_BASE_URL=https://api.aiven.io
AIVEN_PROJECT_NAME=your-project-name

# Aiven Authentication Token
AIVEN_TOKEN=your-token-here
  1. 构建并运行Docker容器：
docker-compose up -d
  1. 访问服务器http://localhost:8000

API终点

  • GET /：显示服务器状态和环境变量的HTML页面
  • GET /api/projects：带有项目列表的JSON响应

停止服务器

docker-compose down

Aiven MCP服务器

Aiven的MCP服务器。

特性

工具

  • list_projects

    • 列出您Aiven帐户上的所有项目。

  • list_services

    • 列出特定Aiven项目中的所有服务。

  • get_service_details

    • 在特定的Aiven项目中获取您的服务细节。

  • get_metadata

    • 获取特定Aiven服务的元数据，目前仅适用于PostgreSQL®的Aiven。

  • run_query

    • 对特定的Aiven服务运行查询，目前仅适用于PostgreSQL®的Aiven。

Claude桌面配置

  1. 打开位于以下位置的Claude Desktop配置文件：

    • 在 macOS 上： ~/Library/Application Support/Claude/claude_desktop_config.json
    • 在Windows上： %APPDATA%/Claude/claude_desktop_config.json

  2. 添加以下内容：

{
  "mcpServers": {
    "mcp-clickhouse": {
      "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_PROJECT_NAME": "$DEFAULT_PROJECT_NAME",
        "AIVEN_TOKEN": "$AIVEN_TOKEN"
      }
    }
  }
}

更新环境变量：

  • $REPOSITORY_DIRECTORY 指向包含存储库的文件夹
  • AIVEN_PROJECT_NAME 默认项目名称
  • AIVEN_TOKEN 到 Aiven登录令牌.

  1. 找到以下命令项 uv 并将其替换为指向的绝对路径 uv 可执行。这确保了正确的版本 uv 启动服务器时使用。在mac上，您可以使用以下命令找到此路径 which uv.

  2. 重新启动Claude Desktop以应用更改。

光标配置

  1. 导航到光标->设置->光标设置

  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 AS变量

发展

  1. 将以下变量添加到 .env 存储库根目录中的文件。
AIVEN_BASE_URL=https://api.aiven.io
AIVEN_PROJECT_NAME=$DEFAULT_PROJECT_NAME
AIVEN_TOKEN=$AIVEN_TOKEN

  1. 跑 uv sync 安装依赖项。安装 uv 按照说明 这里。那就去吧 source .venv/bin/activate.

  2. 为了便于测试，您可以运行 mcp dev mcp_aiven/mcp_server.py 启动MCP服务器。

环境变量

以下环境变量用于配置ClickHouse连接：

必需变量

  • AIVEN_BASE_URL：Aiven API网址
  • AIVEN_PROJECT_NAME：默认项目名称
  • AIVEN_TOKEN：身份验证令牌 =======

mcp演示

在Aiven上测试mcp托管的演示私有仓库。

相关 MCP