Skip to content

3aKHP/prts-mcp

v0.2.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 1mo MCP Data & Storage
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-agent anthropic arknights claude fanfiction game-data
+5 more
mcp mcp-server model-context-protocol prts prts-wiki

Affected surfaces

auth

Summary

AI summary

Default data flow now prefers auto‑sync of minimal operator files over manual packaging.

Full changelog

Added

  • GitHub-backed operator data sync via src/prts_mcp/data/sync.py, including upstream SHA checks, TTL-based cache reuse, atomic file replacement, and offline fallback behavior
  • scripts/fetch_gamedata.py for prewarming the minimal operator dataset in CI, local development, and image-build workflows
  • Optional GITHUB_TOKEN support for GitHub API requests to reduce anonymous rate-limit risk
  • Docker/CI smoke-test coverage for the containerized MCP server, including a protocol-correct MCP initialize handshake
  • Contributor-facing repository policy in CONTRIBUTING.md

Changed

  • Default data flow now prefers auto-sync of the minimal required operator files instead of relying on local_repo.jsonc or manual packaging as the primary workflow
  • Installed-path data resolution now falls back more safely across Docker, editable installs, and user data directories
  • Server startup no longer blocks the main thread on data sync; startup refresh runs in a background daemon thread
  • CI now validates the newer data/bootstrap path and image workflow more explicitly
  • README.md and CONTRIBUTING.md updated to remove local_repo.jsonc / local_repo.example.jsonc references and reflect the auto-sync-first workflow
  • docs/deployment.md rewritten to describe auto-sync as the default; now provides parallel Windows (PowerShell) and Linux/macOS examples for volume mounts; environment-variable reference table updated with GITHUB_TOKEN and PRTS_MCP_ROOT
  • .mcp.example.json simplified to the default auto-sync invocation; local-path override examples moved to docs/deployment.md
  • .env.example updated to reflect current env var set with blank defaults and GITHUB_TOKEN entry
  • docker-compose.override.example.yml cleaned up: removed unused STORYJSON_PATH volume, added GITHUB_TOKEN passthrough, added Windows path format comment

Fixed

  • local_repo.jsonc re-added to .gitignore; the previous refactor had inadvertently removed it, leaving the file exposed to accidental staging

Removed

  • local_repo.example.jsonc deleted — the file had no reader code and was no longer referenced by any documentation or tooling

Deprecated

  • scripts/package_operator_data.py is retained only as a compatibility path and is no longer the recommended primary workflow

Docker image

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

Breaking Changes

  • Removed `local_repo.example.jsonc` file.
  • Default data flow changed to auto‑sync minimal operator files instead of relying on `local_repo.jsonc` or manual packaging.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track 3aKHP/prts-mcp

Get notified when new releases ship.

Sign up free

About 3aKHP/prts-mcp

MCP Server for Arknights, querying the PRTS Wiki API and serving auto-synced operator archives and voice lines from game data. Designed for fan-creation (同人創作) AI agents. Python (stdio/Docker) and TypeScript (Streamable HTTP) implementations.

All releases →

Related context

Earlier breaking changes

  • vts/v1.0.0 Public tool surface frozen; 9 MCP tool names, parameters, and response formats locked.

Beta — feedback welcome: [email protected]