Logseq MCPツール

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

インストール

Logseq で API が有効になっていることを確認してください。
- Logseqで、「設定」>「詳細設定」>「開発者モード」>「開発者モードを有効にする」に移動します。
- 次に、プラグイン > Logseq Developer プラグインをオンにします。
- 詳細設定でAPIトークンも設定します
- Logseqを再起動する
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" } } } }

Cursor で Claude を使用する場合は、次のようなプロンプトで Logseq ツールが利用可能であることを通知する必要があります。

「Logseq グラフを操作するのに役立つ Logseq ツールにアクセスできます。logseq.get_all_pages()、logseq.get_page(name)、logseq.create_page(name) などの関数を使用できます。」

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

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

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

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

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

自動箇条書き: すべてのブロックはLogseq UIで自動的に箇条書きとしてレンダリングされます。
ページリンク: 二重括弧を使用してリンクを作成します: [[Page Name]]
階層ブロック:
- ブロック構造データには階層情報が含まれています。
  - parent : 親ブロックのID
  - level : インデントレベル（トップレベルの場合は1、インデントされたブロックの場合は2以上）
  - left : 左のブロック（通常はインデントされたブロックの親）
ブロックコンテンツ: ブロックを作成するときに、テキストの書式設定を含めることができます。
- 基本的な Markdown がサポートされています (太字、斜体など)
- ブロック内の箇条書きはサポートが限られる場合があります
- 複数行のコンテンツはサポートされていますが、Logseqの解析ルールの対象となる場合があります。
ジャーナルブロック: ジャーナルページで作成されたブロックは特別な属性を継承します。
- journal? : 本当
- journalDay : YYYYMMDD - ジャーナルページと同じ

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

Cursor エージェントの操作: Cursor で Logseq MCP ツールが設定されている場合は、次のようなエージェントプロンプトを出すことができます。

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