Herramientas MCP de Logseq

Un servidor de Protocolo de contexto de modelo (MCP) que proporciona a los asistentes de IA acceso estructurado a su gráfico de conocimiento de Logseq.

Descripción general

Este proyecto crea un servidor MCP que permite a los asistentes de IA como Claude interactuar con la base de conocimientos de Logseq. Proporciona herramientas para:

• Recuperar una lista de todas las páginas
• Obtener contenido de páginas específicas
• Generación de resúmenes de revistas para rangos de fechas flexibles
• Extraer páginas vinculadas y explorar conexiones

Instalación

1. Clonar este repositorio
2. Instalar dependencias usando npm, yarn o pnpm:

3. Copie la plantilla de entorno y configure su token Logseq:

Configuración

Este proyecto incluye un archivo .env.template que puedes copiar y renombrar a .env .

Puede encontrar su token de autenticación de Logseq mediante:

1. Apertura de Logseq
2. Habilitar la API HTTP en Configuración > Funciones > Habilitar API HTTP
3. Configuración de su token de autenticación en Configuración > Características > Token de autenticación de API HTTP

Uso

Ejecución del servidor MCP

El servidor se puede iniciar utilizando:

Conectando con Claude

Escritorio de Claude

Siga la guía de inicio rápido de Claude MCP :

1. Importante : instala Node.js globalmente a través de Homebrew (o lo que sea):

2. Instalar la aplicación de escritorio Claude
3. Abra el menú Claude y seleccione "Configuración..."
4. Haga clic en "Desarrollador" en la barra lateral izquierda, luego haga clic en "Editar configuración".
5. Esto abrirá el archivo claude_desktop_config.json . Reemplace su contenido con:

IMPORTANTE: Reemplace /path/to/your/index.ts con la ruta absoluta exacta a su archivo index.ts (por ejemplo, /Users/username/Code/logseq-mcp-tools/index.ts )

6. Guarde el archivo y reinicie Claude Desktop

Ahora puedes chatear con Claude y pedirle que utilice tus datos de Logseq:

• "Muéstrame mis entradas recientes del diario"
• "Resume mis notas de la semana pasada"
• "Buscar todas las páginas relacionadas con [tema]"

Claude en Cursor

Siga la documentación de Cursor MCP :

1. Cursor abierto
2. Agregar un nuevo servicio MCP desde la configuración
3. Introduzca el siguiente comando:

4. Dale a tu servicio un nombre como "Herramientas Logseq"

Ahora puedes usar Claude en Cursor con tus datos Logseq.

Claude en la API antrópica (genérica)

Al utilizar las herramientas CLI o API de Claude, puede agregar el servicio MCP con:

Herramientas disponibles

obtenerTodasLasPáginas

Recupera una lista de todas las páginas de su gráfico Logseq.

obtener página

Obtiene el contenido de una página específica.

Parámetros:

• pageName : El nombre de la página a recuperar

obtenerResumenDiario

Genera un resumen de las entradas del diario para un rango de fechas específico.

Parámetros:

• dateRange : rango de fechas en lenguaje natural como "hoy", "esta semana", "el mes pasado", "este año", etc.

Esta herramienta hará lo siguiente:

• Recopilar entradas de diario en el rango especificado
• Formatearlos de forma legible
• Extraer y analizar páginas/conceptos referenciados
• Mostrar los conceptos referenciados con mayor frecuencia

crearPágina

Crea una nueva página en su gráfico Logseq.

Parámetros:

• pageName : Nombre para la nueva página
• content : (opcional) Contenido inicial de la página

Páginas de búsqueda

Busca páginas por nombre.

Parámetros:

• query : Consulta de búsqueda para filtrar páginas por nombre

obtener backlinks

Encuentra todas las páginas que hacen referencia a una página específica.

Parámetros:

• pageName : El nombre de la página para la cual se buscarán vínculos de retroceso

analizarGráfico

Realiza un análisis completo de su gráfico de conocimiento.

Parámetros:

• daysThreshold : (Opcional) Número de días para buscar contenido "reciente" (predeterminado: 30)

