3aKHP/prts-mcp

vts/v1.0.0 Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 22d MCP Data & Storage

View tool

✓ 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

ReleasePort's take

Light signal

editorial:auto 13d

prts-mcp v1.0.0 locks the public tool surface, freezing 9 MCP tool names, parameters, and response formats. Breaking change: `include_narration=false` now excludes unnamed speaker lines; migration guide provided for 0.x upgrades.

Why it matters: Migrate from prts-mcp 0.x to v1.0.0 for API stability. Test `include_narration` behavior changes in dev before upgrading; migration guide included.

Summary

AI summary

Public tool surface frozen and include_narration=false now also excludes unnamed speaker lines.

Changes in this release

Type	Severity	Summary	CVE
Breaking	Medium	Public tool surface frozen; 9 MCP tool names, parameters, and response formats locked. Public tool surface frozen; 9 MCP tool names, parameters, and response formats locked. Source: llm_adapter@2026-05-21 Confidence: high	—
Feature	Medium	Migration guide expanded with behavioral changes from 0.x releases. Migration guide expanded with behavioral changes from 0.x releases. Source: llm_adapter@2026-05-21 Confidence: low	—
Dependency	Medium	CI downloads storyjson `zh_CN.zip` fixture before Python tests. CI downloads storyjson `zh_CN.zip` fixture before Python tests. Source: llm_adapter@2026-05-21 Confidence: low	—
Bugfix	Medium	`include_narration=false` now excludes unnamed speaker lines in `readStory`. `include_narration=false` now excludes unnamed speaker lines in `readStory`. Source: llm_adapter@2026-05-21 Confidence: low	—

Full changelog

Changed

Public tool surface frozen. The 9 MCP tool names, required parameters,
and response formats are locked. Automated tests enforce this in CI for
both Python and TypeScript.
CI now downloads the storyjson zh_CN.zip fixture before running Python
tests so story integration tests are no longer silently skipped.
Migration guide expanded with behavioral changes from 0.x: Release archive
sync, archives/ cache metadata, local_repo.jsonc removal, and
story_review_table.json as a required gamedata file.

Fixed

include_narration=false in readStory now also excludes unnamed speaker
lines (stage directions displayed as （旁白）：text) instead of only
excluding type="narration" sticker/subtitle/animation lines.

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

Breaking Changes

Public tool surface (9 MCP names, required parameters, response formats) locked; no further changes allowed.

View diff on GitHub

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

Share on X Share on Bluesky

Track 3aKHP/prts-mcp

Get notified when new releases ship.

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 →