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

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

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Una implementación de servidor MCP que permite que los modelos de IA descubran, busquen y analicen datos almacenados en colecciones de Typesense a través de herramientas para consultar documentos, recuperar elementos específicos y acceder a las estadísticas de la colección.

Related Resources

Reddit Discussion about this server

Related MCP Servers

lunchmoney-mcp
leafeye
A
security
A
license
A
quality
An MCP server that lets AI assistants interact with your Lunchmoney data, enabling natural language queries about transactions, budgets, and spending patterns.
Last updated -
4
3
8
TypeScript
MIT License
Foundry MCP Server
qwert666
-
security
A
license
-
quality
An MCP server that allows AI assistants to interact with Foundry datasets, ontology objects, and functions through natural language queries and commands.
Last updated -
2
Python
MIT License
Notion MCP Serverofficial
makenotion
A
security
A
license
A
quality
An MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.
Last updated -
19
7,075
2,226
TypeScript
MIT License
API Docs MCP Server
ShotaNagafuchi
-
security
F
license
-
quality
An MCP server that crawls API documentation websites and exposes their content to AI models, enabling them to search, browse, and reference API specifications.
Last updated -
Python

View all related MCP servers

Typesense MCP Server