Servidor MCP de Meilisearch

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para Meilisearch, que permite a los asistentes de IA interactuar con Meilisearch a través de una interfaz estandarizada.

Características

Gestión de índices : crear, actualizar y eliminar índices
Gestión de documentos : agregar, actualizar y eliminar documentos
Capacidades de búsqueda : Realice búsquedas con varios parámetros y filtros
Administración de configuraciones : configurar ajustes de índice
Gestión de tareas : supervisar y gestionar tareas asincrónicas
Operaciones del sistema : comprobaciones de estado, información de versiones y estadísticas
Búsqueda de vectores : capacidades experimentales de búsqueda de vectores

Instalación

Instalación mediante herrería

Para instalar Meilisearch MCP Server para Claude Desktop automáticamente a través de Smithery :

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

Instalación manual

Clonar el repositorio:
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp
Instalar dependencias:
npm install
Cree un archivo .env basado en el ejemplo:
cp .env.example .env
Edite el archivo .env para configurar su conexión Meilisearch.

Configuración de Docker

El servidor MCP de Meilisearch se puede ejecutar en un contenedor Docker para facilitar la implementación y el aislamiento.

Uso de Docker Compose

La forma más sencilla de comenzar a utilizar Docker es utilizar Docker Compose:

# Start the Meilisearch MCP Server
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the server
docker-compose down

Construir y ejecutar la imagen de Docker manualmente

También puedes crear y ejecutar la imagen de Docker manualmente:

# Build the Docker image
docker build -t meilisearch-ts-mcp .

# Run the container
docker run -p 3000:3000 --env-file .env meilisearch-ts-mcp

Configuración de desarrollo

Para los desarrolladores que quieran contribuir al servidor MCP de Meilisearch, ofrecemos un script de configuración muy práctico:

# 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

El script de configuración hará lo siguiente:

Crea un archivo .env a partir de .env.example si no existe
Instalar dependencias
Construir el proyecto
Ejecute pruebas para asegurarse de que todo funciona correctamente

Después de ejecutar el script de instalación, puede iniciar el servidor en modo de desarrollo:

npm run dev

Uso

Construyendo el Proyecto

npm run build

Ejecución del servidor

npm start

Modo de desarrollo

npm run dev

Integración de escritorio de Claude

El servidor MCP de Meilisearch se puede integrar con Claude for Desktop, lo que le permite interactuar con su instancia de Meilisearch directamente a través de Claude.

Configuración automatizada

Proporcionamos un script de configuración que configura automáticamente Claude for Desktop para que funcione con el servidor Meilisearch MCP:

# First build the project
npm run build

# Then run the setup script
node scripts/claude-desktop-setup.js

El guión hará lo siguiente:

Detecta tu sistema operativo y localiza el archivo de configuración de Claude for Desktop
Lea la configuración de Meilisearch desde el archivo .env
Generar la configuración necesaria para Claude for Desktop
Proporciona instrucciones para actualizar la configuración de Claude for Desktop

Configuración manual

Si prefiere configurar manualmente Claude para escritorio:

Localice el archivo de configuración de Claude for Desktop:
- macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas : %APPDATA%\Claude\claude_desktop_config.json
- Linux : ~/.config/Claude/claude_desktop_config.json
Agregue la siguiente configuración (ajuste las rutas según sea necesario):

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

Reinicie Claude for Desktop para aplicar los cambios.
En Claude, escriba: "Quiero usar el servidor Meilisearch MCP" para activar la integración.

Integración del cursor

El servidor MCP de Meilisearch también se puede integrar con Cursor , un editor de código impulsado por IA.

Configuración de MCP en Cursor

Instalar y configurar el servidor MCP de Meilisearch:
git clone https://github.com/devlimelabs/meilisearch-ts-mcp.git cd meilisearch-ts-mcp npm install npm run build
Inicie el servidor MCP:
npm start
En Cursor, abra la Paleta de comandos (Cmd/Ctrl+Shift+P) y busque "MCP: Conectar al servidor MCP".
Seleccione "Conectarse a un servidor MCP local" e ingrese los siguientes detalles:
- Nombre : Meilisearch
- Comando : nodo
- Argumentos : /ruta/absoluta/a/meilisearch-ts-mcp/dist/index.js
- Variables de entorno :
  MEILISEARCH_HOST=http://localhost:7700 MEILISEARCH_API_KEY=your-api-key
Haga clic en “Conectar” para establecer la conexión.
Ahora puede interactuar con su instancia de Meilisearch a través del Cursor escribiendo comandos como "Buscar en mi índice de Meilisearch documentos sobre..."

Herramientas disponibles

El servidor MCP de Meilisearch proporciona las siguientes herramientas:

Herramientas de índice

create-index : Crea un nuevo índice
get-index : Obtener información sobre un índice
list-indexes : Lista todos los índices
update-index : Actualizar un índice
delete-index : Eliminar un índice

Herramientas de documentos

add-documents : Agregar documentos a un índice
get-document : Obtener un documento por ID
get-documents : Obtener múltiples documentos
update-documents : Actualizar documentos
delete-document : Eliminar un documento por ID
delete-documents : Eliminar varios documentos
delete-all-documents : Eliminar todos los documentos en un índice

Herramientas de búsqueda

search : Buscar documentos
multi-search : realice múltiples búsquedas en una sola solicitud

Herramientas de configuración

get-settings : Obtener la configuración del índice
update-settings : Actualizar la configuración del índice
reset-settings : Restablecer la configuración del índice a los valores predeterminados
Varias herramientas de configuración específicas (sinónimos, palabras vacías, reglas de clasificación, etc.)

Herramientas de tareas

list-tasks : Lista de tareas con filtrado opcional
get-task : Obtener información sobre una tarea específica
cancel-tasks : Cancelar tareas según los filtros proporcionados
wait-for-task : Esperar a que se complete una tarea específica

Herramientas del sistema

health : Verifique el estado de salud del servidor Meilisearch
version : Obtener información de la versión
info : Obtener información del sistema
stats : obtener estadísticas sobre los índices

Herramientas vectoriales (experimentales)

enable-vector-search : Habilitar la búsqueda vectorial
get-experimental-features : Obtener el estado de las funciones experimentales
update-embedders : Configurar embebedores
get-embedders : Obtener la configuración de los embebedores
reset-embedders : Restablecer la configuración de los embebedores
vector-search : Realizar búsqueda vectorial

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Meilisearch MCP Server

Integrations