Aiven MCP 服务器

Aiven 的 模型上下文协议 (MCP) 服务器。

这提供了对在 Aiven 中运行的 PostgreSQL、Kafka、ClickHouse、Valkey 和 OpenSearch 服务以及更广泛的 Aiven 生态系统中的原生连接器的访问。使 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 登录令牌。

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

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

Cursor 配置

1. 导航到 Cursor -> 设置 -> Cursor 设置

2. 选择 "MCP Servers"

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

1. 运行 uv sync 安装依赖项。要安装 uv，请按照此处的说明操作。然后执行 source .venv/bin/activate。

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

环境变量

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

必需变量

• AIVEN_BASE_URL: Aiven API 的 URL
• AIVEN_TOKEN: 认证令牌

针对模型上下文协议 (MCPs) 和 AI 代理的开发者注意事项

本节概述了在此系统中使用模型上下文协议 (MCPs) 和 AI 代理时的关键开发者职责和安全考虑。
自管理 MCPs：

希望这些翻译对你有帮助！如果还有其他部分需要翻译或修改，请告诉我。

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

AI 代理安全：

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

API 令牌最佳实践：

• 最小权限原则： 始终遵循最小权限原则。API 令牌应被限制为仅具有其预期功能所需的最低权限。
• 令牌管理： 实施强大的令牌管理实践，包括定期轮换和安全存储。

关键要点：

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