Skip to content

A Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces.

License

Notifications You must be signed in to change notification settings

meilisearch/meilisearch-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Meilisearch MCP Server

A Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces like Claude.

Features

  • Index and document management
  • Settings configuration with templates for common use cases (e-commerce, content search, SaaS)
  • Task monitoring and API key management
  • Built-in logging and monitoring tools

Installation

# Clone repository
git clone <repository_url>
cd meilisearch-mcp

# Create virtual environment and install
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

Requirements

  • Python ≥ 3.9
  • Running Meilisearch instance
  • Node.js (for testing with MCP Inspector)

Usage

Environment Variables

MEILI_HTTP_ADDR=http://localhost:7700  # Meilisearch URL
MEILI_MASTER_KEY=your_master_key       # Optional: Meilisearch API key

Running the Server

python -m src.meilisearch_mcp

Testing with MCP Inspector

npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

Available Tools

  • Index Management: create/update/delete indexes
  • Document Operations: add/update/delete documents
  • Settings Management: configure search settings with templates
  • API Key Management: create/update/delete API keys
  • Task Monitoring: track and manage asynchronous tasks
  • System Monitoring: health checks and metrics

Contributing

  1. Fork repository
  2. Create feature branch
  3. Commit changes
  4. Create pull request

License

MIT

About

A Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces.

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages