Servidor MCP ilimitado (v0.1.0)

Este es un servidor MCP (Protocolo de Contexto de Modelo) que conecta los datos de tu Limitless Pendant con herramientas de IA como Claude, Windsurf y otras a través de la API de Limitless . Permite que las interfaces de chat y los agentes de IA interactúen con tu Lifelog de forma estructurada y programable. Avancemos hacia un futuro más organizado e inteligente, con interacciones contextuales cada vez.

¿Qué es MCP?
El Protocolo de Contexto de Modelo es un estándar abierto para conectar modelos de IA con herramientas y datos externos (como el puerto USB-C o incluso el protocolo HTTP para IA): universal, fiable y diseñado para la extensibilidad. El estándar que todos adoptan. Permite integraciones avanzadas, flujos de trabajo personalizados y una comunicación fluida entre la IA y las herramientas que utilizas a diario.

NOTA IMPORTANTE: A partir de marzo de 2025, la API de Limitless requiere que los datos se registren mediante el Limitless Pendant . Este servidor depende de los datos reales registrados por su Limitless Pendant; sin ellos, no devolverá información significativa. Asegúrese de que su Limitless Pendant esté conectado y grabando.

Estado de la API y planes futuros:

• La API oficial de Limitless se encuentra actualmente en fase beta . Por lo tanto, puede ser poco fiable, estar sujeta a cambios o experimentar interrupciones temporales.

• Solicitar grandes cantidades de datos (por ejemplo, listar o buscar cientos de registros) puede generar errores de tiempo de espera (como 504 "Tiempo de espera de puerta de enlace") debido a restricciones de la API o de la red. El servidor incluye un tiempo de espera de 120 segundos por llamada a la API para mitigar esto, pero las solicitudes muy grandes pueden fallar.

• La API Limitless está en desarrollo activo . Este servidor MCP se actualizará con nuevas funciones y mejoras a medida que estén disponibles en la API oficial.

• La versión 0.2.0 de este servidor MCP ya está en desarrollo, con planes de agregar características más sólidas y potencialmente nuevas herramientas en el futuro cercano.

Características (v0.1.0)

• Listar/Obtener registros de vida: Recupera grabaciones del colgante por ID, fecha, rango de fechas o lista de entradas recientes. Incluye control sobre la dirección de ordenación ( asc / desc ).

• Buscar registros recientes: realice búsquedas de texto simples dentro del contenido de una cantidad configurable de grabaciones recientes de Pendant (Nota: solo se pueden buscar registros recientes; no se admite la búsqueda en el historial completo).

Con este servidor, puedes hacer cosas como extraer elementos de acción de tu Lifelog y enviarlos directamente a Notion, a través de Claude, ChatWise, Windsurf o cualquier otro asistente/aplicación de IA que admita MCP.

Related MCP server: Enhanced Interactive Feedback MCP Server

Prerrequisitos

• Node.js (se requiere v18 o posterior)

• npm o hilo

• Una cuenta ilimitada y una clave API ( Obtén una aquí )

• Un colgante sin límites (necesario para los datos)

• Una aplicación cliente MCP (por ejemplo, Claude, Windsurf, Cursor, ChatWise, ChatGPT (¡próximamente!)) capaz de generar servidores stdio y pasar variables de entorno.

Configuración

1. Clonar o descargar este proyecto.

2. Navegar al directorio:

   cd mcp-limitless-server

3. Instalar dependencias:

   npm install

4. Construya el código:

   npm run build

Configuración (lado del cliente)

Este servidor espera que LIMITLESS_API_KEY se proporcione como una variable de entorno cuando lo inicie su cliente MCP.

Debe agregar un bloque de configuración de servidor al archivo de configuración de su cliente MCP. A continuación, se muestran dos ejemplos, dependiendo de si lo agrega como su primer servidor o junto con los servidores existentes.

Ejemplo A: Agregar como el primer/único servidor

Si el archivo de configuración de su cliente actualmente tiene un objeto mcpServers vacío ( "mcpServers": {} ), reemplácelo con esto:

Ejemplo B: Agregar a servidores existentes

Si su objeto mcpServers ya contiene otros servidores (como "notion": {...} ), agregue el bloque "limitless" junto a ellos, asegurando una sintaxis JSON correcta (comas entre entradas):

Importante:

• Reemplace <FULL_FILE_PATH_TO_DIST_SERVER.js> con la ruta correcta y absoluta al script del servidor compilado (p. ej., /Users/yourname/Documents/MCP/mcp-limitless-server/dist/server.js ). Las rutas relativas podrían no funcionar correctamente según el cliente.

• Reemplace <YOUR_LIMITLESS_API_KEY_HERE> con su clave API Limitless real.

• Los archivos de configuración de MCP no pueden contener comentarios . Elimine cualquier texto de marcador de posición como <YOUR_LIMITLESS_API_KEY_HERE> y reemplácelo con su clave real.

Ejecución del servidor (a través del cliente)

No ejecute

1. Asegúrese de que el servidor se haya creado correctamente ( npm run build ).

2. Configure su cliente MCP como se muestra arriba.

3. Inicie su aplicación cliente MCP. Iniciará el proceso mcp-limitless-server automáticamente cuando sea necesario.

Herramientas MCP expuestas (v0.1.0)

(Consulte src/server.ts o pregunte al servidor a través de su cliente para obtener detalles completos).

1. limitless_get_lifelog_by_id : recupera una sola grabación de Colgante por su ID específico.

2. limitless_list_lifelogs_by_date : enumera las grabaciones de Colgante para una fecha específica.

3. limitless_list_lifelogs_by_range : enumera las grabaciones del colgante dentro de un rango de fecha y hora.

4. limitless_list_recent_lifelogs : enumera las grabaciones de Colgante más recientes.

5. limitless_search_lifelogs : busca el título/contenido de grabaciones recientes de Pendant (¡alcance limitado!).

Notas y limitaciones

🚫 Se requiere colgante
Este servidor depende de los datos generados por el Limitless Hanging.

🧪 Estado de la versión beta de la API
La API Limitless está en fase beta y puede experimentar inestabilidad o limitaciones de velocidad ocasionales. Las solicitudes grandes pueden provocar tiempos de espera (por ejemplo, errores 504).

🔍 Ámbito de búsqueda
limitless_search_lifelogs solo analiza un número limitado de registros recientes (predeterminado: 20, máximo: 100). No busca en todo el historial; utilice primero las herramientas de listado para un análisis más completo.

⚠️ Manejo de errores y tiempo de espera
Los errores de API se traducen en resultados de error de MCP. Cada llamada a la API tiene un tiempo de espera de 120 segundos.

🔌 Transporte
Este servidor utiliza stdio y está diseñado para ser iniciado por una aplicación cliente compatible con MCP.

Contribuyendo

¿Tienes ideas, mejoras o comentarios? No dudes en abrir un problema o una solicitud de relaciones públicas. ¡Las contribuciones siempre son bienvenidas! Sigamos ampliando los límites de lo posible con el contexto portátil y las herramientas inteligentes. https://github.com/ipvr9/mcp-limitless-server