🚀 Manticore Search MCP 服务器
Manticore Search MCP 服务器是一个模型上下文协议（MCP）服务器，它通过兼容 MCP 的客户端（如 Claude Code、Cursor 等 AI 开发工具）提供对 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 许可证。