logseq-mcp-server

calvincchan/logseq-mcp-server

3.1

If you are the rightful owner of logseq-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Logseq MCP Server is a server-side application designed for local use with the Model Context Protocol (MCP) using the @modelcontextprotocol/sdk.

Logseq MCP Server

Overview

The logseq-mcp-server is a server-side application designed for local use with the Model Context Protocol (MCP) using the @modelcontextprotocol/sdk. It communicates via the standard input/output (stdio) MCP transport, providing backend support for Logseq-related operations and leveraging modern JavaScript features with ES modules.

Features

  • Integration with the Model Context Protocol (MCP) via @modelcontextprotocol/sdk.
  • REST API support using axios.
  • Environment variable management with dotenv.
  • Logging capabilities powered by winston.

Project Structure

logseq-mcp-server/
├── backup/                # Backup files
├── logs/                  # Log files
│   └── logseq-client.log  # Log file for Logseq client
├── src/                   # Source code
│   ├── logseqClient.js    # Logseq client implementation
│   └── server.js          # Main server file
├── package.json           # Project metadata and dependencies
├── README.md              # Project documentation

Prerequisites

  • Node.js (v22 or higher)

Installation

  1. Clone the repository:
    git clone https://github.com/calvinchan/logseq-mcp-server.git
    
  2. Navigate to the project directory:
    cd logseq-mcp-server
    
  3. Install dependencies:
    npm install
    

Usage

Development Mode

To start the server in development mode with live reloading:

npm run dev

Environment Variables

Create a .env file in the root directory to configure environment variables. Example:

LOGSEQ_API_TOKEN=()

Dependencies

  • @modelcontextprotocol/sdk: MCP integration.
  • axios: HTTP client for API requests.
  • dotenv: Environment variable management.
  • winston: Logging library.

License

This project is licensed under the ISC License.