Skip to main content

reading-buddy

❖ Communityv1.1.0

Tools · by harrylabsj · added

Local-first WeRead (微信读书) reading companion: syncs bookshelf, reading stats and notes to the local machine and turns them into private reading cards and weekly/monthly reviews through 8 MCP tools, with a built-in fictional demo mode for previews. Engine pinned to an immutable git commit (e5f6673) over npx stdio; Portable Agent Plugins v1 package (mcp.json + skills/), needs Node.js 20+ on PATH. All data stays in PLUGIN_DATA; never posts to WeRead — cards and reviews are local files saved only after user confirmation.

Open in Hermes Desktop
hermes plugins install reading-buddy
Repository ↗Reviewed source @ 4860348 ↗Documentation ↗

README

From the reviewed commit 4860348 ↗; it updates when the author re-pins.

Hermes Plugin: reading-buddy

Portable Agent Plugins v1 package bundling the reading-buddy MCP server (local-first WeRead reading companion: shelf/stats/notes sync, private reading cards and reviews) with a workflow skill (English authoritative + SKILL.zh-CN.md translation variant).

  • mcp.json launches the server via npx -y --allow-git=all --package git+https://github.com/harrylabsj/reading-buddy#e5f6673790acbcd459c7a51cb428a85393c785e3 reading-buddy-mcp — pinned to an immutable commit; the pin is the only update path. Needs Node.js 20+ on PATH.
  • --allow-git=all is required because npm 12 disables git-type fetching by default (allow-git defaults to none); on npm ≤ 11 the flag is a harmless no-op warning and git fetching worked by default.
  • All data (SQLite-free JSON store, cards, reviews) is confined to the plugin data directory via READING_DATA_DIR / READING_CONFIG_DIR; the server runs in its credential-isolated skill auth mode. WEREAD_API_KEY, when set in the user environment, is inherited by the server process; without it the built-in demo mode still works.
  • Server key rb keeps tool line names short: mcp__agent_plugin_reading-buddy_<hash8>__rb__reading_search_books is 63 chars — inside the host's 64-character limit.

Privacy summary

Local-first: no analytics, no posting to WeRead, credentials never leave the machine, and the explicit-save tool (reading_save_card) writes only what the user has reviewed and confirmed.

More by harrylabsj

All 5 plugins by harrylabsj →
eatwise❖ Community

Eatwise (外卖营养教练) — local-first Chinese dietary coach: deterministic meal nutrition reviews, personal daily energy/nutrient targets, and consented on-device profile and meal history through 9 MCP tools over a bundled open food database (TFND + USDA FNDDS). No network, no accounts, no payments; profile schema rejects name/phone/ID/medical fields by design. Engine pinned to an immutable git commit (cbc08f6) over npx stdio; Portable Agent Plugins v1 package (mcp.json + skills/), needs Node.js 22.5+ on PATH. Disclosure — the engine's MCP tool descriptions and error messages are Chinese-only while the skills are English-first.

Tools
good-student❖ Community

Wrong-question diagnosis and study-action loop for parents and students — deterministic local core (SQLite, no cloud), host-model recognition gated by parent confirmation. Portable Agent Plugins v1 package (mcp.json + skills/); good-student MCP server pinned to immutable commit 2469cbb over uvx, with the good-student workflow skill bundled. Needs Python 3.10+ via uv. No credentials required; all data stays on-device and nothing is uploaded.

Tools
kiwi❖ Community★ 0

Source suppliers and negotiate purchases through the Kiwi Buyer MCP server — an open-source A2A commerce runtime (pinned @harrylabsj/kiwi@0.8.0 over npx stdio), with the kiwi-buyer sourcing workflow skill bundled. Portable Agent Plugins v1 package (mcp.json + skills/); needs Node.js/npm on PATH. No credentials required; Kiwi never handles payments.

Tools
wechat-social-assistant❖ Community

Local-first WeChat relationship memory assistant for macOS: captures only what is visible in the WeChat window via system OCR/Accessibility, stores everything in a local SQLite database (0600/0700 permissions, no cloud), and serves contact briefs, follow-up planning, outreach drafts and weekly relationship reports through 32 MCP tools. Engine pinned to the immutable PyPI release wechat-social-assistant==1.5.1 over uvx stdio; Portable Agent Plugins v1 package (mcp.json + skills/), needs uv on PATH. All data confined to PLUGIN_DATA via WSA_ALLOWED_ROOT + path enforcement. Never reads WeChat databases, never injects into WeChat, never sends messages — outreach is drafts for human review only. Disclosure — reads WeChat only by screenshotting/OCR-ing and walking the macOS Accessibility tree of the frontmost window (not WeChat's databases or a bot API), compiles bundled Swift helpers with swiftc into ~/Library/Caches/wechat-social-assistant/bin on first use, and needs Screen Recording (optionally Accessibility) permission for the host terminal; no network egress, never sends messages.

Tools

← Back to the catalog · catalog built Sep 24, 2026