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.

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

Clonar o descargar este proyecto.
Navegar al directorio:
cd mcp-limitless-server
Instalar dependencias:
npm install
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:

{
  "mcpServers": {
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

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):

{
  "mcpServers": {
    "some_other_server": {
      "command": "...",
      "args": ["..."],
      "env": {
        "EXAMPLE_VAR": "value"
      }
    },
    "limitless": {
      "command": "node",
      "args": ["<FULL_FILE_PATH_TO_DIST_SERVER.js>"],
      "env": {
        "LIMITLESS_API_KEY": "<YOUR_LIMITLESS_API_KEY_HERE>"
      }
    }
  }
}

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 npm start directamente.

Asegúrese de que el servidor se haya creado correctamente ( npm run build ).
Configure su cliente MCP como se muestra arriba.
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).

limitless_get_lifelog_by_id : recupera una sola grabación de Colgante por su ID específico.
limitless_list_lifelogs_by_date : enumera las grabaciones de Colgante para una fecha específica.
limitless_list_lifelogs_by_range : enumera las grabaciones del colgante dentro de un rango de fecha y hora.
limitless_list_recent_lifelogs : enumera las grabaciones de Colgante más recientes.
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

Limitless MCP Server

Integrations