Aiven

Gestiona servicios en la nube de Aiven como Kafka, PostgreSQL y Redis a través de su API.

GitHub

Documentación

MCP Aiven Docker

Un contenedor Docker simple para el servidor MCP Aiven.

Configuración

  1. Crea un archivo .env con tus credenciales de Aiven:
# Aiven API configuration
AIVEN_BASE_URL=https://api.aiven.io
AIVEN_PROJECT_NAME=your-project-name

# Aiven Authentication Token
AIVEN_TOKEN=your-token-here
  1. Construye y ejecuta el contenedor Docker:
docker-compose up -d
  1. Accede al servidor en http://localhost:8000

Endpoints de API

  • GET /: Página HTML que muestra el estado del servidor y las variables de entorno
  • GET /api/projects: Respuesta JSON con la lista de proyectos

Detener el servidor

docker-compose down

Servidor MCP de Aiven

Un servidor MCP para Aiven.

Características

Herramientas

  • list_projects

    • Lista todos los proyectos de tu cuenta de Aiven.

  • list_services

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

  • get_service_details

    • Obtén el detalle de tu servicio en un proyecto específico de Aiven.

  • get_metadata

    • Obtén los metadatos de un servicio específico de Aiven, actualmente solo funciona para Aiven para PostgreSQL®.

  • run_query

    • Ejecuta una consulta contra un servicio específico de Aiven, actualmente solo funciona para Aiven para PostgreSQL®.

Configuración para Claude Desktop

  1. Abre 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ñade lo siguiente:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "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_PROJECT_NAME": "$DEFAULT_PROJECT_NAME",
        "AIVEN_TOKEN": "$AIVEN_TOKEN"
      }
    }
  }
}

Actualiza las variables de entorno:

  • $REPOSITORY_DIRECTORY para que apunte a la carpeta que contiene el repositorio
  • AIVEN_PROJECT_NAME al nombre del proyecto por defecto
  • AIVEN_TOKEN al token de inicio de sesión de Aiven.

  1. Localiza la entrada de comando para uv y reemplázala con la ruta absoluta al ejecutable uv. Esto asegura que se use la versión correcta de uv al iniciar el servidor. En una Mac, puedes encontrar esta ruta usando which uv.

  2. Reinicia Claude Desktop para aplicar los cambios.

Configuración para Cursor

  1. Navega a Cursor -> Configuración -> Configuración de Cursor

  2. Selecciona "Servidores MCP"

  3. Añade 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 $REPOSITORY_DIRECTORY es la ruta al repositorio. Es posible que necesites 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_PROJECT_NAME=$DEFAULT_PROJECT_NAME
AIVEN_TOKEN=$AIVEN_TOKEN

  1. Ejecuta uv sync para instalar las dependencias. Para instalar uv sigue las instrucciones aquí. Luego haz source .venv/bin/activate.

  2. Para pruebas fáciles, puedes 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 a ClickHouse:

Variables requeridas

  • AIVEN_BASE_URL: La URL de la API de Aiven
  • AIVEN_PROJECT_NAME: El nombre del proyecto por defecto
  • AIVEN_TOKEN: El token de autenticación =======

mcp-demo

Repositorio privado de demostración para probar el alojamiento de MCP en Aiven.