Logseq MCP Tools

Logseq MCP ツール

このプロジェクトは、AI エージェントがローカルの Logseq インスタンスとやり取りできるようにする、Model Context Protocol（MCP）ツールのセットを提供します。

インストール

1. Python 3.11+ がインストールされていることを確認します
2. このリポジトリをクローンします
3. 依存関係をインストールします：

   pip install -e .
   

セットアップ

1. Logseq で API が有効になっていることを確認します。

   • Logseq で、Settings > Advanced > Developer mode > Enable Developer mode に移動します
   • 次に、Plugins > Turn on Logseq Developer Plugin に移動します
   • Advanced settings で API トークンも設定します
   • Logseq を再起動します

2. Cursor の MCP 設定ファイル（通常は ~/.cursor/mcp.json）で MCP サーバーを設定します：

   {
     "mcpServers": {
       "logseq": {
         "command": "/opt/homebrew/bin/uvx",
         "args": ["logseq-mcp"],
         "env": {
           "LOGSEQ_API_URL": "http://localhost:12315",
           "LOGSEQ_TOKEN": "your-token-here"
         }
       }
     }
   }
   

または

3. 次の方法で、Claude Code が MCP サーバーを使用するように設定します：

claude mcp add

• スコープを選択します
• Stdio を選択します
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

Cursor および Claude での使用

Cursor の MCP ツールへの追加

1. セットアップのセクションで説明したとおりに、MCP サーバーを設定します

2. Cursor を開き、MCP パネル（サイドバー）に移動します

3. 利用可能なツールの一覧に Logseq ツールが表示されます

Claude での使用

Cursor で Claude を使用する場合、次のようなプロンプトを使って、Logseq ツールを利用できることを Claude に伝える必要があります。

「Logseq グラフとやり取りするための Logseq ツールを利用できます。logseq.get_all_pages()、logseq.get_page(name)、logseq.create_page(name) などの関数を使用できます。」

利用可能なツール

すべてのツールは logseq 名前空間で利用できます。

ページ

• logseq.get_all_pages: Logseq グラフ内のすべてのページの一覧を取得します
• logseq.get_page: 名前を指定して特定のページを取得します
• logseq.create_page: 新しいページを作成します
• logseq.delete_page: ページとそのすべてのブロックを削除します

ブロック

• logseq.get_page_blocks: 特定のページからすべてのブロックを取得します
• logseq.get_block: ID を指定して特定のブロックを取得します
• logseq.create_block: ページに新しいブロックを作成します
• logseq.insert_block: 別のブロックの子としてブロックを挿入します
• logseq.update_block: 既存のブロックを更新します
• logseq.move_block: ブロックを別の場所に移動します
• logseq.remove_block: ブロックとそのすべての子ブロックを削除します
• logseq.search_blocks: クエリに一致するブロックを検索します

Logseq の操作

ジャーナルページ

Logseq のジャーナルページには、特定の形式と属性があります。

1. ジャーナルページを作成または取得する際は、「mmm dth, yyyy」形式（例：「Apr 4th, 2025」）を使用します
2. ジャーナルページは、適切な日付が設定されるよう Logseq によって自動的に書式設定されます
3. ジャーナルページには、Logseq によって自動的に設定される特別な属性があります。
   • journal?: true - これがジャーナルページであることを示します
   • journalDay: YYYYMMDD - 数値形式の日付（例：2025 年 4 月 4 日の場合は 20250404）
4. 例：await logseq.create_page("Apr 4th, 2025")

重要： journal? または journalDay 属性を手動で設定する必要はありません。適切な日付形式（例：「Apr 4th, 2025」）でページを作成するだけで、適切な属性を持つジャーナルページとして自動的に設定されます。

ブロックの構造と書式

Logseq のブロックには、理解しておくべき重要な特徴がいくつかあります。

1. 自動的な箇条書き：Logseq の UI では、すべてのブロックが自動的に箇条書きとして表示されます
2. ページリンク：二重の角括弧を使ってリンクを作成します：[[Page Name]]
3. 階層化されたブロック：
   • ブロック構造データには階層情報が含まれます：
     • parent：親ブロックの ID
     • level：インデントレベル（トップレベルは 1、インデントされたブロックは 2 以上）
     • left：左側のブロック（通常、インデントされたブロックでは親ブロック）
4. ブロックの内容：ブロックを作成するときに、テキストの書式を含めることができます：
   • 基本的な Markdown に対応しています（太字、斜体など）
   • ブロック内の箇条書きは、対応が限定される場合があります
   • 複数行のコンテンツに対応していますが、Logseq の解析ルールの影響を受ける場合があります
5. ジャーナルブロック：ジャーナルページに作成されたブロックは、特別な属性を継承します：
   • journal?：true
   • journalDay：YYYYMMDD - ジャーナルページと同じ

注記： ジャーナルページと同様に、これらのブロック属性は Logseq によって自動的に処理されます。ジャーナルページにブロックを作成するときに、journal? や journalDay 属性を手動で設定する必要はありません。

よくあるタスクでの使用例

Cursor エージェントを使用する場合： Cursor で Logseq MCP ツールを設定すると、次のようなプロンプトをエージェントに与えることができます：

• 「『Meeting Notes』という新しいページを作成して、今日の議題を箇条書きで追加して」
• 「『Tasks』セクションを作成して、今日のタスクをジャーナルページに追加して」
• 「[[Project Plan]] を使って今日のジャーナルエントリーを更新し、その子要素を『Completed milestone 1』に設定して」
• 「グラフ内で『python projects』についてのブロックを検索して、新しいページに整理して」

エージェントは適切な Logseq ツールを使って、グラフ上でこれらの操作を実行します。