local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides access to Aiven for ClickHouse services, allowing interaction with analytical databases hosted on the Aiven platform.
Enables working with Aiven for OpenSearch services, providing tools to interact with search and analytics capabilities.
Enables interaction with Aiven for PostgreSQL services, allowing access to database resources hosted on the Aiven platform.

Aiven MCP 服务器

这允许访问在 Aiven 中运行的 Aiven for PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 服务，以及更广泛的 Aiven 原生连接器生态系统。使 LLM 能够为所有用例构建全栈解决方案。

特征

工具

list_projects
- 列出您的 Aiven 帐户上的所有项目。
list_services
- 列出特定 Aiven 项目中的所有服务。
get_service_details
- 获取特定 Aiven 项目中服务的详细信息。

Claude 桌面配置

打开位于以下位置的 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 登录令牌。

找到uv的命令条目，并将其替换为uv可执行文件的绝对路径。这可确保启动服务器时使用正确版本的uv 。在 Mac 上，您可以使用which uv找到此路径。
重新启动 Claude Desktop 以应用更改。

光标配置

导航至光标 -> 设置 -> 光标设置
选择“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作为变量。

发展

将以下变量添加到存储库根目录中的.env文件中。

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

运行uv sync来安装依赖项。要安装uv ，请按照此处的说明操作。然后执行source .venv/bin/activate 。
为了方便测试，您可以运行mcp dev mcp_aiven/mcp_server.py来启动 MCP 服务器。

环境变量

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

必需变量

AIVEN_BASE_URL ：Aiven API url
AIVEN_TOKEN ：身份验证令牌

模型上下文协议 (MCP) 和 AI 代理的开发人员注意事项

本节概述了使用本系统内的模型上下文协议 (MCP) 和 AI 代理时，开发人员的主要职责和安全注意事项。自管理 MCP：

客户责任： MCP 在用户环境中运行，而非由 Aiven 托管。因此，用户应自行负责其运营管理、安全性和合规性，并遵循共担责任模式。( https://aiven.io/responsibility-matrix )
**部署和维护：**开发人员必须处理 MCP 部署、更新和维护的所有方面。

AI代理安全：

权限控制： AI 代理的访问和功能严格受用于身份验证的 API 令牌授予的权限控制。开发人员必须精心管理这些权限。
**凭证处理：**请谨慎注意，AI 代理可能需要访问凭证（例如，数据库连接字符串、流媒体服务令牌）才能代表您执行操作。向 AI 代理提供此类凭证时请务必谨慎。
**风险评估：**在授予 AI 代理访问敏感资源的权限之前，请遵守组织的安全政策并进行彻底的风险评估。

API 令牌最佳实践：

**最小权限原则：**始终遵循最小权限原则。API 令牌应限定其使用范围，并限制在其预期功能所需的最低权限范围内。
**令牌管理：**实施强大的令牌管理实践，包括定期轮换和安全存储。

关键要点：

用户对 MCP 的执行和安全拥有完全的控制权和责任。
AI 代理权限与 API 令牌权限直接相关。
向 AI 代理提供凭证时要格外小心。
管理 API 令牌时严格遵守最小特权原则。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

模型上下文协议服务器提供对 Aiven 服务（PostgreSQL、Kafka、ClickHouse、Valkey、OpenSearch）的访问，使 LLM 能够通过与这些服务交互来构建全栈解决方案。

Aiven MCP Server