Manticore Search

io.github.manticoresoftware由 GitHub 账号 manticoresoftware 发布v0.1.2更新于 Oct 24, 2026

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

已验证STDIO仅桌面数据库知识与记忆

概览

AI 生成的概览

一个本地 MCP 服务器，让 AI 助手对 Manticore Search 数据库执行 SQL 查询、查看表结构并阅读 Manticore 文档。

可以做什么
对 Manticore Search 执行 SQL 查询（SELECT、SHOW、DESCRIBE 等）。列出表和索引，并查看表结构。列出并获取 Manticore 手册中的文档页面。使用内置提示让助手了解 Manticore 特性，如全文操作符、KNN 向量搜索和模糊搜索。
适用场景
当你使用 Manticore Search 实例，希望助手在不离开对话的情况下浏览数据、检查表结构或编写并执行搜索查询时适用。
运行要求
需要本地 Python 运行环境，通过 uvx 或 pip 安装并运行该包。需要一个可访问的 Manticore Search 服务器，通过 MANTICORE_HOST 和 MANTICORE_PORT 配置（默认 localhost:9308），可选 MANTICORE_USER 和 MANTICORE_PASSWORD。获取文档需要网络访问；GITHUB_TOKEN 可选，用于提高速率限制。
安装前请注意
写操作默认被阻止，只有设置 MANTICORE_ALLOW_WRITE_ACCESS 才启用；DROP、TRUNCATE 等破坏性操作需要 MANTICORE_ALLOW_DROP。启用后助手可以修改或删除数据。数据库凭据通过环境变量传入。可选的 HTTP 传输使用 MANTICORE_MCP_AUTH_TOKEN，应妥善保密。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Manticore Search，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Manticore Search MCP Server

[PyPI - Version] [uv]

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 pippip 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

ToolDescription
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

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

VariableDefaultDescription
MANTICORE_HOSTlocalhostManticore server host
MANTICORE_PORT9308HTTP API port
MANTICORE_USER—Username (optional)
MANTICORE_PASSWORD—Password (optional)
MANTICORE_CONNECT_TIMEOUT30Connection timeout (seconds)
MANTICORE_QUERY_TIMEOUT30Query timeout (seconds)
MANTICORE_ALLOW_WRITE_ACCESSfalseEnable write operations (INSERT, UPDATE, DELETE)
MANTICORE_ALLOW_DROPfalseEnable destructive operations (DROP, TRUNCATE)
GITHUB_TOKEN—GitHub token for higher API rate limit
Safety

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

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

bash
claude mcp add manticore -- uvx mcp-manticore

Or with environment variables:

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

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

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

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

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

json
{  "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:

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:

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:

json
{  "servers": {    "manticore": {      "type": "stdio",      "command": "uvx",      "args": ["mcp-manticore"],      "env": {        "MANTICORE_HOST": "localhost",        "MANTICORE_PORT": "9308"      }    }  }}
Cline
  1. Open Cline panel in VS Code
  2. Click the MCP Servers icon
  3. Click "Configure" → "Add Server"
  4. 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"):

json
{  "mcpServers": {    "manticore": {      "command": "uvx",      "args": ["mcp-manticore"],      "env": {        "MANTICORE_HOST": "localhost",        "MANTICORE_PORT": "9308"      }    }  }}
Roo Code
  1. Open Roo Code panel in VS Code
  2. Click the MCP Servers icon → "Edit MCP Settings"
  3. Add the server configuration

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

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

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:

bash
export MANTICORE_MCP_SERVER_TRANSPORT=httpexport MANTICORE_MCP_BIND_PORT=8000export MANTICORE_MCP_AUTH_TOKEN="your-secure-token"
uvx mcp-manticore

Connect via URL:

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 Homebrewbrew install uv

Windows:

powershell
# Via PowerShellirm https://astral.sh/uv/install.ps1 | iex
# Or via wingetwinget install astral-sh.uv

Verify installation:

bash
uv --version

MCP server not connecting

  1. Verify Manticore is running: curl http://localhost:9308/health
  2. Check environment variables are set correctly
  3. 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 setupgit clone https://github.com/manticoresoftware/mcp-manticore.gitcd mcp-manticore
# Install dependenciesuv sync
# Run locallyuv run mcp-manticore
# Run with custom configMANTICORE_HOST=remote-server MANTICORE_PORT=9308 uv run mcp-manticore
# Run testsuv run pytest
# Build packageuv build
# Publish to PyPIuv publish

Architecture

FilePurpose
mcp_manticore/mcp_env.pyConfiguration management
mcp_manticore/mcp_server.pyMCP server implementation
mcp_manticore/manticore_prompt.pyLLM guidance/prompts
mcp_manticore/docs_fetcher.pyGitHub docs fetcher
mcp_manticore/main.pyCLI entry point

License

Apache-2.0

来源：README.md，提交 c835b5c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分