Logseq MCP サーバー

Logseqのナレッジベースとの直接統合を提供するモデルコンテキストプロトコルサーバー。このサーバーにより、LLMは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"
      }
    }
  }
}

エラーがある場合は、0.0.1 バージョンを使用してください。

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

Related MCP server: mcp-graphql

利用可能なツール

ブロック操作

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

  • parent_block (文字列): 親ブロックのUUIDまたはページ名

  • content （文字列、必須）: ブロックコンテンツ

  • is_page_block (boolean): ページレベルのブロックとして作成する

  • before (boolean): 親ブロックの前に挿入

  • custom_uuid (文字列): ブロックのカスタムUUIDv4

• logseq_edit_block - ブロック編集モードに入るパラメータ:

  • src_block (文字列、必須): ブロックUUID

  • pos (数値): カーソル位置

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

  • select_block (boolean): ブロックを選択したままにする

ページ操作

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

  • page_name (文字列、必須): ページ名

  • properties （オブジェクト）：ページのプロパティ

  • journal (ブール値): ジャーナルページとして作成

  • format （文字列）：ページフォーマット（markdown/org）

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

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

  • include_children (boolean): 子ブロックを含める

• 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 Arguments に新しいブロックを作成します。

• parent_block : 親ブロック参照（ページ名またはUUID）

• content : ブロックコンテンツ

• is_page_block : ページレベルのブロックの場合はtrueに設定する

ログシーケンス作成ページ

新しい Logseq ページを作成する引数:

• page_name : ページの名前

• properties : JSON としてのページプロパティ

• journal : ジャーナルページの場合はtrueに設定する

インストール

pipの使用

pip install mcp-server-logseq

出典

git clone https://github.com/dailydaniel/logseq-mcp.git
cd logseq-mcp
cp .env.example .env
uv sync

サーバーを実行します。

python -m mcp_server_logseq

構成

APIキー

1. LogseqでAPIトークンを生成する: API → 認証トークン

2. 環境変数を設定します:

export LOGSEQ_API_TOKEN=your_token_here

またはコマンドライン経由で渡します:

python -m mcp_server_logseq --api-key=your_token_here

グラフ構成

デフォルトの URL: http://localhost:12315カスタマイズするには:

python -m mcp_server_logseq --url=http://your-logseq-instance:port

例

会議メモページを作成する

Create new page "Team Meeting 2024-03-15" with properties:
- Tags: #meeting #engineering
- Participants: Alice, Bob, Charlie
- Status: pending

既存のページにタスクブロックを追加する

Add task to [[Project Roadmap]]:
- [ ] Finalize API documentation
- Due: 2024-03-20
- Priority: high

最初のブロックでジャーナルエントリを作成する

Create journal entry for today with initial content:
- Morning standup completed
- Started work on new authentication system

デバッグ

npx @modelcontextprotocol/inspector uv --directory . run mcp-server-logseq

貢献

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

• 新しい API エンドポイントの追加 (ページリンク、クエリサポート)

• ブロック操作機能の改善

• テンプレートサポートを追加する

• エラー処理の強化