Logseq MCP Tools

🚀 Logseq MCP ツール

このツールは、AI アシスタントがあなたの Logseq 知識グラフに構造化アクセスできるようにする Model Context Protocol (MCP) サーバーを提供します。

🚀 クイックスタート

Logseq MCP ツールは、Claude などの AI アシスタントがあなたの Logseq 知識ベースと対話できるようにする MCP サーバーを作成します。これにより、AI が Logseq のデータを取得し、活用することが可能になります。

✨ 主な機能

• すべてのページのリストを取得する
• 特定のページの内容を取得する
• 日付範囲が柔軟な日記の要約を生成する
• リンクされたページを抽出し、接続を探索する

📦 インストール

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

# npm を使用する場合
npm install

# yarn を使用する場合
yarn install

# pnpm を使用する場合
pnpm install

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

cp .env.template .env
# .env ファイルで Logseq 認証トークンを編集します。

📚 ドキュメント

設定

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

あなたの認証トークンは Logseq 内で見つけることができます。

1. Logseq を開きます。
2. 「設定」>「機能」で HTTP API を有効にします。
3. 「設定」>「機能」>「HTTP API 認証トークン」で認証トークンを設定します。

使用方法

基本的な使用法

MCP サーバーの起動

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

# npm スクリプトを使用する場合
npm start

# 直接 tsx を使用する場合
npx tsx index.ts

Claude Desktop での設定

1. Claude Desktop の設定を開きます。
2. 新しい MCP ツールを追加します。
   • 名前：logseq-mcp
   • 実行ファイルのパス：/Applications/Claude Desktop.app/Contents/Frameworks/node.js（macOS） または C:\Program Files\Claude Desktop\node.exe（Windows）
   • パラメータ：--port 3000（サーバーのポートに合わせて調整）

開発

サーバーは以下の技術を使用して構築されています。

• 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 で設定されたトークンと一致していることを確認します。
• 設定で index.ts ファイルへのパスが正しいことを確認します。
• ターミナルで直接 npx tsx index.ts を実行し、正常に動作することを確認します。

Claude Desktop でのログの確認

リアルタイムでログを監視するには、以下のコマンドを使用します。

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

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