ergut/mcp-logseq

解決する課題

このプロジェクトは、ClaudeなどのAIアシスタントをLogSeqナレッジベースに接続するModel Context Protocol (MCP)サーバーを提供します。ノートを手動でエクスポートまたはコピーする必要がなくなり、AIがユーザーのローカルグラフ内でページやブロックを直接読み取り、作成、管理できるようになります。

仕組み

このサーバーは、MCP互換クライアント（Claude DesktopやClaude Codeなど）とLogSeq HTTP API間のブリッジとして機能します。ページとブロックの操作のための16のコアツールを公開しており、Logseq DSLクエリの実行や名前空間の管理機能も含まれています。

オプションの高度な機能には以下が含まれます：

• セマンティックベクトル検索: ローカル (Ollama) またはホスト型 (OpenAI) の埋め込みをLanceDBと共に使用して、単なるキーワードではなく意味でノートを検索します。
• アクセス制御: 除外されたタグや特定の名前空間の許可/拒否リストに基づいてコンテンツをフィルタリングし、プライベートなノートをAIから隠したままにします。
• DBモードサポート: LogseqのDBモードグラフのユーザーに対して、クラスプロパティの読み取りと書き込みを許可します。

対象者

ナレッジ管理を自動化し、ノート全体で複雑な分析を実行し、またはAIを使用して既存のナレッジグラフ内で直接コンテンツを整理および生成したいLogSeqユーザー。

ハイライト

• 直接的なグラフ操作: AIインターフェースから離れることなく、ページやブロックの作成、更新、削除、名前変更を行います。
• スマートなMarkdown解析: 標準のMarkdownをLogseqのネイティブなネストされたブロック構造に自動的に変換します。
• セマンティック検索: ベクトルデータベースとのオプションの統合により、意味に基づく検索を可能にします。
• プライバシー制御: タグと名前空間を使用して、AIが閲覧できる内容をきめ細かく制御します。
• 柔軟なデプロイ: 標準のstdio通信と、TLSおよびベアラー認証を備えた長時間のHTTPサービスの両方をサポートします。