Aiven MCP Server

这是Aiven的模型上下文协议（MCP）服务器。

它提供了对运行在Aiven及其更广泛的原生连接器生态系统中的PostgreSQL、Kafka、ClickHouse、Valkey和OpenSearch服务的访问。使LLMs能够为所有用例构建全栈解决方案。

功能

工具

• 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版本。在Mac上，可以使用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作为变量。

开发

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

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

2. 运行uv sync以安装依赖项。要安装uv，请遵循此处的说明。然后执行source .venv/bin/activate。

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

环境变量

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

必需变量

• AIVEN_BASE_URL：Aiven API URL
• AIVEN_TOKEN：身份验证令牌

开发者考虑事项：模型上下文协议（MCPs）和AI代理

本节概述了在该系统内使用模型上下文协议（MCPs）和AI代理时的关键开发者责任和安全注意事项。 自托管MCPs：

• 客户责任：MCPs在用户的环境中执行，而不是由Aiven托管。因此，用户完全负责其操作管理、安全性和合规性，遵守共享责任模型。（https://aiven.io/responsibility-matrix）
• 部署和维护：开发者必须处理MCP的所有部署、更新和维护方面。

AI代理安全：

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

API令牌最佳实践：

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

关键要点：

• 用户保留对MCP执行和安全性的完全控制和责任。
• AI代理的权限直接与API令牌的权限相关联。
• 提供凭证给AI代理时应极其谨慎。
• 严格遵守最小特权原则来管理API令牌。