
A Model Context Protocol (MCP) server implementation for Meilisearch, enabling AI assistants to interact with Meilisearch through a standardized interface.
概览
A Model Context Protocol (MCP) server implementation for Meilisearch, enabling AI assistants to interact with Meilisearch through a standardized interface. - : Create, update, and delete indexes - : Add, update, and delete documents - : Perform searches with various parameters and filters - : Configure index settings - : Monitor and manage asynchronous tasks - : Health checks, version information, and statistics - : Experimental vector search capabilities To install Meilisearch MCP Server for Claude Desktop automatically via Smithery: 3. Create a .env file based on the example: 4. Edit the .env file to configure your Meilisearch connection. The Meilisearch MCP Server can be run in a Docker container for easier deployment and isolation. The easiest way to get started with Docker is to use Docker Compose: You can also build and run the Docker image manually: For developers who want to contribute to the Meilisearch MCP Server, we provide a convenient setup script:
README
以下为原文 README 节选,完整内容请查看原文。
Meilisearch MCP Server
A Model Context Protocol (MCP) server implementation for Meilisearch, enabling AI assistants to interact with Meilisearch through a standardized interface.
Features
- 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
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
-
Clone the repository:
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp -
Install dependencies:
npm install -
Create a
.envfile based on the example:cp .env.example .env -
Edit the
.envfile 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:
# Start the Meilisearch MCP Server
docker-compose up -d
# View logs
docker-compose logs -f
# Stop the server
docker-compose down
Building and Running the Docker Image Manually
You can also build and run the Docker image manually:
# Build the Docker image
docker build -t meilisearch-ts-mcp .
# Run the container
docker run -p 3000:3000 --env-file .env meilisearch-ts-mcp
Development Setup
For developers who want to contribute to the Meilisearch MCP Server, we provide a convenient setup script:
# Clone the repository
git clone https://github.com/devlimelabs-ts-mcp/meilisearch-ts-mcp.git
cd meilisearch-ts-mcp
# Run the development setup script
./scripts/setup-dev.sh
The setup script will:
- Create a
.envfile from.env.exampleif it doesn’t exist - Install dependencies
- Build the project
- Run tests to ensure everything is working correctly
After running the setup script, you can start the server in development mode:
npm run dev
Usage
Building the Project
npm run build
Running the Server
npm start
Development Mode
npm run dev
Claude Desktop Integration
安装
npx -y @smithery/cli install @devlimelabs/meilisearch-ts-mcp --client claude配置
{
"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"
}
}
}
}