Asistente MCP de TxtAI

Implementación de un servidor de Protocolo de Contexto de Modelo (MCP) para búsqueda semántica y gestión de memoria mediante txtai . Este servidor proporciona una API robusta para almacenar, recuperar y gestionar memorias basadas en texto con capacidades de búsqueda semántica.

Acerca de txtai

Este proyecto se basa en txtai , un excelente motor de búsqueda de código abierto impulsado por IA creado por NeuML . txtai proporciona:

• 🔍 Solución de búsqueda semántica todo en uno

• 🧠 Búsqueda neuronal con transformadores

• Clasificación de texto de disparo cero

• 🔄 Extracción e incrustaciones de texto

• 🌐 Soporte multilingüe

• 🚀 Alto rendimiento y escalabilidad

Ampliamos las capacidades de txtai integrándolo con el Protocolo de Contexto de Modelo (MCP), lo que permite a asistentes de IA como Claude y Cline aprovechar sus potentes capacidades de búsqueda semántica. Agradecemos especialmente al equipo de txtai por crear una herramienta tan potente y flexible.

Related MCP server: Lspace MCP Server

Características

• 🔍 Búsqueda semántica en los recuerdos almacenados

• 💾 Almacenamiento persistente con backend basado en archivos

• 🏷️ Organización y recuperación de memoria basada en etiquetas

• 📊 Estadísticas de memoria y monitorización de la salud

• 🔄 Persistencia automática de datos

• 📝 Registro completo

• 🔒 Ajustes CORS configurables

• 🤖 Integración con Claude y Cline AI

Prerrequisitos

• Python 3.8 o superior

• pip (instalador de paquetes de Python)

• virtualenv (recomendado)

Instalación

1. Clonar este repositorio:

2. Ejecute el script de inicio:

El guión hará lo siguiente:

• Crear un entorno virtual

• Instalar las dependencias necesarias

• Configurar los directorios necesarios

• Crear un archivo de configuración a partir de una plantilla

• Iniciar el servidor

Configuración

El servidor se puede configurar mediante variables de entorno en el archivo .env . Se proporciona una plantilla en .env.template :

Integración con Claude y Cline AI

Este asistente TxtAI se puede utilizar como servidor MCP con Claude y Cline AI para mejorar sus capacidades con memoria semántica y funcionalidad de búsqueda.

Configuración para Claude

Para usar este servidor con Claude, agréguelo al archivo de configuración MCP de Claude (normalmente ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

Configuración para Cline

Para usar con Cline, agregue la configuración del servidor al archivo de configuración MCP de Cline (normalmente ubicado en ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ):

Herramientas MCP disponibles

Una vez configuradas, las siguientes herramientas estarán disponibles para Claude y Cline:

1. store_memory : Almacena nuevo contenido de memoria con metadatos y etiquetas

2. retrieve_memory : Recupera recuerdos basándose en la búsqueda semántica

3. search_by_tag : Buscar recuerdos por etiquetas

4. delete_memory : Elimina una memoria específica por hash de contenido

5. get_stats : Obtener estadísticas de la base de datos

6. check_health : Verificar el estado de la base de datos y del modelo de incrustación

Ejemplos de uso

En Claude o Cline, puedes utilizar estas herramientas a través del protocolo MCP:

La IA utilizará automáticamente estas herramientas para mantener el contexto y recuperar información relevante durante las conversaciones.

Puntos finales de API

Memoria de la tienda

Almacene una nueva memoria con metadatos y etiquetas opcionales.

Cuerpo de la solicitud:

Buscar recuerdos

Buscar recuerdos usando la búsqueda semántica.

Cuerpo de la solicitud:

Buscar por etiquetas

Buscar recuerdos por etiquetas.

Cuerpo de la solicitud:

Borrar memoria

Eliminar una memoria específica por su hash de contenido.

Obtener estadísticas

Obtenga estadísticas del sistema, incluidos recuentos de memoria y distribución de etiquetas.

Chequeo de salud

Verifique el estado de salud del servidor.

Estructura del directorio

Almacenamiento de datos

Las memorias y las etiquetas se almacenan en archivos JSON en el directorio data :

• memories.json : Contiene todos los recuerdos almacenados

• tags.json : Contiene el índice de etiquetas

Explotación florestal

Los registros se almacenan en el directorio logs . El archivo de registro predeterminado es server.log .

Desarrollo

Para contribuir a este proyecto:

1. Bifurcar el repositorio

2. Crear una rama de características

3. Realiza tus cambios

4. Enviar una solicitud de extracción

Manejo de errores

El servidor implementa un manejo integral de errores:

• Las solicitudes no válidas devuelven códigos de estado HTTP apropiados

• Los errores se registran con seguimientos de pila.

• Se devuelven mensajes de error fáciles de usar en las respuestas.

Consideraciones de seguridad

• Los ajustes de CORS se pueden configurar mediante variables de entorno

• Las rutas de archivos se desinfectan para evitar el cruce de directorios

• La validación de entrada se realiza en todos los puntos finales

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Apoyo

Si encuentra algún problema o tiene preguntas, envíe un problema en el repositorio de GitHub.