Aiven MCP

Aiven MCP服务器

A. 模型上下文协议 （MCP）服务器 艾文 云数据平台。

直接从Claude、Cursor和VS Code Copilot等AI助手管理PostgreSQL、Apache Kafka、应用程序和其他Aiven服务。

\[！警告\] 小心使用。 此MCP服务器可以代表您创建、修改和删除Aiven服务和数据。AI代理可能会根据它们对提示的解释执行破坏性操作（删除数据库、删除服务、生成消息）。您对通过此工具采取的行动负全部责任。 权限： 访问由与经过身份验证的帐户关联的Aiven用户权限管理。MCP服务器只能执行Aiven用户允许执行的操作。 AI代理安全： AI代理可能需要访问凭据（数据库连接字符串、流式令牌）来代表您行事。检查您的代理正在做什么，特别是在生产环境中。在允许AI代理访问敏感资源之前，请遵循您组织的安全策略并进行风险评估。

快速开始

选项1：远程（由Aiven托管）

MCP服务器托管在 https://mcp.aiven.live/mcp。您的MCP客户端将提示您在Aiven上进行授权。

克劳德代码

claude mcp add --scope user --transport http aiven-mcp "https://mcp.aiven.live/mcp"

光标

或手动添加到光标MCP设置：

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp"
    }
  }
}

VS代码/副本

添加 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "aiven-mcp": {
      "type": "http",
      "url": "https://mcp.aiven.live/mcp"
    }
  }
}

只读模式（远程）

通过添加启用只读模式 ?read_only=true 所有写入操作都将从MCP中排除：

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?read_only=true"
    }
  }
}

范围工具（远程）

通过添加 ?services_scope= 当您只使用Aiven服务的一个子集并希望保持代理的上下文集中时，这很有用。用逗号组合值。 core （项目/服务发现）总是隐式包含的。

有效范围： all, core, pg, kafka, application, integrations.使用 all 显式加载每个工具（与省略参数相同）。 all 不能与其他作用域组合。

{
  "mcpServers": {
    "aiven-mcp": {
      "url": "https://mcp.aiven.live/mcp?services_scope=kafka"
    }
  }
}

您还可以与 read_only:

https://mcp.aiven.live/mcp?services_scope=pg&read_only=true

选项2:stdio（本地）

将服务器作为MCP客户端的子进程在本地运行。需要Node.js 18+。

您必须通过 AIVEN_TOKEN 环境变量。 在此处创建令牌.

克劳德代码

claude mcp add --scope user aiven-mcp -e AIVEN_TOKEN=your-token-here -- npx -y mcp-aiven

光标，VS代码 --添加到MCP客户端配置中：

{
  "mcpServers": {
    "aiven-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-aiven"],
      "env": {
        "AIVEN_TOKEN": "your-token-here"
      }
    }
  }
}

配置文件位置：

• 光标：光标设置>MCP服务器
• VS代码： .vscode/mcp.json 在您的工作空间中

方案3：地方发展

运行服务器的本地构建（对开发和测试很有用）：

pnpm install && pnpm generate:api-types && pnpm generate && pnpm build && AIVEN_TOKEN="" MCP_TRANSPORT="http" PORT=3000 node dist/index.js

默认情况下，服务器在端口3000上侦听。将您的MCP客户端连接到 http://localhost:3000/mcp.

要将远程部署指向自定义主机（例如本地构建），请设置 MCP_HOST:

MCP_HOST=http://localhost:3000 node dist/index.js

环境变量

在远程（HTTP）模式下， AIVEN_TOKEN 不需要。您的MCP客户端在每次请求时都会将您的令牌作为承载令牌发送。

工具

核心

卡夫卡

PostgreSQL

应用程序

文档

贡献

看 贡献.md 用于开发设置、本地运行和添加新工具。

许可证

阿帕奇-2.0