Servidor MCP de Aiven

Un servidor de Protocolo de Contexto de Modelo (MCP) para Aiven.

Proporciona acceso a los servicios Aiven para PostgreSQL, Kafka, ClickHouse, Valkey y OpenSearch que se ejecutan en Aiven y al amplio ecosistema de conectores nativos de Aiven. Esto permite a los LLM crear soluciones completas para todos los casos de uso.

Características

Herramientas

• list_projects

  • Lista todos los proyectos de su cuenta Aiven.

• list_servicios

  • Lista todos los servicios de un proyecto específico de Aiven.

• get_service_details

  • Obtener el detalle de su servicio en un proyecto Aiven específico.

Configuración de Claude Desktop

1. Abra el archivo de configuración de Claude Desktop ubicado en:

   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • En Windows: %APPDATA%/Claude/claude_desktop_config.json

2. Añada lo siguiente

{ "mcpServers": { "mcp-aiven": { "command": "uv", "args": [ "--directory", "$REPOSITORIO_DIRECTORIO", "run", "--with-editable", "$REPOSITORIO_DIRECTORIO", "--python", "3.13", "mcp-aiven" ], "env": { "AIVEN_BASE_URL": "https://api.aiven.io", "AIVEN_TOKEN": "$AIVEN_TOKEN" } } }

Actualizar las variables de entorno:

• $REPOSITORY_DIRECTORY para que apunte a la carpeta que contiene el repositorio
• AIVEN_TOKEN al login de Aiven.

3. Localice la entrada del comando uv y sustitúyala por la ruta absoluta al ejecutable uv. Esto garantiza que se utilice la versión correcta de uv al iniciar el servidor. En un mac, puede encontrar esta ruta utilizando que uv.

4. Reinicie Claude Desktop para aplicar los cambios.

Configuración para Cursor

1. Navegue a Cursor -> Configuración -> Configuración del Cursor

2. Seleccione "Servidores MCP

3. Añada un nuevo servidor con

   • Nombre: mcp-aiven
   • Tipo: command
   • Comando: uv --directory $REPOSITORY_DIRECTORY run --with-editable $REPOSITORY_DIRECTORY --python 3.13 mcp-aiven

Donde $REPOSITORIO_DIRECTORIO es la ruta al repositorio. Puede que necesite añadir AIVEN_BASE_URL, AIVEN_PROJECT_NAME y AIVEN_TOKEN como variables

Desarrollo

1. Añade las siguientes variables a un archivo .env en la raíz del repositorio.

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

2. Ejecute uv sync para instalar las dependencias. Para instalar uv siga las instrucciones aquí. Luego haga source .venv/bin/activate.

3. Para facilitar las pruebas, puede ejecutar mcp dev mcp_aiven/mcp_server.py para iniciar el servidor MCP.

Variables de entorno

Las siguientes variables de entorno se utilizan para configurar la conexión Aiven:

Variables obligatorias

• AIVEN_BASE_URL: La url de la API de Aiven
• AIVEN_TOKEN: El token de autenticación

Consideraciones para desarrolladores sobre protocolos de contexto de modelo (MCP) y agentes de IA

En esta sección se describen las principales responsabilidades de los desarrolladores y las consideraciones de seguridad al trabajar con protocolos de contexto de modelo (MCP) y agentes de IA dentro de este sistema.MCP autogestionados:

• Responsabilidad del Cliente: Los MCPs se ejecutan dentro del entorno del usuario, no son alojados por Aiven. Por lo tanto, los usuarios son los únicos responsables de su gestión operativa, seguridad y cumplimiento, adhiriéndose al modelo de responsabilidad compartida.(https://aiven.io/responsibility-matrix)
• Despliegue y mantenimiento: Los desarrolladores deben encargarse de todos los aspectos relacionados con el despliegue, las actualizaciones y el mantenimiento del MCP.

Seguridad del Agente AI:

• Control de permisos: El acceso y las capacidades de los Agentes de IA se rigen estrictamente por los permisos concedidos al token de API utilizado para su autenticación. Los desarrolladores deben gestionar meticulosamente estos permisos.
• Gestión de credenciales: Tenga muy en cuenta que los Agentes de IA pueden necesitar credenciales de acceso (por ejemplo, cadenas de conexión a bases de datos, tokens de servicios de streaming) para realizar acciones en su nombre. Extreme las precauciones al proporcionar dichas credenciales a los Agentes de IA.
• Evaluación de riesgos: Cumpla las políticas de seguridad de su organización y realice evaluaciones de riesgo exhaustivas antes de conceder a los Agentes de IA acceso a recursos confidenciales.

Prácticas recomendadas para tokens de API:

• Principio del menor privilegio: Respete siempre el principio del menor privilegio. Los tokens de API deben tener un alcance y estar restringidos a los permisos mínimos necesarios para su función prevista.
• Gestión de tokens: Aplique prácticas sólidas de gestión de tokens, incluida la rotación periódica y el almacenamiento seguro.

Puntos clave:

• Los usuarios conservan el control y la responsabilidad totales de la ejecución y la seguridad del MCP.
• Los permisos del agente de IA están directamente vinculados a los permisos del token de la API.
• Extreme las precauciones al proporcionar credenciales a los Agentes de IA.
• Cumpla estrictamente el principio de mínimo privilegio al gestionar los tokens de API.