Сервер MCP Aiven

Сервер протокола контекста модели (MCP) для Aiven.

Это обеспечивает доступ к сервисам Aiven для PostgreSQL, Kafka, ClickHouse, Valkey и OpenSearch, работающим в Aiven, и более широкой экосистеме собственных коннекторов Aiven. Позволяет LLM создавать полнофункциональные решения для всех вариантов использования.

Функции

Инструменты

list_projects
- Перечислите все проекты в вашей учетной записи Aiven.
list_services
- Перечислите все услуги в конкретном проекте Aiven.
get_service_details
- Получите подробную информацию о вашем услуге в конкретном проекте Aiven.

Related MCP server: MCP Salesforce Connector

Конфигурация для Claude Desktop

Откройте файл конфигурации Claude Desktop, расположенный по адресу:
- В macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- В Windows: %APPDATA%/Claude/claude_desktop_config.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" } } } }

Обновите переменные среды:

$REPOSITORY_DIRECTORY для указания на папку, содержащую репозиторий
AIVEN_TOKEN к токену входа Aiven .

Найдите запись команды для uv и замените ее абсолютным путем к исполняемому файлу uv . Это гарантирует, что при запуске сервера будет использоваться правильная версия uv . На Mac вы можете найти этот путь, используя which uv .
Перезапустите Claude Desktop, чтобы изменения вступили в силу.

Конфигурация для курсора

Перейдите в Курсор -> Настройки -> Настройки курсора.
Выберите «Серверы MCP»
Добавьте новый сервер с
- Имя: 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 в качестве переменных

Разработка

Добавьте следующие переменные в файл .env в корне репозитория.

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

Запустите uv sync для установки зависимостей. Для установки uv следуйте инструкциям здесь . Затем выполните source .venv/bin/activate .
Для простоты тестирования вы можете запустить mcp dev mcp_aiven/mcp_server.py чтобы запустить сервер MCP.

Переменные среды

Для настройки соединения Aiven используются следующие переменные среды:

Требуемые переменные

AIVEN_BASE_URL : URL-адрес API Aiven.
AIVEN_TOKEN : токен аутентификации.

Рекомендации разработчикам по протоколам контекста модели (MCP) и агентам ИИ

В этом разделе излагаются основные обязанности разработчиков и соображения безопасности при работе с протоколами контекста модели (MCP) и агентами ИИ в этой системе. Самоуправляемые MCP:

Ответственность клиента: MCP выполняются в среде пользователя, а не размещаются Aiven. Таким образом, пользователи несут исключительную ответственность за свое операционное управление, безопасность и соответствие, придерживаясь модели общей ответственности. ( https://aiven.io/responsibility-matrix )
Развертывание и обслуживание: Разработчики должны заниматься всеми аспектами развертывания, обновления и обслуживания MCP.

Безопасность агента ИИ:

Контроль разрешений: Доступ и возможности агентов ИИ строго регламентируются разрешениями, предоставленными токену API, используемому для их аутентификации. Разработчики должны тщательно управлять этими разрешениями.
Обработка учетных данных: будьте предельно осторожны, поскольку агентам ИИ могут потребоваться учетные данные для доступа (например, строки подключения к базе данных, токены потокового сервиса) для выполнения действий от вашего имени. Соблюдайте крайнюю осторожность при предоставлении таких учетных данных агентам ИИ.
Оценка рисков: соблюдайте политику безопасности вашей организации и проводите тщательную оценку рисков, прежде чем предоставлять агентам ИИ доступ к конфиденциальным ресурсам.

Лучшие практики использования токенов API:

Принцип наименьших привилегий: Всегда придерживайтесь принципа наименьших привилегий. API-токены должны быть ограничены минимальными разрешениями, необходимыми для их предполагаемой функции.
Управление токенами: Внедрите надежные методы управления токенами, включая регулярную ротацию и безопасное хранение.

Основные выводы:

Пользователи сохраняют полный контроль и ответственность за выполнение и безопасность MCP.
Разрешения AI Agent напрямую связаны с разрешениями API-токена.
Будьте предельно осторожны при предоставлении учетных данных агентам ИИ.
Строго придерживайтесь принципа наименьших привилегий при управлении токенами API.