mcp-pkm-logseq MCP server

mcp-pkm-logseq MCP サーバー

カスタム指示を使用して、Logseq の個人ナレッジ管理システムを操作する MCP サーバーです。

コンポーネント

リソース

• logseq://guide - このナレッジベースの操作方法に関する初期指示

ツール

• get_personal_notes_instructions() - 個人メモツールの使用方法に関する指示を取得します
• get_personal_notes(topics, from_date, to_date) - 指定したトピックのタグが付いた Logseq の個人メモを取得します
• get_todo_list(done, from_date, to_date) - Logseq から ToDo リストを取得します

設定

以下の環境変数を設定できます。

• LOGSEQ_API_KEY：Logseq の認証に使用する API キー（デフォルト："this-is-my-logseq-mcp-token"）
• LOGSEQ_URL：Logseq HTTP API が実行されている URL（デフォルト："http://localhost:12315"）

クイックスタート

インストール

Claude Desktop および Cursor

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uvx",
    "args": [
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}

Claude Code

claude mcp add mcp-pkm-logseq uvx mcp-pkm-logseq

Logseq サーバーを起動する

Logseq の HTTP API は、デスクトップ版 Logseq アプリケーション内で動作するインターフェースです。有効にすると、ローカル HTTP サーバー（デフォルトのポートは 12315）が起動し、Logseq のナレッジベースにプログラムからアクセスできるようになります。この API は、ページやブロックのクエリ、コンテンツの検索、認証済みリクエストによるコンテンツの変更などに対応しています。

Logseq HTTP API サーバーを有効にするには：

1. Logseq を開き、設定（右上）に移動します
2. 「高度な設定」に移動します
3. 「開発者モード」を有効にします
4. 「HTTP API Server」を有効にします
5. API トークンを設定します（MCP サーバーの設定にある LOGSEQ_API_KEY の値と一致させてください）

詳しい手順については、https://logseq-copilot.eindex.me/doc/setup をご覧ください。

MCP PKM Logseq ページを作成する

Logseq のグラフに「MCP PKM Logseq」という名前のページを作成し、AI アシスタント向けのガイドとして使用します。以下の内容を追加してください。

• タグ付けシステムの説明（例：プロジェクト、領域、リソースを表すタグ）
• よく使用するタグと、それぞれが対象とするトピックの一覧
• 情報を整理する際によく使うワークフロー
• ページとブロックの命名規則
• 情報の取得方法に関する希望
• 検索に役立つトピックの組み合わせ例
• 個人のナレッジ管理方法に関する補足情報

AI がユーザーを理解する必要があると判断したときは、このページが表示されます。

開発

ビルドと公開

パッケージを配布できるように準備するには：

1. 依存関係を同期し、ロックファイルを更新します：

uv sync

2. パッケージの配布物をビルドします：

uv build

これにより、ソース配布物とホイール配布物が dist/ ディレクトリに作成されます。

3. PyPI に公開します：

uv publish

注：環境変数またはコマンドフラグで PyPI の認証情報を設定する必要があります。

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名とパスワード：--username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグが難しい場合があります。最適なデバッグ体験を得るには、MCP Inspector の使用を強くおすすめします。

次のコマンドを使い、npm から MCP Inspector を起動できます。

npx @modelcontextprotocol/inspector uv --directory /Users/ronie/MCP/mcp-pkm-logseq run mcp-pkm-logseq

起動すると、Inspector に URL が表示されます。この URL にブラウザーからアクセスして、デバッグを開始できます。

Claude Desktop に開発サーバーの設定を追加する

"mcpServers": {
  "mcp-pkm-logseq": {
    "command": "uv",
    "args": [
      "--directory",
      "/<parent-directories>/mcp-pkm-logseq",
      "run",
      "mcp-pkm-logseq"
    ],
    "env": {
      "LOGSEQ_API_TOKEN": "your-logseq-api-token",
      "LOGSEQ_URL": "http://localhost:12315"
    }
  }
}