home / mcp / manticore mcp server

Manticore MCP Server

Provides MCP access to Manticore Search for queries, table management, documents, and cluster status.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "krajcik-manticore-mcp-server": {
      "url": "http://localhost:9308",
      "headers": {
        "DEBUG": "false",
        "MANTICORE_URL": "http://localhost:9308",
        "REQUEST_TIMEOUT": "30s",
        "MAX_RESULTS_PER_QUERY": "100"
      }
    }
  }
}

You can access Manticore Search functionality from MCP-compatible clients through a dedicated MCP server. This server bridges MCP requests to Manticore, enabling you to perform full-text searches, manage tables and documents, monitor cluster health, and run complex queries with pagination and highlighting.

How to use

You interact with the MCP server using an MCP client. Start by configuring a local or remote MCP server endpoint that the client can reach, then use the provided tools to search, show tables, insert or update documents, and manage clusters.

Common usage patterns include performing a full-text search against a specific table, listing available tables, and inserting new documents into an index. You can also describe a table to learn its schema, and update or delete documents by id or with a conditional query. When working with clusters, you can monitor health and perform cluster-related operations as needed.

How to install

Prerequisites you need before building and running the MCP server:

Go 1.22 or later
A running Manticore Search server accessible at the configured URL

Build and run the MCP server locally by following these steps:

# Clone the project
git clone https://github.com/krajcik/manticore-mcp-server.git

# Change into the project directory
cd manticore-mcp-server

# Build the MCP server binary
go build -o manticore-mcp-server

# Start the MCP server with your Manticore URL and a max results limit
./manticore-mcp-server --manticore-url="http://localhost:9308" --max-results=100

Configuration and usage notes

Configure connection details and query limits via environment variables or command-line flags. Examples shown here reflect the available configuration options you can use to tailor behavior to your environment.

# Environment variables (example)
export MANTICORE_URL="http://localhost:9308"
export MAX_RESULTS_PER_QUERY="100"
export REQUEST_TIMEOUT="30s"
export DEBUG="false"

# Or start the server with CLI flags
./manticore-mcp-server --manticore-url="http://localhost:9308" --max-results=100

Available tools

search

Perform a full-text search on a specified table with optional limit, highlighting, and boolean query options.

show_tables

List all available tables or indexes.

describe_table

Retrieve the schema for a specific table.

insert_document

Insert a new document into a specific table.

update_document

Update fields of an existing document by id with an optional condition.

delete_document

Delete documents by id or by a conditional expression.

show_cluster_status

Display the current health and status of the cluster.

create_cluster

Create a new cluster configuration.

join_cluster

Join the MCP server to an existing cluster.

alter_cluster

Modify an existing cluster configuration.

delete_cluster

Remove a cluster configuration.

set_cluster

Apply or change the active cluster context.