Manticore Search

Servidor MCP para Manticore Search — consultar e gerenciar banco de dados de busca

Documentação

Servidor MCP do Manticore Search

Servidor MCP para Manticore Search — permite que assistentes de IA consultem e gerenciem bancos de dados Manticore Search diretamente.

Início Rápido

Instalação

# Option 1: Install with uv (recommended, requires PyPI release)
uvx mcp-manticore

# Option 2: Install with pip
pip install mcp-manticore

# Option 3: Run from source (for local development)
uvx --from . mcp-manticore
# Or: uv run mcp-manticore

Nota:

uvx executa o pacote diretamente sem instalação. A primeira execução pode levar um momento para baixar as dependências.

O pacote deve ser publicado no PyPI para que uvx mcp-manticore funcione.

Para desenvolvimento local ou teste de versões não lançadas, use uvx --from . mcp-manticore

O Que Ele Faz

Ferramentas

Ferramenta	Descrição
`run_query`	Executa consultas SQL (SELECT, SHOW, DESCRIBE, etc.)
`list_tables`	Lista todas as tabelas e índices
`describe_table`	Obtém o esquema da tabela
`list_documentation`	Lista arquivos de documentação disponíveis
`get_documentation`	Busca documentação específica do manual do Manticore

Prompts

manticore_initial_prompt — Prompt integrado que ensina LLMs sobre os recursos do Manticore Search (operadores de texto completo, busca vetorial KNN, busca difusa, etc.)

Verificação de Saúde

Endpoint HTTP em /health para monitoramento de conectividade.

Configuração

Variáveis de Ambiente

Variável	Padrão	Descrição
`MANTICORE_HOST`	`localhost`	Host do servidor Manticore
`MANTICORE_PORT`	`9308`	Porta da API HTTP
`MANTICORE_USER`	—	Nome de usuário (opcional)
`MANTICORE_PASSWORD`	—	Senha (opcional)
`MANTICORE_CONNECT_TIMEOUT`	`30`	Tempo limite de conexão (segundos)
`MANTICORE_QUERY_TIMEOUT`	`30`	Tempo limite de consulta (segundos)
`MANTICORE_ALLOW_WRITE_ACCESS`	`false`	Habilita operações de escrita (INSERT, UPDATE, DELETE)
`MANTICORE_ALLOW_DROP`	`false`	Habilita operações destrutivas (DROP, TRUNCATE)
`GITHUB_TOKEN`	—	Token do GitHub para limite de taxa de API maior

Segurança

Por padrão, todas as operações de escrita são bloqueadas. Para habilitar:

# Enable writes (INSERT, UPDATE, DELETE)
export MANTICORE_ALLOW_WRITE_ACCESS=true

# Enable destructive operations (DROP, TRUNCATE)
export MANTICORE_ALLOW_DROP=true

Conecte ao Seu Assistente de IA

Claude Code

Abra o terminal e execute:

claude mcp add manticore -- uvx mcp-manticore

Ou com variáveis de ambiente:

claude mcp add manticore -- uvx mcp-manticore -- \
  MANTICORE_HOST=localhost \
  MANTICORE_PORT=9308

Para configuração completa, edite ~/.claude/mcp_settings.json:

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Reinicie o Claude Code ou digite /mcp restart para aplicar as alterações.

Cursor

Método 1: Via Interface de Configurações

Abra o Cursor → Configurações → Ferramentas e MCP
Clique em "Adicionar Servidor MCP"
Digite o nome: manticore
Comando: uvx mcp-manticore

Método 2: Via Arquivo de Configuração

Configuração global (~/.cursor/mcp.json):

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Configuração do projeto (.cursor/mcp.json no seu projeto):

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"]
    }
  }
}

Windsurf

Método 1: Via Interface Cascade

Abra o Windsurf → painel Cascade
Clique no ícone de MCPs (🔨) no canto superior direito
Clique em "Adicionar Servidor"
Digite: uvx mcp-manticore

Método 2: Via Arquivo de Configuração

Edite ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Ou abra diretamente no Windsurf: Cmd/Ctrl + Shift + P → "Painel de Configuração MCP"

OpenAI Codex

Execute no terminal:

codex mcp add manticore -- uvx mcp-manticore

Com variáveis de ambiente:

codex mcp add manticore \
  --env MANTICORE_HOST=localhost \
  --env MANTICORE_PORT=9308 \
  -- uvx mcp-manticore

Ou edite ~/.codex/config.toml diretamente:

[mcp_servers.manticore]
command = "uvx"
args = ["mcp-manticore"]
env = { MANTICORE_HOST = "localhost", MANTICORE_PORT = "9308" }

Gemini CLI

Edite ~/.gemini/settings.json:

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

VS Code (GitHub Copilot)

Crie .vscode/mcp.json no seu espaço de trabalho:

{
  "servers": {
    "manticore": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Cline

Abra o painel Cline no VS Code
Clique no ícone de Servidores MCP
Clique em "Configurar" → "Adicionar Servidor"
Selecione "Comando (stdio)" e digite:
- Nome: manticore
- Comando: uvx mcp-manticore

Ou edite o arquivo de configurações MCP diretamente (acessível via ícone de Servidores MCP → "Editar Configuração"):

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Roo Code

Abra o painel Roo Code no VS Code
Clique no ícone de Servidores MCP → "Editar Configurações MCP"
Adicione a configuração do servidor

Ou crie .roo/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Claude Desktop (Legacy)

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}

Transporte HTTP (MCP Remoto)

Por padrão, o MCP usa stdio (local). Para acesso remoto:

export MANTICORE_MCP_SERVER_TRANSPORT=http
export MANTICORE_MCP_BIND_PORT=8000
export MANTICORE_MCP_AUTH_TOKEN="your-secure-token"

uvx mcp-manticore

Conecte via URL:

{
  "mcpServers": {
    "manticore": {
      "url": "http://localhost:8000/mcp",
      "headers": {
        "Authorization": "Bearer your-secure-token"
      }
    }
  }
}

Solução de Problemas

Instalar uv (obrigatório)

macOS / Linux:

# Via installer script (recommended)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via Homebrew
brew install uv

Windows:

# Via PowerShell
irm https://astral.sh/uv/install.ps1 | iex

# Or via winget
winget install astral-sh.uv

Verifique a instalação:

uv --version

Servidor MCP não está conectando

Verifique se o Manticore está em execução: curl http://localhost:9308/health
Verifique se as variáveis de ambiente estão configuradas corretamente
Para Claude Code: reinicie com /mcp restart

Muitas ferramentas carregadas

Alguns agentes limitam as ferramentas MCP ativas. Remova servidores não utilizados ou use configurações específicas do projeto.

Desenvolvimento

# Clone and setup
git clone https://github.com/manticoresoftware/mcp-manticore.git
cd mcp-manticore

# Install dependencies
uv sync

# Run locally
uv run mcp-manticore

# Run with custom config
MANTICORE_HOST=remote-server MANTICORE_PORT=9308 uv run mcp-manticore

# Run tests
uv run pytest

# Build package
uv build

# Publish to PyPI
uv publish

Arquitetura

Arquivo	Finalidade
`mcp_manticore/mcp_env.py`	Gerenciamento de configuração
`mcp_manticore/mcp_server.py`	Implementação do servidor MCP
`mcp_manticore/manticore_prompt.py`	Orientação/prompts para LLM
`mcp_manticore/docs_fetcher.py`	Buscador de documentação do GitHub
`mcp_manticore/main.py`	Ponto de entrada da CLI

Licença

Apache-2.0