DM

devlimelabs/meilisearch-ts-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

11 stars 5 forks 质量 67 趋势 18MIT

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

  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:

# 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:

  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:

npm run dev

Usage

Building the Project

npm run build

Running the Server

npm start

Development Mode

npm run dev

Claude Desktop Integration

在 GitHub 查看完整 README

安装

npx -y @smithery/cli install @devlimelabs/meilisearch-ts-mcp --client claude
新手?先看 mcpskill.org 教程 →

配置

{ "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" } } } }