manticore-mcp-server

krajcik/manticore-mcp-server

3.3

If you are the rightful owner of manticore-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Manticore Search MCP Server provides a bridge between Manticore Search and MCP-compatible clients, enabling advanced search functionalities and management operations.

Tools
5
Resources
0
Prompts
0

Manticore Search MCP Server

A Model Context Protocol (MCP) server that provides access to Manticore Search functionality through MCP-compatible clients like Claude Code, Cursor, and other AI development tools.

Features

  • Full-text search with advanced query options
  • Table/index management operations
  • Document insertion and manipulation
  • Cluster status monitoring
  • Boolean queries with highlighting and fuzzy search
  • Configurable result limits and pagination

Installation

Prerequisites

  • Go 1.22 or later
  • Manticore Search server running and accessible

Build

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

Configuration

Configure using environment variables:

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

Or command-line flags:

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

MCP Client Integration

Add to your MCP client configuration (e.g., ~/.claude.json for Claude Code):

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

Available Tools

The MCP protocol automatically exposes these tools to clients:

search

Full-text search in Manticore indexes.

Key Parameters:

  • table (required): Table name
  • query: Search text
  • limit: Max results
  • highlight: Enable result highlighting
  • bool_query: Complex boolean queries

show_tables

List available tables/indexes.

describe_table

Get table schema information.

Parameters:

  • table (required): Table name

insert_document

Insert document into index.

Parameters:

  • table (required): Table name
  • document (required): Document data

update_document

Update an existing document by id (attributes) with optional additional condition.

Parameters:

  • table (required)
  • id (required)
  • document (required): fields to update
  • condition (optional)

delete_document

Delete documents by id or condition.

Parameters:

  • table (required)
  • id or condition (one required)

show_cluster_status

Display cluster health status.

create_cluster / join_cluster / alter_cluster / delete_cluster / set_cluster

Cluster management operations (use with caution in production).

Response Format

All tools return structured JSON:

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

API Discovery

MCP clients automatically discover available tools and their schemas through the protocol. No manual configuration required.

Troubleshooting

Connection Issues:

  • Verify Manticore is running: curl http://localhost:9308
  • Check server path in MCP configuration
  • Use --debug for verbose logging
  • For complex boolean queries, ensure HTTP JSON API is reachable (POST to /search).

Performance:

  • Adjust MAX_RESULTS_PER_QUERY for your needs
  • Increase REQUEST_TIMEOUT for complex queries

License

MIT License