# 安装 Aiven MCP

- 类型: MCP 工具
- 说明: 通过 AI 助手完成 Aiven 数据库、Kafka 与应用部署运维管理
- 仓库: https://github.com/aiven-open/mcp-aiven

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Aiven MCP" MCP 服务：
执行：claude mcp add 'io-aiven-mcp' -- npx -y mcp-aiven
```

### Codex
```
请帮我安装 askskill 上的 "Aiven MCP" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-aiven-mcp]
command = "npx"
args = ["-y","mcp-aiven"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Aiven MCP" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-aiven-mcp": { "command": "npx", "args": ["-y","mcp-aiven"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env AIVEN_TOKEN=YOUR_VALUE --env AIVEN_READ_ONLY=YOUR_VALUE --env AIVEN_SERVICES_SCOPE=YOUR_VALUE --env AIVEN_ALLOW_SECRETS=YOUR_VALUE --transport stdio io-aiven-mcp -- npx -y mcp-aiven
```
需要环境变量：AIVEN_TOKEN, AIVEN_READ_ONLY, AIVEN_SERVICES_SCOPE, AIVEN_ALLOW_SECRETS

### Codex
```bash
codex mcp add --env AIVEN_TOKEN=YOUR_VALUE --env AIVEN_READ_ONLY=YOUR_VALUE --env AIVEN_SERVICES_SCOPE=YOUR_VALUE --env AIVEN_ALLOW_SECRETS=YOUR_VALUE io-aiven-mcp -- npx -y mcp-aiven
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-aiven-mcp]
command = "npx"
args = ["-y","mcp-aiven"]

[mcp_servers.io-aiven-mcp.env]
AIVEN_TOKEN = "YOUR_VALUE"
AIVEN_READ_ONLY = "YOUR_VALUE"
AIVEN_SERVICES_SCOPE = "YOUR_VALUE"
AIVEN_ALLOW_SECRETS = "YOUR_VALUE"
```
需要环境变量：AIVEN_TOKEN, AIVEN_READ_ONLY, AIVEN_SERVICES_SCOPE, AIVEN_ALLOW_SECRETS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-aiven-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-aiven"
      ],
      "env": {
        "AIVEN_TOKEN": "YOUR_VALUE",
        "AIVEN_READ_ONLY": "YOUR_VALUE",
        "AIVEN_SERVICES_SCOPE": "YOUR_VALUE",
        "AIVEN_ALLOW_SECRETS": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-aiven-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1haXZlbiJdLCJlbnYiOnsiQUlWRU5fVE9LRU4iOiJZT1VSX1ZBTFVFIiwiQUlWRU5fUkVBRF9PTkxZIjoiWU9VUl9WQUxVRSIsIkFJVkVOX1NFUlZJQ0VTX1NDT1BFIjoiWU9VUl9WQUxVRSIsIkFJVkVOX0FMTE9XX1NFQ1JFVFMiOiJZT1VSX1ZBTFVFIn19
需要环境变量：AIVEN_TOKEN, AIVEN_READ_ONLY, AIVEN_SERVICES_SCOPE, AIVEN_ALLOW_SECRETS