Skip to content

3aKHP/prts-mcp

vts/v2.2.0 Breaking

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

Published 19d 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 deps

Summary

AI summary

Bun becomes the default production runtime and fixes missing bundled data in the Docker image.

Full changelog

Added

  • Added ts/Dockerfile.node as the supported Node.js legacy Docker build path.
  • Added Node legacy npm scripts: start:node, smoke:http:node,
    smoke:http:fixture:node, and dev:bun for Bun-native development.
  • Added an explicit bun.lock/package.json drift check in verify-ts so
    dual-lockfile desync fails fast with an actionable message.
  • Extended build-image-ts to also run on release/** pull requests so the
    default Bun image is validated before shipping to main.

Fixed

  • Fixed the default Docker image shipping without bundled fallback data:
    .dockerignore's *.zip rule stripped the CI-pre-fetched
    data/storyjson/zh_CN.zip (and gamedata archives) from COPY data/ data/,
    leaving the container without offline storyjson fallback. Added negation
    rules so bundled data zips reach the image.

Changed

  • Bun is now the default production runtime for the TypeScript implementation:
    the default ts/Dockerfile, the primary CI verification path (verify-ts),
    and the recommended Docker deployment all run under Bun (verified against
    Bun 1.3.14). Node.js remains a supported legacy/optional runtime via
    the prts-mcp-ts npm bin (so npx prts-mcp-ts stays zero-dependency),
    npm install -g, and the new ts/Dockerfile.node build path. The npm
    publishing path is unchanged (npm publish --provenance, runtime-agnostic).
  • Default npm scripts (start, smoke:http, smoke:http:fixture) now drive
    the Bun entrypoint; start:bun / smoke:bun / smoke:bun:package retained
    verbatim for 2.1.0 backward compatibility.
  • CI matrix flipped: verify-ts is now Bun-based (type-check, build, runtime
    smoke, packed-package smoke); the node:test unit suite moved to a new
    test-ts job; build-image-ts builds the default Bun image; a new
    build-image-ts-node job covers the legacy Node image.

Removed

  • Removed the now-redundant ts/Dockerfile.bun; its content is promoted to
    the default ts/Dockerfile.
  • Removed the verify-ts-bun and build-image-ts-bun CI jobs; their
    coverage is absorbed by the new Bun-default verify-ts and
    build-image-ts.

Install

# Run directly with npx (Node.js entrypoint, zero extra runtime install)
npx prts-mcp-ts

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

# Bun runtime (default production runtime since 2.2.0)
bunx --bun -p [email protected] prts-mcp-ts-bun

The default Docker image (prts-mcp-ts:latest) runs under Bun since 2.2.0;
ts/Dockerfile.node provides the legacy Node.js image.

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

Breaking Changes

  • Removed `ts/Dockerfile.bun` and its content promoted to default `ts/Dockerfile`.
  • Removed CI jobs `verify-ts-bun` and `build-image-ts-bun`; their coverage absorbed by new Bun‑default equivalents.

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]