Características:

• Identifica páginas referenciadas frecuentemente
• Realiza un seguimiento de las actualizaciones recientes
• Descubre grupos de páginas y conexiones
• Enumera las tareas pendientes
• Sugiere posibles actualizaciones necesarias

encontrar lagunas de conocimiento

Analiza su gráfico de conocimiento para identificar posibles brechas y áreas de mejora.

Parámetros:

• minReferenceCount : (opcional) Referencias mínimas a considerar (predeterminado: 3)
• includeOrphans : (opcional) Incluye páginas huérfanas en el análisis (valor predeterminado: verdadero)

Características:

• Identifica páginas faltantes a las que se hace referencia con frecuencia
• Encuentra páginas subdesarrolladas que necesitan expansión
• Enumera las páginas huérfanas sin enlaces entrantes
• Proporciona estadísticas resumidas

analizarPatronesDeDiario

Analiza patrones en las entradas de tu diario a lo largo del tiempo.

Parámetros:

• timeframe : (opcional) Período de tiempo a analizar (por ejemplo, "últimos 30 días", "este año")
• includeMood : (opcional) Analiza patrones de estado de ánimo si están presentes (valor predeterminado: verdadero)
• includeTopics : (opcional) Analiza patrones de temas (valor predeterminado: verdadero)

Características:

• Tendencias y evolución de los temas
• Análisis de patrones de estado de ánimo
• Estadísticas de seguimiento de hábitos
• Seguimiento del progreso del proyecto

Consulta inteligente

Ejecuta consultas en lenguaje natural utilizando las capacidades DataScript de Logseq.

Parámetros:

• request : Descripción en lenguaje natural de lo que desea encontrar
• includeQuery : (opcional) incluye la consulta de registro de datos generada en los resultados
• advanced : (opcional) Utilice funciones de análisis avanzadas

Características:

• Conexiones y relaciones entre páginas
• Agrupación de contenido
• Análisis del progreso de la tarea
• Seguimiento de la evolución de conceptos

Sugerir conexiones

Utiliza IA para analizar su gráfico y sugerir conexiones interesantes.

Parámetros:

• minConfidence : (opcional) Puntuación mínima de confianza para sugerencias (0-1, valor predeterminado: 0,6)
• maxSuggestions : (opcional) Número máximo de sugerencias a devolver (predeterminado: 10)
• focusArea : (opcional) Tema o área en la que centrar las sugerencias

Características:

• Descubre conexiones potenciales entre páginas
• Identifica oportunidades de síntesis de conocimientos
• Sugiere rutas de exploración basadas en intereses recientes
• Proporciona puntuaciones de confianza para las sugerencias.

Desarrollo

El servidor está construido utilizando:

• SDK de TypeScript del protocolo de contexto de modelo
• Zod para validación de parámetros
• API HTTP de Logseq para acceso a datos

Para ampliar con nuevas herramientas, agregue definiciones server.tool() adicionales en index.ts .

Solución de problemas

Problemas comunes

Administradores de versiones de Node.js (fnm, nvm, etc.)

Si está utilizando un administrador de versiones de Node.js como fnm o nvm, Claude Desktop no podrá acceder a los binarios de Node.js correctamente, ya que se ejecuta fuera de su entorno de shell donde se modifica PATH.

Solución : Instalar un Node.js en todo el sistema con Homebrew:

Esto garantiza que Node.js esté disponible para todas las aplicaciones, incluido Claude Desktop.

Pasos básicos para la solución de problemas

• Asegúrese de que Logseq se esté ejecutando con la API HTTP habilitada
• Verifique que su token de autenticación en .env coincida con el configurado en Logseq
• Comprueba que la ruta a tu archivo index.ts sea correcta en la configuración de Claude
• Intente ejecutar npx tsx index.ts directamente en su terminal para verificar que funciona

Visualización de registros en Claude Desktop

Monitorizar registros en tiempo real:

Para obtener información de depuración más detallada, consulte la documentación de depuración oficial de MCP .