Manticore Search

Servidor MCP para Manticore Search — consulta y gestiona la base de datos de búsqueda

Documentación

Servidor MCP de Manticore Search

Servidor MCP para Manticore Search: permite a los asistentes de IA consultar y gestionar bases de datos de Manticore Search directamente.

Inicio rápido

Instalación

# 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 ejecuta el paquete directamente sin instalación. La primera ejecución puede tardar un momento en descargar dependencias.

El paquete debe publicarse en PyPI para que uvx mcp-manticore funcione.

Para desarrollo local o pruebas de versiones no publicadas, usa uvx --from . mcp-manticore

Qué hace

Herramientas

Herramienta	Descripción
`run_query`	Ejecuta consultas SQL (SELECT, SHOW, DESCRIBE, etc.)
`list_tables`	Lista todas las tablas e índices
`describe_table`	Obtiene el esquema de la tabla
`list_documentation`	Lista los archivos de documentación disponibles
`get_documentation`	Obtiene documentación específica del manual de Manticore

Prompts

manticore_initial_prompt — Prompt integrado que enseña a los LLM sobre las características de Manticore Search (operadores de texto completo, búsqueda vectorial KNN, búsqueda difusa, etc.)

Verificación de salud

Endpoint HTTP en /health para monitorear la conectividad.

Configuración

Variables de entorno

Variable	Predeterminado	Descripción
`MANTICORE_HOST`	`localhost`	Host del servidor Manticore
`MANTICORE_PORT`	`9308`	Puerto de la API HTTP
`MANTICORE_USER`	—	Nombre de usuario (opcional)
`MANTICORE_PASSWORD`	—	Contraseña (opcional)
`MANTICORE_CONNECT_TIMEOUT`	`30`	Tiempo de espera de conexión (segundos)
`MANTICORE_QUERY_TIMEOUT`	`30`	Tiempo de espera de consulta (segundos)
`MANTICORE_ALLOW_WRITE_ACCESS`	`false`	Habilitar operaciones de escritura (INSERT, UPDATE, DELETE)
`MANTICORE_ALLOW_DROP`	`false`	Habilitar operaciones destructivas (DROP, TRUNCATE)
`GITHUB_TOKEN`	—	Token de GitHub para un límite de tasa de API más alto

Seguridad

Por defecto, todas las operaciones de escritura están bloqueadas. Para habilitarlas:

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

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

Conecta a tu asistente de IA

Claude Code

Abre la terminal y ejecuta:

claude mcp add manticore -- uvx mcp-manticore

O con variables de entorno:

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

Para una configuración completa, edita ~/.claude/mcp_settings.json:

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

Reinicia Claude Code o escribe /mcp restart para aplicar los cambios.

Cursor

Método 1: Mediante la interfaz de configuración

Abre Cursor → Configuración → Herramientas y MCP
Haz clic en "Agregar servidor MCP"
Ingresa el nombre: manticore
Comando: uvx mcp-manticore

Método 2: Mediante el archivo de configuración

Configuración global (~/.cursor/mcp.json):

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

Configuración del proyecto (.cursor/mcp.json en tu proyecto):

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

Windsurf

Método 1: Mediante la interfaz de Cascade

Abre Windsurf → panel de Cascade
Haz clic en el ícono de MCPs (🔨) en la esquina superior derecha
Haz clic en "Agregar servidor"
Ingresa: uvx mcp-manticore

Método 2: Mediante el archivo de configuración

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

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

O abre directamente en Windsurf: Cmd/Ctrl + Shift + P → "Panel de configuración de MCP"

OpenAI Codex

Ejecuta en la terminal:

codex mcp add manticore -- uvx mcp-manticore

Con variables de entorno:

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

O edita ~/.codex/config.toml directamente:

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

Gemini CLI

Edita ~/.gemini/settings.json:

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

VS Code (GitHub Copilot)

Crea .vscode/mcp.json en tu espacio de trabajo:

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

Cline

Abre el panel de Cline en VS Code
Haz clic en el ícono de Servidores MCP
Haz clic en "Configurar" → "Agregar servidor"
Selecciona "Comando (stdio)" e ingresa:
- Nombre: manticore
- Comando: uvx mcp-manticore

O edita directamente el archivo de configuración de MCP (accesible mediante el ícono de Servidores MCP → "Editar configuración"):

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

Roo Code

Abre el panel de Roo Code en VS Code
Haz clic en el ícono de Servidores MCP → "Editar configuración de MCP"
Agrega la configuración del servidor

O crea .roo/mcp.json en la raíz de tu proyecto:

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

Claude Desktop (Legacy)

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %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 defecto, MCP usa stdio (local). Para acceso remoto:

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

uvx mcp-manticore

Conéctate mediante URL:

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

Solución de problemas

Instalar uv (requerido)

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

Verificar la instalación:

uv --version

El servidor MCP no se conecta

Verifica que Manticore esté ejecutándose: curl http://localhost:9308/health
Comprueba que las variables de entorno estén configuradas correctamente
Para Claude Code: reinicia con /mcp restart

Demasiadas herramientas cargadas

Algunos agentes limitan las herramientas MCP activas. Elimina servidores no utilizados o usa configuraciones específicas del proyecto.

Desarrollo

# 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

Arquitectura

Archivo	Propósito
`mcp_manticore/mcp_env.py`	Gestión de configuración
`mcp_manticore/mcp_server.py`	Implementación del servidor MCP
`mcp_manticore/manticore_prompt.py`	Guía/prompts para LLM
`mcp_manticore/docs_fetcher.py`	Descargador de documentación de GitHub
`mcp_manticore/main.py`	Punto de entrada CLI

Licencia

Apache-2.0