Logseq MCP Tools

Logseq MCPツール

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

インストール

1. Python 3.11以降がインストールされていることを確認してください
2. このリポジトリをクローンする
3. 依存関係をインストールします:
   pip install -e .

設定

1. Logseq で API が有効になっていることを確認してください。
   • Logseqで、「設定」>「詳細設定」>「開発者モード」>「開発者モードを有効にする」に移動します。
   • 次に、プラグイン > Logseq Developer プラグインをオンにします。
   • 詳細設定で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 サーバーを使用するように構成します。

• 範囲を選択
• Stdioを選択
• LOGSEQ_API_URL=http://localhost:12315 LOGSEQ_TOKEN=your-token-here /opt/homebrew/bin/uvx logseq-mcp

カーソルとクロードと併用

カーソルのMCPツールへの追加

1. 上記のセットアップセクションに示すようにMCPサーバーを構成します。
2. カーソルを開いてMCPパネル（サイドバー）に移動します
3. Logseqツールが利用可能なツールのリストに表示されるはずです。

クロードと一緒に使う

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

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

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

ブロック構造とフォーマット

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

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

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

一般的なタスクでの使用例

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

• 「今日の議題を箇条書きにした『会議メモ』という新しいページを作成します」
• 「「タスク」セクションを使用して、今日のタスクをジャーナルページに追加します」
• 「今日のジャーナルエントリを[[プロジェクト計画]]で更新し、その子要素を「完了したマイルストーン1」に設定する」
• 「グラフで「Python プロジェクト」に関するブロックを検索し、新しいページに整理します」

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