Manticore Search MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add manticore-search -- uvx mcp-manticore
README.md

Connect AI assistants to Manticore Search databases

Manticore Search MCP Server

MCP server for Manticore Search — enables AI assistants to query and manage Manticore Search databases directly.

Quick Start

Installation

# 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

Note:

  • uvx runs the package directly without installation. First-time run may take a moment to download dependencies.
  • The package must be published to PyPI for uvx mcp-manticore to work.
  • For local development or testing unreleased versions, use uvx --from . mcp-manticore

What It Does

Tools

Tool Description
run_query Execute SQL queries (SELECT, SHOW, DESCRIBE, etc.)
list_tables List all tables and indexes
describe_table Get table schema
list_documentation List available documentation files
get_documentation Fetch specific documentation from Manticore manual

Prompts

  • manticore_initial_prompt — Built-in prompt teaching LLMs about Manticore Search features (full-text operators, KNN vector search, fuzzy search, etc.)

Health Check

HTTP endpoint at /health for monitoring connectivity.

Configuration

Environment Variables

Variable Default Description
MANTICORE_HOST localhost Manticore server host
MANTICORE_PORT 9308 HTTP API port
MANTICORE_USER — Username (optional)
MANTICORE_PASSWORD — Password (optional)
MANTICORE_CONNECT_TIMEOUT 30 Connection timeout (seconds)
MANTICORE_QUERY_TIMEOUT 30 Query timeout (seconds)
MANTICORE_ALLOW_WRITE_ACCESS false Enable write operations (INSERT, UPDATE, DELETE)
MANTICORE_ALLOW_DROP false Enable destructive operations (DROP, TRUNCATE)
GITHUB_TOKEN — GitHub token for higher API rate limit
Safety

By default, all write operations are blocked. To enable:

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

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

Connect to Your AI Assistant

Claude Code

Open terminal and run:

claude mcp add manticore -- uvx mcp-manticore

Or with environment variables:

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

For full configuration, edit ~/.claude/mcp_settings.json:

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

Restart Claude Code or type /mcp restart to apply changes.

Cursor

Method 1: Via Settings UI

  1. Open Cursor → Settings → Tools & MCP
  2. Click "Add MCP Server"
  3. Enter name: manticore
  4. Command: uvx mcp-manticore

Method 2: Via Config File

Global config (~/.cursor/mcp.json):

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

Project config (.cursor/mcp.json in your project):

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

Method 1: Via Cascade UI

  1. Open Windsurf → Cascade panel
  2. Click the MCPs icon (🔨) in the top-right
  3. Click "Add Server"
  4. Enter: uvx mcp-manticore

Method 2: Via Config File

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

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

Or open directly in Windsurf: Cmd/Ctrl + Shift + P → "MCP Configuration Panel"

VS Code (with VSCode Copilot)

VS Code uses the same MCP configuration as Cursor. Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "manticore": {
      "command": "uvx",
      "args": ["mcp-manticore"],
      "env": {
        "MANTICORE_HOST": "localhost",
        "MANTICORE_PORT": "9308"
      }
    }
  }
}
Claude Desktop (Legacy)

Edit `~/Library/

Tools (5)

run_queryExecute SQL queries (SELECT, SHOW, DESCRIBE, etc.)
list_tablesList all tables and indexes
describe_tableGet table schema
list_documentationList available documentation files
get_documentationFetch specific documentation from Manticore manual

Environment Variables

MANTICORE_HOSTManticore server host
MANTICORE_PORTHTTP API port
MANTICORE_USERUsername
MANTICORE_PASSWORDPassword
MANTICORE_ALLOW_WRITE_ACCESSEnable write operations (INSERT, UPDATE, DELETE)
MANTICORE_ALLOW_DROPEnable destructive operations (DROP, TRUNCATE)

Configuration

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

Try it

→List all tables currently available in my Manticore Search instance.
→Run a SQL query to select the top 10 most recent documents from the 'products' table.
→Describe the schema of the 'users' table so I can understand its structure.
→Fetch the documentation for Manticore's KNN vector search features.
→Search for documents in the 'articles' table where the title contains 'AI'.

Frequently Asked Questions

What are the key features of Manticore Search?

Execute SQL queries directly against Manticore Search. Retrieve table schemas and list available indexes. Access Manticore manual documentation via AI. Configurable write and destructive operation safety controls. Built-in prompt for LLM awareness of Manticore features.

What can I use Manticore Search for?

Building RAG applications by querying vector data stored in Manticore. Developing AI agents that can manage and inspect search indexes. Automating database schema exploration for developers. Providing AI assistants with direct access to technical documentation.

How do I install Manticore Search?

Install Manticore Search by running: uvx mcp-manticore

What MCP clients work with Manticore Search?

Manticore Search works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Manticore Search docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all database servers →

Related MCP Servers

GoSQLX
Production-ready SQL parsing SDK for Go with 7 SQL tools
database61 stars
Altinity MCP
Interact with ClickHouse databases through the Model Context Protocol
database23 stars
Apache Superset
Full-featured MCP server for Apache Superset with 128+ tools
database21 stars
Bonnard
Self-hosted semantic layer for AI agents.
database19 stars
BioBTree
A unified biomedical graph database that integrates 50+ primary data sources
database16 stars
Hypabase
A Python hypergraph library with provenance and SQLite persistence.
database11 stars