Logseq MCP Tools

Logseq MCP Tools

AI アシスタントが Logseq ナレッジグラフに構造化された形でアクセスできるようにする、Model Context Protocol（MCP）サーバーです。

概要

このプロジェクトでは、Claude などの AI アシスタントが Logseq ナレッジベースを操作できる MCP サーバーを作成します。次のツールを提供します。

• すべてのページの一覧を取得する
• 特定のページのコンテンツを取得する
• 柔軟な日付範囲でジャーナルの要約を生成する
• リンクされたページを抽出し、つながりを調べる

インストール

Smithery 経由でのインストール

Smithery 経由で Logseq Tools を Claude Desktop に自動インストールするには、次の手順に従います。

npx -y @smithery/cli install @joelhooks/logseq-mcp-tools --client claude

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

# Using npm
npm install

# Using yarn
yarn install

# Using pnpm
pnpm install

3. 環境変数のテンプレートをコピーし、Logseq トークンを設定します。

cp .env.template .env
# Edit .env with your Logseq authentication token

設定

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

Logseq 認証トークンは、次の手順で確認できます。

1. Logseq を開きます
2. Settings > Features > Enable HTTP API で HTTP API を有効にします
3. Settings > Features > HTTP API Authentication Token で認証トークンを設定します

使用方法

MCP サーバーの起動

サーバーは次のコマンドで起動できます。

# Using the npm script
npm start

# Or directly with tsx
npx tsx index.ts

Claude との接続

Claude Desktop

Claude MCP クイックスタートガイドに従います。

1. 重要：Homebrew などを使って Node.js をグローバルにインストールします。

brew install node

2. Claude デスクトップアプリをインストールします
3. Claude メニューを開き、「Settings...」を選択します
4. 左側のサイドバーで「Developer」をクリックし、「Edit Config」をクリックします
5. claude_desktop_config.json ファイルが開きます。その内容を次のように置き換えます。

{
  "mcpServers": {
    "logseq": {
      "command": "npx",
      "args": [
        "tsx",
        "/path/to/your/index.ts"
      ]
    }
  }
}

重要： /path/to/your/index.ts を、index.ts ファイルの正確な絶対パス（例：/Users/username/Code/logseq-mcp-tools/index.ts）に置き換えます。

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

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

• 「最近のジャーナルエントリを見せて」
• 「先週のメモを要約して」
• 「[トピック] に関連するページをすべて探して」

Cursor の Claude

Cursor MCP ドキュメントに従います。

1. Cursor を開きます
2. 設定から新しい MCP サービスを追加します
3. 次のコマンドを入力します。

npx tsx "/path/to/index.ts"

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

これで Cursor の Claude を Logseq のデータと一緒に使用できます。

Anthropic API の Claude（汎用）

Claude API または CLI ツールを使用する場合、次のようにして MCP サービスを追加できます。

claude mcp add "logseq" npx tsx "/path/to/index.ts"

Jetbrains Junie のセットアップ

このプロジェクトを JetBrains Junie で実行するには、次の手順に従います。

Docker イメージをビルドします。

docker build -t logseq-mcp .
# run in project root

次に、以下の設定を Junie の MCP 設定に追加します。

    "logseq": {
      "command": "c:\\Program Files\\Docker\\Docker\\resources\\bin\\docker.exe",
      "args": [
        "run",
        "-i",
        "--rm",
        "--network=host",
        "-e",
        "LOGSEQ_TOKEN=<Your Token>",
        "-e",
        "LOGSEQ_HOST=host.docker.internal",
        "logseq-mcp"
      ]
    }

利用可能なツール

getAllPages

Logseq グラフ内のすべてのページの一覧を取得します。

getPage

特定のページのコンテンツを取得します。

パラメーター：

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

getJournalSummary

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

パラメーター：

• dateRange：「今日」、「今週」、「先月」、「今年」などの自然言語による日付範囲

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

• 指定した範囲内のジャーナルエントリを収集します
• 読みやすい形式に整えます
• 参照されているページや概念を抽出して分析します
• 参照頻度が最も高い概念を表示します

createPage

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

パラメーター：

• pageName：新しいページの名前
• content：ページの初期コンテンツ（任意）

searchPages

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

パラメーター：

• query：ページ名で絞り込むための検索クエリ

getBacklinks

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

パラメーター：

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

analyzeGraph

ナレッジグラフを包括的に分析します。

パラメーター：

• daysThreshold：（任意）「最近」のコンテンツを遡って検索する日数（デフォルト：30）

機能：

• 頻繁に参照されているページを特定します
• 最近の更新を追跡します
• ページのクラスターとつながりを検出します
• 未完了のタスクを一覧表示します
• 必要と思われる更新を提案します

findKnowledgeGaps

ナレッジグラフを分析し、潜在的な不足や改善が必要な領域を特定します。

パラメーター：

• minReferenceCount：（任意）対象とする参照数の最小値（デフォルト：3）
• includeOrphans：（任意）分析に孤立ページを含めます（デフォルト：true）

機能：

• 頻繁に参照されている未作成のページを特定します
• 拡充が必要な、内容が不十分なページを見つけます
• 被リンクがない孤立ページを一覧表示します
• 概要統計を表示します

analyzeJournalPatterns

日記の記録を分析し、時間の経過に伴うパターンを特定します。

パラメーター：

• timeframe：（任意）分析する期間（例：「過去30日間」、「今年」）
• includeMood：（任意）記録がある場合、気分のパターンを分析します（デフォルト：true）
• includeTopics：（任意）トピックのパターンを分析します（デフォルト：true）

機能：

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

smartQuery

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

パラメーター：

• request：検索したい内容を自然言語で記述します
• includeQuery：（任意）生成された Datalog クエリを結果に含めます
• advanced：（任意）高度な分析機能を使用します

機能：

• ページのつながりと関係
• コンテンツのクラスター化
• タスクの進捗分析
• 概念の変遷の追跡

suggestConnections

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

パラメーター：

• minConfidence：（任意）提案の信頼度スコアの最小値（0～1、デフォルト：0.6）
• maxSuggestions：（任意）返す提案の最大数（デフォルト：10）
• focusArea：（任意）提案の中心とするトピックまたは領域

機能：

• ページ間に潜在するつながりを見つけます
• 知識を統合する機会を特定します
• 最近の関心に基づいて探索経路を提案します
• 提案の信頼度スコアを表示します

開発

サーバーの構築には、以下を使用しています。

• Model Context Protocol TypeScript SDK
• パラメーターの検証に Zod
• データアクセスに Logseq HTTP API

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

トラブルシューティング

よくある問題

Node.js のバージョン管理ツール（fnm、nvm など）

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

解決方法：Homebrew を使用して、システム全体で使える Node.js をインストールします。

brew install node

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

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

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

Claude Desktop のログを表示する

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

# macOS
tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

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