Servidor MCP de Typesense

Una implementación de servidor del Protocolo de Contexto de Modelo (MCP) que proporciona a los modelos de IA acceso a las funciones de búsqueda de Typesense . Este servidor permite a los LLM descubrir, buscar y analizar datos almacenados en colecciones de Typesense.

Manifestación

Related MCP server: All-Search MCP Server

Características

Recursos

• Enumere y acceda a colecciones mediante typesense://

• Cada colección tiene un nombre, una descripción y un número de documentos.

• Tipo MIME JSON para acceso al esquema

Herramientas

• consulta de sentido de tipos

  • Busque documentos en colecciones de Typesense con un filtrado potente

  • Entrada: Texto de consulta, nombre de la colección, campos de búsqueda, filtros, opciones de clasificación, límite

  • Devuelve documentos coincidentes con puntuaciones de relevancia

• typeSense_obtener_documento

  • Recuperar documentos específicos por ID de las colecciones

  • Entrada: Nombre de la colección, ID del documento

  • Devuelve datos completos del documento

• estadísticas de colección de typesense

  • Obtener estadísticas sobre una colección de Typesense

  • Entrada: Nombre de la colección

  • Devuelve metadatos de colección, recuento de documentos e información del esquema.

Indicaciones

• analizar_colección

  • Analizar la estructura y el contenido de la colección

  • Entrada: Nombre de la colección

  • Salida: información sobre esquemas, tipos de datos y estadísticas

• sugerencias de búsqueda

  • Obtenga sugerencias para consultas de búsqueda efectivas para una colección

  • Entrada: Nombre de la colección

  • Resultado: Estrategias de búsqueda recomendadas según el esquema de colección

Instalación

A través de npm

# Global installation
npm install -g typesense-mcp-server

# Local installation
npm install typesense-mcp-server

A través de mcp-get

npx @michaellatman/mcp-get@latest install typesense-mcp-server

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación para el desarrollo

Uso de Claude Desktop

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "typesense": {
      "command": "node",
      "args": [
        "~/typesense-mcp-server/dist/index.js",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    },
  }
}

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Componentes

Recursos

El servidor proporciona información sobre las colecciones de Typesense:

• Esquemas de colección ( typesense://collections/<collection> )

  • Información del esquema JSON para cada colección

  • Incluye nombres de campos y tipos de datos.

  • Documentos de muestra para comprender la estructura de datos

Plantillas de recursos

El servidor proporciona plantillas para:

• typesense_search - Plantilla para construir consultas de búsqueda de Typesense

• typesense_collection : plantilla para ver los detalles de la colección Typesense

Uso con Claude Desktop

Para usar este servidor con la aplicación Claude Desktop, agregue la siguiente configuración a la sección "mcpServers" de su claude_desktop_config.json :

{
  "mcpServers": {
    "typesense": {
      "command": "npx",
      "args": [
        "-y",
        "typesense-mcp-server",
        "--host", "your-typesense-host",
        "--port", "8108",
        "--protocol", "http",
        "--api-key", "your-api-key"
      ]
    }
  }
}

Explotación florestal

El servidor registra información en un archivo ubicado en:

/tmp/typesense-mcp.log

Este registro contiene información detallada sobre las operaciones del servidor, las solicitudes y cualquier error que se produzca.

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.