Livejournal

LiveJournal MCP サーバー

LiveJournal の日記向けローカル MCP サーバーです。従来の LiveJournal XML-RPC API を使用して、エントリーの読み取り、コメントの読み取り、自分の日記への投稿を行い、検索用のローカル SQLite キャッシュを構築します。

機能

• 最近のエントリーを読み取ります。
• itemid でエントリーを 1 件読み取ります。
• 特定の日付のエントリーを読み取ります。
• 最近取得したエントリーを検索します。
• LJ.XMLRPC.getcomments でエントリーのコメントを読み取ります。
• 投稿を作成します。デフォルトでは dry_run: true です。
• 認証が必要な LiveJournal の Web エンドポイント用に ljsession を生成します。
• エントリーを SQLite にキャッシュし、キャッシュしたエントリーをローカルで検索します。

ツール

• check_login
• list_entries
• get_entries_for_date
• search_recent_entries
• get_entry
• sync_entries
• get_entry_comments
• create_post
• generate_session
• cache_recent_entries
• cache_entries_for_date
• cache_synced_entries
• cache_entry
• search_cached_entries
• list_cached_entries
• get_cached_entry
• cache_stats
• clear_cache

必要条件

• Python 3.10+
• LiveJournal アカウント
• MCP 対応クライアント

SQLite は Python に組み込まれています。別途 SQLite をインストールする必要はありません。

ローカルへのインストール

PowerShell：

git clone [email protected]:pavelber/livejournal-mcp.git
Set-Location "livejournal-mcp"
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -e .

macOS/Linux：

git clone [email protected]:pavelber/livejournal-mcp.git
cd livejournal-mcp
python3 -m venv .venv
./.venv/bin/python -m pip install --upgrade pip
./.venv/bin/python -m pip install -e .

環境変数

必須：

• LJ_USERNAME：LiveJournal のユーザー名。
• LJ_PASSWORD：LiveJournal のパスワード。

任意：

• LJ_JOURNAL：対象の日記。デフォルトは LJ_USERNAME です。
• LJ_BASE_URL：デフォルトは https://www.livejournal.com です。
• LJ_CLIENT_VERSION：デフォルトは Cursor-MCP/0.1.0 です。
• LJ_CACHE_PATH：SQLite キャッシュのパス。Windows では、C:\Users\you\AppData\Local\livejournal-mcp\livejournal.sqlite3 のような明示的なパスを指定すると便利です。

認証情報をコミットしないでください。MCP クライアントの設定または環境変数に設定してください。

Cursor

パスと認証情報を置き換えて、これを Cursor MCP 設定に追加します。

Windows：

{
  "mcpServers": {
    "livejournal": {
      "command": "C:\\path\\to\\livejournal-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "livejournal_mcp.server"],
      "env": {
        "LJ_USERNAME": "your_livejournal_username",
        "LJ_PASSWORD": "your_livejournal_password",
        "LJ_JOURNAL": "your_livejournal_username",
        "LJ_CACHE_PATH": "C:\\Users\\you\\AppData\\Local\\livejournal-mcp\\livejournal.sqlite3"
      }
    }
  }
}

macOS/Linux：

{
  "mcpServers": {
    "livejournal": {
      "command": "/path/to/livejournal-mcp/.venv/bin/python",
      "args": ["-m", "livejournal_mcp.server"],
      "env": {
        "LJ_USERNAME": "your_livejournal_username",
        "LJ_PASSWORD": "your_livejournal_password",
        "LJ_JOURNAL": "your_livejournal_username",
        "LJ_CACHE_PATH": "/Users/you/.local/share/livejournal-mcp/livejournal.sqlite3"
      }
    }
  }
}

MCP サーバーを再読み込みするか、Cursor を再起動してください。

Claude Desktop

claude_desktop_config.json を編集します。

Windows：

{
  "mcpServers": {
    "livejournal": {
      "command": "C:\\path\\to\\livejournal-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "livejournal_mcp.server"],
      "env": {
        "LJ_USERNAME": "your_livejournal_username",
        "LJ_PASSWORD": "your_livejournal_password",
        "LJ_JOURNAL": "your_livejournal_username",
        "LJ_CACHE_PATH": "C:\\Users\\you\\AppData\\Local\\livejournal-mcp\\livejournal.sqlite3"
      }
    }
  }
}

macOS/Linux：

{
  "mcpServers": {
    "livejournal": {
      "command": "/path/to/livejournal-mcp/.venv/bin/python",
      "args": ["-m", "livejournal_mcp.server"],
      "env": {
        "LJ_USERNAME": "your_livejournal_username",
        "LJ_PASSWORD": "your_livejournal_password",
        "LJ_JOURNAL": "your_livejournal_username",
        "LJ_CACHE_PATH": "/Users/you/.local/share/livejournal-mcp/livejournal.sqlite3"
      }
    }
  }
}

設定を編集した後、Claude Desktop を再起動してください。

Claude Code

クローンしたリポジトリから、仮想環境の Python を指定する MCP 設定を使ってサーバーを登録します。Claude Code のインストール環境がプロジェクトの MCP 設定ファイルに対応している場合は、上記と同じ mcpServers JSON を使用してください。

デバッグのために、サーバーを直接実行することもできます。

.\.venv\Scripts\python.exe -m livejournal_mcp.server

./.venv/bin/python -m livejournal_mcp.server

Windsurf、Cline、Continue、その他の MCP クライアント

同じ stdio コマンド形式を使用します。

{
  "mcpServers": {
    "livejournal": {
      "command": "/absolute/path/to/python",
      "args": ["-m", "livejournal_mcp.server"],
      "env": {
        "LJ_USERNAME": "your_livejournal_username",
        "LJ_PASSWORD": "your_livejournal_password",
        "LJ_JOURNAL": "your_livejournal_username",
        "LJ_CACHE_PATH": "/absolute/path/to/livejournal.sqlite3"
      }
    }
  }
}

Windows では、仮想環境の実行ファイルを使用します。

C:\path\to\livejournal-mcp\.venv\Scripts\python.exe

macOS/Linux では、以下を使用します。

/path/to/livejournal-mcp/.venv/bin/python

一般的なワークフロー

認証情報を確認します。

Use the livejournal MCP server and run check_login.

最近のエントリーを読み取ります。

Use list_entries with limit 10.

特定の日付のエントリーを読み取ります。

Use get_entries_for_date with date "2026-06-09".

検索可能なキャッシュを構築します。

Use cache_recent_entries with limit 50.
Then use search_cached_entries for "search words".

安全に投稿します。

Use create_post with dry_run true.

create_post はデフォルトで dry_run: true および security: private に設定されています。公開する準備ができた場合にのみ、dry_run: false に設定してください。

注意事項

• LiveJournal XML-RPC は、テキストフィールドを XML-RPC のバイナリ値として返すことがあります。このサーバーは、MCP レスポンスを返す前に通常の文字列に変換します。
• キャッシュにはエントリーのテキストとメタデータが保存され、パスワードは保存されません。
• 過去の全履歴を同期するには、LiveJournal の syncitems ワークフローを段階的に実行し、cache_synced_entries で結果をキャッシュしてください。