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

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

A través de mcp-get

Desarrollo

Instalar dependencias:

Construir el servidor:

Para desarrollo con reconstrucción automática:

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

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:

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 :

Explotación florestal

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

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.