Herramientas MCP de Logseq

Este proyecto proporciona un conjunto de herramientas de Protocolo de contexto de modelo (MCP) que permiten a los agentes de IA interactuar con su instancia de Logseq local.

Instalación

1. Asegúrese de tener instalado Python 3.11+
2. Clonar este repositorio
3. Instalar dependencias:
   pip install -e .

Configuración

1. Asegúrese de que su Logseq tenga la API habilitada.
   • En Logseq, vaya a Configuración > Avanzado > Modo de desarrollador > Habilitar modo de desarrollador
   • Luego, vaya a Complementos > Activar el complemento para desarrolladores de Logseq
   • También configure un token API en la configuración avanzada
   • Reiniciar Logseq
2. Configure el servidor MCP en su archivo de configuración de Cursor MCP (normalmente en ~/.cursor/mcp.json ):
   { "mcpServers": { "logseq": { "command": "/opt/homebrew/bin/uvx", "args": ["logseq-mcp"], "env": { "LOGSEQ_API_URL": "http://localhost:12315", "LOGSEQ_TOKEN": "your-token-here" } } } }

Uso con Cursor y Claude

Agregar a las herramientas MCP de Cursor

1. Configure el servidor MCP como se muestra arriba en la sección Configuración
2. Abra Cursor y vaya al panel MCP (barra lateral)
3. La herramienta Logseq debería aparecer en su lista de herramientas disponibles

Usando con Claude

Al usar Claude en Cursor, deberá informarle que tiene herramientas Logseq disponibles con un mensaje similar a este:

Tienes acceso a herramientas de Logseq que te permiten interactuar con mi gráfico de Logseq. Puedes usar funciones como logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name), etc.

Herramientas disponibles

Todas las herramientas están disponibles en el espacio de nombres logseq :

Páginas

• logseq.get_all_pages : obtiene una lista de todas las páginas en el gráfico Logseq
• logseq.get_page : Obtener una página específica por nombre
• logseq.create_page : Crea una nueva página
• logseq.delete_page : Eliminar una página y todos sus bloques

Bloques

• logseq.get_page_blocks : Obtener todos los bloques de una página específica
• logseq.get_block : Obtener un bloque específico por ID
• logseq.create_block : Crea un nuevo bloque en una página
• logseq.insert_block : Insertar un bloque como hijo de otro bloque
• logseq.update_block : Actualizar un bloque existente
• logseq.move_block : Mover un bloque a una ubicación diferente
• logseq.remove_block : Elimina un bloque y todos sus hijos
• logseq.search_blocks : busca bloques que coincidan con una consulta

Trabajar con Logseq

Páginas del diario

Las páginas de diario en Logseq tienen un formato y atributos específicos:

1. Utilice el formato "mmm dth, aaaa" (por ejemplo, "4 de abril de 2025") al crear o acceder a páginas de diario
2. Las páginas del diario se formatean automáticamente mediante Logseq con la datación adecuada
3. Las páginas del diario tienen atributos especiales que Logseq establece automáticamente:
   • journal? : verdadero - Indica que esta es una página de diario
   • journalDay : AAAAMMDD - La fecha en formato numérico (por ejemplo, 20250404 para el 4 de abril de 2025)
4. Ejemplo: await logseq.create_page("Apr 4th, 2025")

Importante: No es necesario configurar manualmente los atributos " journal? o journalDay . Simplemente crear una página con el formato de fecha correcto (p. ej., "4 de abril de 2025") la configurará automáticamente como una página de diario con los atributos adecuados.

Estructura y formato de bloques

Los bloques en Logseq tienen algunas características importantes que es necesario comprender:

1. Viñetas automáticas : todos los bloques se representan automáticamente como viñetas en la interfaz de usuario de Logseq
2. Enlaces de página : Crea enlaces usando corchetes dobles: [[Page Name]]
3. Bloques jerárquicos :
   • Los datos de estructura de bloques contienen información jerárquica:
     • parent : ID del bloque padre
     • level : El nivel de sangría (1 para el nivel superior, 2+ para bloques sangrados)
     • left : El bloque a la izquierda (normalmente el padre de los bloques sangrados)
4. Contenido del bloque : al crear bloques, puedes incluir formato de texto:
   • Se admite Markdown básico (negrita, cursiva, etc.)
   • Las viñetas dentro de un bloque pueden tener un soporte limitado
   • Se admite contenido de varias líneas, pero puede estar sujeto a las reglas de análisis de Logseq.
5. Bloques de diario : los bloques creados en las páginas del diario heredan atributos especiales:
   • journal? : cierto
   • journalDay : AAAAMMDD - Igual que la página del diario

Nota: Al igual que las páginas de diario, Logseq gestiona automáticamente estos atributos de bloque. No es necesario configurar manualmente los atributos journal? ni journalDay al crear bloques en las páginas de diario.

Ejemplo de uso para tareas comunes

Trabajar con el agente Cursor: cuando tenga herramientas Logseq MCP configuradas en Cursor, puede darle al agente indicaciones como:

• Crea una nueva página llamada "Notas de la reunión" con viñetas para la agenda de hoy.
• Añade las tareas de hoy a mi diario con la sección "Tareas".
• "Actualizar la entrada del diario de hoy con [[Plan del proyecto]], establecer su elemento secundario como 'Hito 1 completado'"
• Busca en mi gráfico bloques sobre "proyectos de Python" y organízalos en una nueva página.

El agente utilizará las herramientas Logseq adecuadas para realizar estas operaciones en su gráfico.