Logseq MCP

🚀 Logseq MCP Tools

このプロジェクトは、AIエージェントがローカルのLogseqインスタンスとやり取りできるようにする一連のモデルコンテキストプロトコル（MCP）ツールを提供します。

Modlによってホストされています。Modlチームによるコミットや変更は、互換性を確保するためのものです。

🚀 クイックスタート

📦 インストール

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

   pip install -e .
   

🔧 セットアップ

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

   • Logseqで、設定 > 高度設定 > 開発者モード > 開発者モードを有効にする
   • 次に、プラグイン > Logseq開発者プラグインをオンにする
   • また、高度設定で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との連携

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

Claudeとの連携

CursorでClaudeを使用する場合、次のようなプロンプトでLogseqツールが利用可能であることを伝える必要があります。 "You have access to Logseq tools that can help you interact with my Logseq graph. You can use functions like logseq.get_all_pages(), logseq.get_page(name), logseq.create_page(name), etc."

📚 ドキュメント

利用可能なツール

すべてのツールは 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ツールを構成すると、エージェントに次のようなプロンプトを与えることができます。

• "Create a new page called 'Meeting Notes' with bullet points for today's agenda"
• "Add today's tasks to my journal page with a 'Tasks' section"
• "Update today's journal entry with [[Project Plan]], set its child element to 'Completed milestone 1'"
• "Search my graph for blocks about 'python projects' and organize them on a new page"

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