Aiven

MCP Aiven Docker

Um contêiner Docker simples para o servidor MCP Aiven.

Configuração

1. Crie um arquivo .env com suas credenciais da 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

2. Compile e execute o contêiner Docker:

docker-compose up -d

3. Acesse o servidor em http://localhost:8000

Endpoints da API

• GET /: página HTML que mostra o status do servidor e as variáveis de ambiente
• GET /api/projects: resposta JSON com a lista de projetos

Parando o Servidor

docker-compose down

Servidor MCP Aiven

Um servidor MCP para Aiven.

Recursos

Ferramentas

• list_projects

  • Liste todos os projetos na sua conta Aiven.

• list_services

  • Liste todos os serviços em um projeto Aiven específico.

• get_service_details

  • Obtenha os detalhes do seu serviço em um projeto Aiven específico.

• get_metadata

  • Obtenha os metadados de um serviço Aiven específico, atualmente funcionando apenas para Aiven for PostgreSQL®.

• run_query

  • Execute uma consulta contra um serviço Aiven específico, atualmente funcionando apenas para Aiven for PostgreSQL®.

Configuração para Claude Desktop

1. Abra o arquivo de configuração do Claude Desktop localizado em:

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

2. Adicione o seguinte:

{
  "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"
      }
    }
  }
}

Atualize as variáveis de ambiente:

• $REPOSITORY_DIRECTORY para apontar para a pasta que contém o repositório
• AIVEN_PROJECT_NAME para o nome do projeto padrão
• AIVEN_TOKEN para o token de login da Aiven.

3. Localize a entrada de comando para uv e substitua-a pelo caminho absoluto para o executável uv. Isso garante que a versão correta de uv seja usada ao iniciar o servidor. Em um Mac, você pode encontrar esse caminho usando which uv.

4. Reinicie o Claude Desktop para aplicar as alterações.

Configuração para Cursor

1. Navegue até Cursor -> Settings -> Cursor Settings

2. Selecione "MCP Servers"

3. Adicione um novo servidor com

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

Onde $REPOSITORY_DIRECTORY é o caminho para o repositório. Talvez seja necessário adicionar AIVEN_BASE_URL, AIVEN_PROJECT_NAME e AIVEN_TOKEN como variáveis

Desenvolvimento

1. Adicione as seguintes variáveis a um arquivo .env na raiz do repositório.

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

2. Execute uv sync para instalar as dependências. Para instalar o uv, siga as instruções aqui. Em seguida, execute source .venv/bin/activate.

3. Para testes fáceis, você pode executar mcp dev mcp_aiven/mcp_server.py para iniciar o servidor MCP.

Variáveis de Ambiente

As seguintes variáveis de ambiente são usadas para configurar a conexão com o ClickHouse:

Variáveis Obrigatórias

• AIVEN_BASE_URL: a URL da API da Aiven
• AIVEN_PROJECT_NAME: o nome do projeto padrão
• AIVEN_TOKEN: o token de autenticação =======

mcp-demo

Repositório privado de demonstração para testar a hospedagem do MCP na Aiven.