MCP Pkm Logseq

🚀 Logseq個人知識管理システムMCPサーバー

このサーバーは、Logseqの個人知識管理システムとやり取りするためのMCPサーバーで、カスタムコマンドに対応しています。

✨ 主な機能

リソース

• logseq://guide - この知識ベースとのやり取り方法を紹介する初期コマンドガイド

ツール

• get_personal_notes_instructions() - 個人ノートツールの使用方法を取得する
• get_personal_notes(topics, from_date, to_date) - 指定されたトピックタグ付きの個人ノートを検索する
• get_todo_list(done, from_date, to_date) - Logseq内のタスクリストを検索する

📦 インストール

以下の環境変数を設定できます。

🚀 クイックスタート

インストール

Claude DesktopとCursorでの使用：

• MacOSシステムのパス：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windowsシステムのパス：%APPDATA%/Claude/claude_desktop_config.json%

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uvx",
    "args": [
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}

Claude Codeでの実行：

claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq

Logseqサーバーの起動

LogseqのHTTPインターフェースは、Logseqのデスクトップアプリケーション内で動作するインターフェースです。有効にすると、ローカルのHTTPサーバーが起動し（デフォルトポート：12315）、認証済みのリクエストでLogseqの知識ベースにアクセスできます。このインターフェースは、ページとブロックのクエリ、コンテンツの検索、およびコンテンツの変更をサポートしています。

LogseqのHTTPインターフェースサーバーを有効にするには：

1. Logseqを開き、右上の設定に移動します。
2. 高度なオプションに入ります。
3. 「開発者モード」を有効にします。
4. 「HTTP APIサーバー」を有効にします。
5. APIキーを設定します（これはMCPサーバー設定のLOGSEQ_API_KEYの値と一致する必要があります）。

詳細な説明はこちらを参照してください：https://logseq-copilot.eindex.me/doc/setup

MCP PKM Logseqページの作成

知識管理システムに関連するコマンドを保存するために、「MCP PKM Logseq」という名前の新しいページを作成します。

🔧 技術詳細

ビルドと公開

以下のコマンドを使用してプロジェクトをビルドし、公開します。

npm run build

次に、公開されたスクリプトを実行します。

node dist/index.js

デバッグ

開発環境では、デバッグログを追加することで、問題のトラブルシューティングを容易に行えます。

Claude Desktopへの開発サーバー設定の追加

開発サーバーの設定に以下の内容を追加します。

{
  "mcpServers": {
    "mcp-pkm-logseq": {
      "command": "uvx",
      "args": [
        "mcp-pkm-logseq"
      ],
      "env": {
        "LOGSEQ_API_TOKEN": "your-logseq-api-token",
        "LOGSEQ_URL": "http://localhost:12315"
      }
    }
  }
}