Aiven MCP Server

Сервер MCP Aiven

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

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

Функции

Инструменты

• 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. Добавьте следующее:

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

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

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

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

1. Перейдите в Курсор -> Настройки -> Настройки курсора.
2. Выберите «Серверы MCP»
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 в корне репозитория.

2. Запустите uv sync для установки зависимостей. Для установки uv следуйте инструкциям здесь . Затем выполните source .venv/bin/activate .
3. Для простоты тестирования вы можете запустить 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.