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"
}
}
}
}
利用可能なツール
ブロック操作
- logseq_insert_block - Logseq に新しいブロックを作成します。パラメータ:
parent_block (文字列): 親ブロックのUUIDまたはページ名content （文字列、必須）: ブロックコンテンツis_page_block (boolean): ページレベルのブロックとして作成するbefore (boolean): 親ブロックの前に挿入custom_uuid (文字列): ブロックのカスタムUUIDv4
- logseq_edit_block - ブロック編集モードに入るパラメータ:
src_block (文字列、必須): ブロックUUIDpos (数値): カーソル位置
- 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 - すべてのページを一覧表示しますパラメータ:
コンテンツ検索
- 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キー
- LogseqでAPIトークンを生成する: API → 認証トークン
- 環境変数を設定します:
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 エンドポイントの追加 (ページリンク、クエリサポート)
- ブロック操作機能の改善
- テンプレートサポートを追加する
- エラー処理の強化