Logseq

🚀 Logseq MCP サーバー

このサーバーは、Logseq の知識ベースと直接統合するモデルコンテキストプロトコル (MCP) を提供します。大規模言語モデル (LLMs) が Logseq のチャートとやり取りし、ページを作成し、ブロックを管理し、情報をプログラムで整理できるようにします。

🚀 クイックスタート

💻 使用例

基本的な使用法

Claude Desktop を使用する場合のサンプル設定を次に示します。

{
  "mcpServers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_KEY>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

🔧 利用可能なツール

ブロック操作

• logseq_insert_block - Logseq 内に新しいブロックを作成します。 パラメータ:

  • parent_block (文字列): 親ブロックの UUID またはページ名
  • content (文字列, 必須): ブロックの内容
  • is_page_block (ブール値): ページレベルのブロックとして作成するかどうか
  • before (ブール値): 親ブロックの前に挿入するかどうか
  • custom_uuid (文字列): カスタムの UUIDv4

• logseq_edit_block - ブロックを編集モードに移行します。 パラメータ:

  • src_block (文字列, 必須): ブロックの UUID
  • pos (数値): カーソルの位置

• logseq_exit_editing_mode - 編集モードを終了します。 パラメータ:

  • select_block (ブール値): ブロックを選択状態に保つかどうか

ページ操作

• logseq_create_page - 新しいページを作成します。 パラメータ:

  • page_name (文字列, 必須): ページ名
  • properties (オブジェクト): ページのプロパティ
  • journal (ブール値): 日誌ページとして設定するかどうか
  • format (文字列): ページの形式 (Markdown/org)

• logseq_get_page - ページの詳細を取得します。 パラメータ:

  • src_page (文字列, 必須): ページの識別子
  • include_children (ブール値): 子ブロックを含めるかどうか

• logseq_get_all_pages - すべてのページをリストします。 パラメータ:

  • repo (文字列): リポジトリ名

内容検索

• logseq_get_current_page - アクティブなページ/ブロックを取得します。 パラメータ: なし

• logseq_get_current_blocks_tree - 現在のページのブロック階層構造を取得します。 パラメータ: なし

• logseq_get_editing_block_content - アクティブなブロックの内容を取得します。 パラメータ: なし

• logseq_get_page_blocks_tree - ページのブロック構造を取得します。 パラメータ:

  • src_page (文字列, 必須): ページの識別子

💡 プロンプト

logseq_insert_block

Logseq 内に新しいブロックを作成します。 パラメータ:

• parent_block: 親ブロックの参照 (ページ名または UUID)
• content: ブロックの内容
• is_page_block: ページレベルのブロックとして設定する場合は true

logseq_create_page

新しいページを作成します。 パラメータ:

• page_name (文字列, 必須): 新しいページの名前
• properties (オプション): ページのプロパティ、例: { "property1": "value1", "property2": "value2" }
• journal (オプション): 日誌ページとして設定する場合は true

📦 インストール

依存関係のインストール

以下のツールがインストールされていることを確認してください。

pip install --user mcpy uvx

MCP サーバーの設定ファイルの作成

プロジェクトのルートディレクトリに mcp-server-logseq.json ファイルを作成し、以下の内容を記述します。

{
  "servers": {
    "logseq": {
      "command": "uvx",
      "args": ["mcp-server-logseq"],
      "env": {
        "LOGSEQ_API_TOKEN": "<YOUR_LOGSEQ_API_TOKEN>",
        "LOGSEQ_API_URL": "http://127.0.0.1:12315"
      }
    }
  }
}

MCP サーバーの起動

以下のコマンドを実行して、Logseq MCP サーバーを起動します。

uvx run mcp-server-logseq --config=mcp-server-logseq.json

🤝 貢献ガイド

Logseq の統合を強化するための貢献を歓迎します。

• 新しい API エンドポイントの追加 (ページリンク、クエリサポート)
• ブロック操作機能の改善
• テンプレートサポートの追加
• エラー処理の強化