3aKHP/prts-mcp

1.7.0 is the final 1.x feature release and the 1.7 LTS baseline. Future 1.7.x updates are limited to compatibility, security, data-sync, and critical bug fixes.

Added

• Story character tracking. Two new tools reuse the existing story search
  index (no new data source): find_character_appearances(name, scope?, max_events?) returns chapters where a character speaks (dialog role
  exact match) or is mentioned (name substring in any line text);
  find_speakers_in(event_id) lists every speaker in an event with dialog
  line counts. Brings the tool surface to 32.

Changed

• Module split: story and server god files. data/story.ts (907 lines) and
  server.ts (1173 lines) were split into focused submodules to meet the
  STYLE.md file-size guideline (~300 lines). story.ts is now a re-export shim
  over storyReader, storySearch, storyMemoir, and storySummary.
  server.ts is now a ~200-line entry point (Express + session management) that
  delegates tool registration to tools/prtsTools, tools/gamedataTools, and
  tools/storyTools, and sync orchestration to startupSync. All public
  symbols are re-exported — no behaviour change.
• Dead code removal in sync. The original GitHub raw file sync path
  (syncRepo, downloadFiles, checkUpstreamSha, syncAll, cacheMetaPath,
  loadCacheMeta, saveCacheMeta, filesPresent) had no external callers and
  has been removed. sync.ts shrank from 700 to 504 lines. The remaining
  exported sync symbols (SyncResult, RepoSpec, GAMEDATA_FILES) are retained
  for the Release-based sync path.

Install

# Run directly (Streamable HTTP on :3000)
npx prts-mcp-ts

# Or install globally
npm install -g [email protected]

MCP endpoint: http://localhost:3000/mcp