基本能力
产品定位
mcp-aiven 是一个用于访问和管理 Aiven 平台服务的 MCP 服务器,旨在为开发者提供便捷的工具和接口,以便通过 LLMs 构建全栈解决方案。
核心功能
- 工具列表
list_projects
:列出 Aiven 账户中的所有项目。list_services
:列出特定 Aiven 项目中的所有服务。-
get_service_details
:获取特定 Aiven 项目中服务的详细信息。 -
适用场景
- 通过 LLMs 构建全栈解决方案。
- 管理和监控 Aiven 平台上的多种数据库和服务。
- 自动化开发流程,提高开发效率。
常见问题解答
- 权限控制:AI Agents 的访问权限由 API 令牌的权限控制,开发者需谨慎管理权限。
- 凭证安全:AI Agents 可能需要访问敏感凭证(如数据库连接字符串),需谨慎处理。
- API 令牌管理:遵循最小权限原则,定期轮换和安全管理 API 令牌。
使用教程
使用依赖
- 安装
uv
工具,参考 官方文档。 - 创建
.env
文件并配置以下环境变量:
AIVEN_BASE_URL=https://api.aiven.io
AIVEN_TOKEN=$AIVEN_TOKEN
安装教程
- 运行以下命令安装依赖:
bash
uv sync
source .venv/bin/activate - 启动 MCP 服务器:
bash
mcp dev mcp_aiven/mcp_server.py
调试方式
- 确保环境变量已正确配置。
- 检查
uv
工具的路径是否正确。 - 重启 Claude Desktop 或 Cursor 以应用配置更改。
配置示例
Claude Desktop 配置
- 编辑配置文件
claude_desktop_config.json
,添加以下内容:
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"
}
}
}
}
Cursor 配置
- 在 Cursor 设置中添加 MCP 服务器:
- 名称:
mcp-aiven
- 类型:
command
- 命令:
uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven