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 分