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.py (916 lines) and
  server.py (914 lines) were split into focused submodules to meet the
  STYLE.md file-size guideline (~300 lines). story.py is now a re-export shim
  over story_reader, story_search, story_memoir, and story_summary.
  server.py is now a ~60-line entry point that delegates tool registration to
  tools_prts, tools_gamedata, and tools_story, and sync orchestration to
  startup_sync. All public symbols are re-exported — no behaviour change.
• Dead code removal in sync. The original GitHub raw file sync path
  (sync_repo, download_files, check_upstream_sha, sync_all) had no
  external callers and has been removed. sync.py shrank from 626 to 479 lines.
  Shared symbols (CacheMeta, SyncResult, RepoSpec, GAMEDATA_FILES)
  are retained for the Release-based sync path.

Install

pip install prts-mcp==1.7.0

Docker

docker pull ghcr.io/3akhp/prts-mcp:1.7.0