Logseq MCPツール

AI アシスタントに Logseq ナレッジ グラフへの構造化されたアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー。

概要

このプロジェクトは、ClaudeのようなAIアシスタントがLogseqナレッジベースと連携できるようにするMCPサーバーを作成します。以下のツールを提供します。

• すべてのページのリストを取得する
• 特定のページからコンテンツを取得する
• 柔軟な日付範囲のジャーナルサマリーを生成する
• リンクされたページを抽出し、接続を探索する

インストール

1. このリポジトリをクローンする
2. npm、yarn、またはpnpm を使用して依存関係をインストールします。

3. 環境テンプレートをコピーし、Logseq トークンを構成します。

構成

このプロジェクトには、コピーして.envに名前を変更できる.env.templateファイルが含まれています。

Logseq 認証トークンは次の方法で見つけることができます。

1. Logseq を開く
2. 設定 > 機能 > HTTP API を有効にするで HTTP API を有効にする
3. 設定 > 機能 > HTTP API 認証トークンで認証トークンを設定する

使用法

MCPサーバーの実行

サーバーは以下を使用して起動できます。

クロードとのつながり

クロードデスクトップ

Claude MCP クイックスタート ガイドに従ってください:

1. 重要: Homebrew (またはその他のツール) 経由で Node.js をグローバルにインストールします。

2. Claudeデスクトップアプリをインストールする
3. Claude メニューを開き、「設定...」を選択します
4. 左側のサイドバーの「開発者」をクリックし、「設定の編集」をクリックします。
5. claude_desktop_config.jsonファイルが開きます。内容を以下の内容に置き換えます。

重要: /path/to/your/index.ts 、index.ts ファイルへの正確な絶対パスに置き換えてください (例: /Users/username/Code/logseq-mcp-tools/index.ts )

6. ファイルを保存し、Claude Desktopを再起動します。

これで、Claude とチャットして、Logseq データを使用するように依頼できます。

• 「最近の日記のエントリを表示」
• 「先週のメモを要約する」
• 「[トピック]に関連するすべてのページを検索」

カーソルのクロード

カーソル MCP ドキュメントに従ってください:

1. オープンカーソル
2. 設定から新しいMCPサービスを追加する
3. 次のコマンドを入力します。

4. サービスに「Logseq Tools」のような名前を付けます

これで、Logseq データを使用して Cursor で Claude を使用できるようになりました。

Claude in Anthropic API (汎用)

Claude API または CLI ツールを使用する場合、次のコマンドで MCP サービスを追加できます。

利用可能なツール

すべてのページを取得する

Logseq グラフ内のすべてのページのリストを取得します。

ページ取得

特定のページの内容を取得します。

パラメータ:

• pageName : 取得するページの名前

ジャーナルサマリーを取得する

指定された日付範囲のジャーナル エントリの概要を生成します。

パラメータ:

• dateRange : 「今日」、「今週」、「先月」、「今年」などの自然言語の日付範囲。

このツールは次のことを行います。

• 指定された範囲のジャーナルエントリを収集する
• 読みやすいようにフォーマットする
• 参照ページ/概念を抽出して分析する
• 最も頻繁に参照される概念を表示する

ページ作成

Logseq グラフに新しいページを作成します。

パラメータ:

• pageName : 新しいページの名前
• content : (オプション) ページの初期コンテンツ

検索ページ

名前でページを検索します。

パラメータ:

• query : ページを名前でフィルタリングするための検索クエリ

バックリンクを取得する

特定のページを参照するすべてのページを検索します。

パラメータ:

• pageName : バックリンクを検索するページ名

分析グラフ

ナレッジ グラフの包括的な分析を実行します。

パラメータ:

• daysThreshold : (オプション) 「最近の」コンテンツを検索する日数 (デフォルト: 30)

特徴：

• 頻繁に参照されるページを識別します
• 最近の更新を追跡する
• ページクラスターと接続を検出します
• 未完了のタスクを一覧表示します
• 必要な更新の可能性を提案

知識ギャップを見つける

ナレッジ グラフを分析して、潜在的なギャップと改善領域を特定します。

パラメータ:

• minReferenceCount : (オプション) 考慮する最小参照数 (デフォルト: 3)
• includeOrphans : (オプション) 孤立したページを分析に含める (デフォルト: true)

特徴：

• 頻繁に参照される欠落ページを特定します
• 拡張が必要な未開発のページを見つける
• 入ってくるリンクがない孤立したページをリストします
• 要約統計を提供します

ジャーナルパターンを分析する

時間の経過とともにジャーナルエントリのパターンを分析します。

パラメータ:

• timeframe : (オプション) 分析する期間 (例: 「過去 30 日間」、「今年」)
• includeMood : (オプション) 気分パターンが存在する場合は分析します (デフォルト: true)
• includeTopics : (オプション) トピックパターンを分析する (デフォルト: true)

特徴：

• トピックのトレンドと進化
• 気分パターン分析
• 習慣追跡統計
• プロジェクトの進捗状況の追跡

スマートクエリ

Logseq の DataScript 機能を使用して自然言語クエリを実行します。

パラメータ:

• request : 探したいものの自然言語による説明
• includeQuery : (オプション) 生成されたデータログクエリを結果に含める
• advanced : (オプション) 高度な分析機能を使用する

特徴：

• ページの接続と関係
• コンテンツのクラスタリング
• タスク進捗分析
• 概念の進化の追跡

接続を提案

AI を使用してグラフを分析し、興味深いつながりを提案します。

パラメータ:

• minConfidence : (オプション) 提案の最小信頼スコア (0-1、デフォルト: 0.6)
• maxSuggestions : (オプション) 返される提案の最大数 (デフォルト: 10)
• focusArea : (オプション) 提案の焦点となるトピックまたは領域

特徴：

• ページ間の潜在的なつながりを発見する
• 知識統合の機会を特定する
• 最近の興味に基づいて探索パスを提案します
• 提案の信頼度スコアを提供する

発達

サーバーは以下を使用して構築されます:

• モデルコンテキストプロトコル TypeScript SDK
• パラメータ検証のためのZod
• データアクセス用のLogseq HTTP API

新しいツールを拡張するには、 index.tsにserver.tool()定義を追加します。

トラブルシューティング

よくある問題

Node.js バージョン マネージャー (fnm、nvm など)

fnm や nvm などの Node.js バージョン マネージャーを使用している場合、Claude Desktop は PATH が変更されたシェル環境の外部で実行されるため、Node.js バイナリに正しくアクセスできません。

解決策: Homebrew を使用してシステム全体の Node.js をインストールします。

これにより、Claude Desktop を含むすべてのアプリケーションで Node.js が利用できるようになります。

基本的なトラブルシューティング手順

• Logseq が HTTP API を有効にして実行されていることを確認する
• .env内の認証トークンが Logseq に設定されたものと一致することを確認します。
• Claude 構成で index.ts ファイルへのパスが正しいことを確認します。
• ターミナルで直接npx tsx index.ts実行して、動作するか確認してください。

Claude Desktop でログを表示する

ログをリアルタイムで監視します。

より詳細なデバッグ情報については、公式の MCP デバッグ ドキュメントを参照してください。