Manticore Search

MCP server for Manticore Search — lets AI assistants query and manage search databases.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "manticore-search": {
      "command": "npx",
      "args": [
        "-y",
        "manticore-search"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Manticore Search MCP Server

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

Quick Start

Installation

bash

# 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:

server.ts

# 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:

Terminal

claude mcp add manticore -- uvx mcp-manticore

Or with environment variables:

Terminal

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

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

config.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

Open Cursor → Settings → Tools & MCP
Click "Add MCP Server"
Enter name: manticore
Command: uvx mcp-manticore

Method 2: Via Config File

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

config.json

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

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

config.json

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

Windsurf

Method 1: Via Cascade UI

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

Method 2: Via Config File

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

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"

OpenAI Codex

Run in terminal:

bash

codex mcp add manticore -- uvx mcp-manticore

With environment variables:

bash

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

Or edit ~/.codex/config.toml directly:

toml

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

Gemini CLI

Edit ~/.gemini/settings.json:

config.json

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

VS Code (GitHub Copilot)

Create .vscode/mcp.json in your workspace:

config.json

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

Cline

Open Cline panel in VS Code
Click the MCP Servers icon
Click "Configure" → "Add Server"
Select "Command (stdio)" and enter:
- Name: manticore
- Command: uvx mcp-manticore

Or edit the MCP settings file directly (accessible via the MCP Servers icon → "Edit Config"):

config.json

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

Roo Code

Open Roo Code panel in VS Code
Click the MCP Servers icon → "Edit MCP Settings"
Add the server configuration

Or create .roo/mcp.json in your project root:

config.json

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

Claude Desktop (Legacy)

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

config.json

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

HTTP Transport (Remote MCP)

By default, MCP uses stdio (local). For remote access:

server.ts

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

uvx mcp-manticore

Connect via URL:

config.json

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

Troubleshooting

Install uv (required)

macOS / Linux:

bash

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

# Or via Homebrew
brew install uv

Windows:

powershell

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

# Or via winget
winget install astral-sh.uv

Verify installation:

bash

uv --version

MCP server not connecting

Verify Manticore is running: curl http://localhost:9308/health
Check environment variables are set correctly
For Claude Code: restart with /mcp restart

Too many tools loaded

Some agents limit active MCP tools. Remove unused servers or use project-scoped configs.

Development

bash

# 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

Architecture

File	Purpose
`mcp_manticore/mcp_env.py`	Configuration management
`mcp_manticore/mcp_server.py`	MCP server implementation
`mcp_manticore/manticore_prompt.py`	LLM guidance/prompts
`mcp_manticore/docs_fetcher.py`	GitHub docs fetcher
`mcp_manticore/main.py`	CLI entry point

License

Apache-2.0

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Manticore Search

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "manticore-search": { "command": "npx", "args": ["-y", "Manticore Search"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Manticore Search AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/manticore-search?style=directory)](https://allmcps.com/mcp/manticore-search)

HTML Embed

<a href="https://allmcps.com/mcp/manticore-search"><img src="https://allmcps.com/api/badge/manticore-search?style=directory" alt="Manticore Search on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Manticore Search →Install in Claude Desktop Install in Cursor Install in VS Code

Manticore Search

MCP server for Manticore Search — lets AI assistants query and manage search databases.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "manticore-search": {
      "command": "npx",
      "args": [
        "-y",
        "manticore-search"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Manticore Search MCP Server

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

Quick Start

Installation

bash

# 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:

server.ts

# 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:

Terminal

claude mcp add manticore -- uvx mcp-manticore

Or with environment variables:

Terminal

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

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

config.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

Open Cursor → Settings → Tools & MCP
Click "Add MCP Server"
Enter name: manticore
Command: uvx mcp-manticore

Method 2: Via Config File

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

config.json

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

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

config.json

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

Windsurf

Method 1: Via Cascade UI

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

Method 2: Via Config File

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

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"

OpenAI Codex

Run in terminal:

bash

codex mcp add manticore -- uvx mcp-manticore

With environment variables:

bash

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

Or edit ~/.codex/config.toml directly:

toml

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

Gemini CLI

Edit ~/.gemini/settings.json:

config.json

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

VS Code (GitHub Copilot)

Create .vscode/mcp.json in your workspace:

config.json

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

Cline

Open Cline panel in VS Code
Click the MCP Servers icon
Click "Configure" → "Add Server"
Select "Command (stdio)" and enter:
- Name: manticore
- Command: uvx mcp-manticore

Or edit the MCP settings file directly (accessible via the MCP Servers icon → "Edit Config"):

config.json

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

Roo Code

Open Roo Code panel in VS Code
Click the MCP Servers icon → "Edit MCP Settings"
Add the server configuration

Or create .roo/mcp.json in your project root:

config.json

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

Claude Desktop (Legacy)

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

config.json

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

HTTP Transport (Remote MCP)

By default, MCP uses stdio (local). For remote access:

server.ts

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

uvx mcp-manticore

Connect via URL:

config.json

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

Troubleshooting

Install uv (required)

macOS / Linux:

bash

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

# Or via Homebrew
brew install uv

Windows:

powershell

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

# Or via winget
winget install astral-sh.uv

Verify installation:

bash

uv --version

MCP server not connecting

Verify Manticore is running: curl http://localhost:9308/health
Check environment variables are set correctly
For Claude Code: restart with /mcp restart

Too many tools loaded

Some agents limit active MCP tools. Remove unused servers or use project-scoped configs.

Development

bash

# 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

Architecture

File	Purpose
`mcp_manticore/mcp_env.py`	Configuration management
`mcp_manticore/mcp_server.py`	MCP server implementation
`mcp_manticore/manticore_prompt.py`	LLM guidance/prompts
`mcp_manticore/docs_fetcher.py`	GitHub docs fetcher
`mcp_manticore/main.py`	CLI entry point

License

Apache-2.0

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Manticore Search

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "manticore-search": { "command": "npx", "args": ["-y", "Manticore Search"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/manticore-search?style=directory)](https://allmcps.com/mcp/manticore-search)

HTML Embed

<a href="https://allmcps.com/mcp/manticore-search"><img src="https://allmcps.com/api/badge/manticore-search?style=directory" alt="Manticore Search on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Manticore Search →Install in Claude Desktop Install in Cursor Install in VS Code