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 许可证。