Manticore MCP Server

🚀 Manticore Search MCP 服務器

Manticore Search MCP 服務器是一個基於模型上下文協議（MCP）的服務器，它允許像 Claude Code、Cursor 等支持 MCP 協議的客戶端以及其他 AI 開發工具，訪問 Manticore Search 的各項功能。

🚀 快速開始

Manticore Search MCP 服務器為 MCP 兼容的客戶端提供了訪問 Manticore Search 功能的途徑。在使用前，請確保你已經完成了安裝和配置。

✨ 主要特性

• 支持高級查詢選項的全文搜索。
• 提供表/索引管理操作。
• 支持文檔的插入和操作。
• 可對集群狀態進行監控。
• 支持帶高亮顯示和模糊搜索的布爾查詢。
• 結果數量限制和分頁功能可配置。

📦 安裝指南

前提條件

• Go 版本需 1.24 或更高。
• Manticore Search 服務器需運行且可訪問。

構建

git clone https://github.com/krajcik/manticore-mcp-server.git
cd manticore-mcp-server
go build -o manticore-mcp-server

📚 詳細文檔

配置

可以使用環境變量進行配置：

export MANTICORE_URL="http://localhost:9308"
export MAX_RESULTS_PER_QUERY="100"
export REQUEST_TIMEOUT="30s"
export DEBUG="false"

也可以使用命令行參數進行配置：

./manticore-mcp-server --manticore-url="http://localhost:9308" --max-results=100

MCP 客戶端集成

將以下內容添加到你的 MCP 客戶端配置文件中（例如，Claude Code 的配置文件為 ~/.claude.json）：

{
  "mcpServers": {
    "manticore-search": {
      "command": "/path/to/manticore-mcp-server",
      "args": [],
      "env": {
        "MANTICORE_URL": "http://localhost:9308",
        "MAX_RESULTS_PER_QUERY": "50"
      }
    }
  }
}

可用工具

MCP 協議會自動向客戶端暴露以下工具：

search

用於在 Manticore 索引中進行全文搜索。 關鍵參數：

• table（必需）：表名。
• query：搜索文本。
• limit：最大結果數。
• highlight：啟用結果高亮顯示。
• bool_query：複雜的布爾查詢。

show_tables

列出可用的表/索引。

describe_table

獲取表的架構信息。 參數：

• table（必需）：表名。

insert_document

向索引中插入文檔。 參數：

• table（必需）：表名。
• document（必需）：文檔數據。

show_cluster_status

顯示集群的健康狀態。

響應格式

所有工具的響應都採用結構化的 JSON 格式：

{
  "success": true,
  "data": { /* 結果 */ },
  "meta": {
    "total": 42,
    "count": 10,
    "operation": "search"
  }
}

API 發現

MCP 客戶端可以通過協議自動發現可用的工具及其架構，無需手動配置。

故障排除

連接問題

• 驗證 Manticore 是否正在運行：curl http://localhost:9308。
• 檢查 MCP 配置中的服務器路徑。
• 使用 --debug 選項開啟詳細日誌。

性能問題

• 根據需求調整 MAX_RESULTS_PER_QUERY。
• 對於複雜查詢，增加 REQUEST_TIMEOUT。

📄 許可證

本項目採用 MIT 許可證。