logseq-mcp-server

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.