Meilisearch

by devlimelabs

6 stars

Not rated

GitHub

About

Integrates with Meilisearch to enable advanced search operations, index and document management, and customizable search functionality with features like faceted search and custom ranking.

Details

Author: devlimelabs
Repository: devlimelabs/meilisearch-ts-mcp
GitHub stars: 6
License: MIT License
Categories: Productivity, Developer Tools, Design, Workplace, File Management, AI, Search, API, Infrastructure, Frontend
Tags: #integration

- Index Management: Create, update, and delete indexes
- Document Management: Add, update, and delete documents
- Search Capabilities: Perform searches with various parameters and filters
- Settings Management: Configure index settings
- Task Management: Monitor and manage asynchronous tasks
- System Operations: Health checks, version information, and statistics
- Vector Search: Experimental vector search capabilities

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Meilisearch

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/meilisearch-ts-mcp/dist/index.js
Environment
- MEILISEARCH_HOST http://localhost:7700
- MEILISEARCH_API_KEY your-api-key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

JSON

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

From the repository

Installing Via Smithery

To install Meilisearch MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @devlimelabs/meilisearch-ts-mcp --client claude

Manual Installation

1. Clone the repository:

   git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git

   cd meilisearch-ts-mcp

2. Install dependencies:

   npm install

3. Create a .env file based on the example:

   cp .env.example .env

4. Edit the .env file to configure your Meilisearch connection.

Clone The Repository

git clone https://github.com/devlimelabs-ts-mcp/meilisearch-ts-mcp.git
cd meilisearch-ts-mcp

Running The Server

npm start

Docker Setup

The Meilisearch MCP Server can be run in a Docker container for easier deployment and isolation.

Building And Running The Docker Image Manually

You can also build and run the Docker image manually:

Development Setup For developers who want to contribute to the Meilisearch MCP Server, we provide a convenient setup script:

bash

Run The Development Setup Script

./scripts/setup-dev.sh

The setup script will: 1. Create a .env file from .env.example if it doesn't exist 2. Install dependencies 3. Build the project 4. Run tests to ensure everything is working correctly After running the setup script, you can start the server in development mode:

bash
npm run dev

Automated Setup We provide a setup script that automatically configures Claude for Desktop to work with the Meilisearch MCP Server:

bash

Then Run The Setup Script

node scripts/claude-desktop-setup.js

The script will: 1. Detect your operating system and locate the Claude for Desktop configuration file 2. Read your Meilisearch configuration from the .env file 3. Generate the necessary configuration for Claude for Desktop 4. Provide instructions for updating your Claude for Desktop configuration Manual Setup If you prefer to manually configure Claude for Desktop: 1. Locate your Claude for Desktop configuration file: - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json 2. Add the following configuration (adjust paths as needed):

json
{
"mcpServers": {
"meilisearch": {
"command": "node",
"args": ["/path/to/meilisearch-ts-mcp/dist/index.js"],
"env": {
"MEILISEARCH_HOST": "http://localhost:7700",
"MEILISEARCH_API_KEY": "your-api-key"
}
}
}
}
```

3. Restart Claude for Desktop to apply the changes.

4. In Claude, type: "I want to use the Meilisearch MCP server" to activate the integration.

`create-index`

Create a new index

`get-index`

Get information about an index

`list-indexes`

List all indexes

`update-index`

Update an index

`delete-index`

Delete an index

`add-documents`

Add documents to an index

`get-document`

Get a document by ID

`get-documents`

Get multiple documents

`update-documents`

Update documents

`delete-document`

Delete a document by ID

`delete-documents`

Delete multiple documents

`delete-all-documents`

Delete all documents in an index

`search`

Search for documents

`multi-search`

Perform multiple searches in a single request

`get-settings`

Get index settings

`update-settings`

Update index settings

`reset-settings`

Reset index settings to default

`list-tasks`

List tasks with optional filtering

`get-task`

Get information about a specific task

`cancel-tasks`

Cancel tasks based on provided filters

`wait-for-task`

Wait for a specific task to complete

`health`

Check the health status of the Meilisearch server

`version`

Get version information

`info`

Get system information

`stats`

Get statistics about indexes

`enable-vector-search`

Enable vector search

`get-experimental-features`

Get experimental features status

`update-embedders`

Configure embedders

`get-embedders`

Get embedders configuration

`reset-embedders`

Reset embedders configuration

`vector-search`

Perform vector search

The Meilisearch MCP Server provides the following tools:

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "meilisearch": {
            "env": {
                "MEILISEARCH_HOST": "http://localhost:7700",
                "MEILISEARCH_API_KEY": "your-api-key"
            },
            "args": [
                "/path/to/meilisearch-ts-mcp/dist/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

{
    "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "your-api-key"
    },
    "args": [
        "/path/to/meilisearch-ts-mcp/dist/index.js"
    ],
    "command": "node"
}

Macos

{
    "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "your-api-key"
    },
    "args": [
        "/path/to/meilisearch-ts-mcp/dist/index.js"
    ],
    "command": "node"
}

Windows

{
    "env": {
        "MEILISEARCH_HOST": "http://localhost:7700",
        "MEILISEARCH_API_KEY": "your-api-key"
    },
    "args": [
        "/path/to/meilisearch-ts-mcp/dist/index.js"
    ],
    "command": "node"
}

Meilisearch MCP Server

A Model Context Protocol (MCP) server implementation for Meilisearch, enabling AI assistants to interact with Meilisearch through a standardized interface.

Features

Installation

Installing via Smithery

To install Meilisearch MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @devlimelabs/meilisearch-ts-mcp --client claude

Manual Installation

1. Clone the repository:

   git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git
   cd meilisearch-ts-mcp

2. Install dependencies:

   npm install

3. Create a .env file based on the example:

   cp .env.example .env

4. Edit the .env file to configure your Meilisearch connection.

Docker Setup

The Meilisearch MCP Server can be run in a Docker container for easier deployment and isolation.

Using Docker Compose

The easiest way to get started with Docker is to use Docker Compose:

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Installing Via Smithery

Manual Installation

Clone The Repository

Running The Server

Docker Setup

Building And Running The Docker Image Manually

Development Setup

Run The Development Setup Script

Automated Setup

Then Run The Setup Script

Manual Setup

create-index

get-index

list-indexes

update-index

delete-index

add-documents

get-document

get-documents

update-documents

delete-document

delete-documents

delete-all-documents

search

multi-search

get-settings

update-settings

reset-settings

list-tasks

get-task

cancel-tasks

wait-for-task

health

version

info

stats

enable-vector-search

get-experimental-features

update-embedders

get-embedders

reset-embedders

vector-search

Claude Desktop / Cursor

Linux

Macos

Windows

Meilisearch MCP Server

Features

Installation

Installing via Smithery

Manual Installation

Docker Setup

Using Docker Compose

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`create-index`

`get-index`

`list-indexes`

`update-index`

`delete-index`

`add-documents`

`get-document`

`get-documents`

`update-documents`

`delete-document`

`delete-documents`

`delete-all-documents`

`search`

`multi-search`

`get-settings`

`update-settings`

`reset-settings`

`list-tasks`

`get-task`

`cancel-tasks`

`wait-for-task`

`health`

`version`

`info`

`stats`

`enable-vector-search`

`get-experimental-features`

`update-embedders`

`get-embedders`

`reset-embedders`

`vector-search`