Livejournal

LiveJournal MCP 服务

用于 LiveJournal 日志的本地 MCP 服务。它通过旧版 LiveJournal XML-RPC API 读取日志条目和评论、向自己的日志发布内容，并构建本地 SQLite 缓存以供搜索。

功能

• 读取最近的日志条目。
• 按 itemid 读取单条日志条目。
• 读取特定日期的日志条目。
• 搜索最近获取的日志条目。
• 使用 LJ.XMLRPC.getcomments 读取日志条目评论。
• 创建帖子，默认设置 dry_run: true。
• 为经过身份验证的 LiveJournal 网页端点生成 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 缓存结果。