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 grafos 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"
      }
    }
  }
}

Si tiene errores, utilice la versión 0.0.1:

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

Related MCP server: mcp-graphql

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

1. Generar token de API en Logseq: API → Tokens de autorización

2. 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