local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Provides direct integration with Logseq's knowledge base, enabling interaction with Logseq graphs, creating pages, managing blocks, and organizing information programmatically.
Supports Markdown as a page format option when creating new pages in Logseq.
Supports Org format as a page format option when creating new pages in Logseq.

Servidor MCP de Logseq

Un servidor de Protocolo de Contexto de Modelo que proporciona integración directa con la base de conocimiento de Logseq. Este servidor permite a los LLM interactuar con los gráficos de Logseq, crear páginas, gestionar bloques y organizar la información mediante programación.

Uso con Claude Desktop

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_KEY>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

Herramientas disponibles

Operaciones de bloque

logseq_insert_block - Crea nuevos bloques en Logseq Parámetros :
- parent_block (cadena): UUID del bloque padre o nombre de la página
- content (cadena, obligatorio): Contenido del bloque
- is_page_block (booleano): Crear como bloque a nivel de página
- before (booleano): Insertar antes del bloque padre
- custom_uuid (cadena): UUIDv4 personalizado para el bloque
logseq_edit_block - Ingresa al modo de edición de bloques Parámetros :
- src_block (cadena, obligatoria): UUID del bloque
- pos (número): Posición del cursor
logseq_exit_editing_mode - Salir del modo de edición Parámetros :
- select_block (booleano): mantener el bloque seleccionado

Operaciones de página

logseq_create_page - Crear nuevas páginas Parámetros :
- page_name (cadena, obligatoria): Nombre de la página
- properties (objeto): Propiedades de la página
- journal (booleano): Crear como página de diario
- format (cadena): Formato de página (markdown/org)
logseq_get_page - Obtener detalles de la página Parámetros :
- src_page (cadena, obligatoria): identificador de página
- include_children (booleano): incluye bloques secundarios
logseq_get_all_pages - Listar todas las páginas Parámetros :
- repo (cadena): nombre del repositorio

Recuperación de contenido

logseq_get_current_page - Obtener la página/bloque activo Parámetros : Ninguno
logseq_get_current_blocks_tree - Jerarquía de bloques de la página actual Parámetros : Ninguno
logseq_get_editing_block_content - Obtener el contenido del bloque activo Parámetros : Ninguno
logseq_get_page_blocks_tree - Obtener la estructura del bloque de la página Parámetros :
- src_page (cadena, obligatoria): identificador de página

Indicaciones

bloque de inserción logseq

Crear un nuevo bloque en Logseq Argumentos:

parent_block : Referencia del bloque padre (nombre de la página o UUID)
content : Bloquear contenido
is_page_block : Establecer como verdadero para bloques a nivel de página

página de creación de logseq

Crear una nueva página Logseq Argumentos:

page_name : Nombre de la página
properties : Propiedades de la página en formato JSON
journal : Establecer como verdadero para las páginas del diario

Instalación

Usando pip

pip install mcp-server-logseq

De la fuente

git clone https://github.com/dailydaniel/logseq-mcp.git
cd logseq-mcp
cp .env.example .env
uv sync

Ejecutar el servidor:

python -m mcp_server_logseq

Configuración

Clave API

Generar token de API en Logseq: API → Tokens de autorización
Establecer variable de entorno:

export LOGSEQ_API_TOKEN=your_token_here

O pasar vía línea de comando:

python -m mcp_server_logseq --api-key=your_token_here

Configuración de gráficos

URL predeterminada: http://localhost:12315 Para personalizar:

python -m mcp_server_logseq --url=http://your-logseq-instance:port

Ejemplos

Crear página de notas de reunión

Create new page "Team Meeting 2024-03-15" with properties:
- Tags: #meeting #engineering
- Participants: Alice, Bob, Charlie
- Status: pending

Agregar bloque de tareas a una página existente

Add task to [[Project Roadmap]]:
- [ ] Finalize API documentation
- Due: 2024-03-20
- Priority: high

Crear una entrada de diario con el primer bloque

Create journal entry for today with initial content:
- Morning standup completed
- Started work on new authentication system

Depuración

npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq

Contribuyendo

Agradecemos contribuciones para mejorar la integración de Logseq:

Agregar nuevos puntos finales de API (vinculación de páginas, compatibilidad con consultas)
Mejorar las capacidades de manipulación de bloques
Añadir soporte para plantillas
Mejorar el manejo de errores

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor que permite a los LLM interactuar programáticamente con los gráficos de conocimiento de Logseq, lo que permite la creación y gestión de páginas y bloques.

Related Resources

Reddit Discussion about this server

Logseq MCP Server