Directory

Language

Transport

Use case

python/

Python 3.10+

stdio + Streamable HTTP

Local Claude Desktop / Claude Code (stdio), self-hosted HTTP server

ts/

TypeScript / Node.js + Bun

Streamable HTTP + stdio

Self-hosted HTTP server, local stdio for Claude Desktop / Code

Line

Version

Tools

Status

2.3 (main)

2.3.1

23

Cross-transport parity: both implementations support both stdio and Streamable HTTP (Python gains HTTP, TypeScript gains stdio). Bun remains the default TS runtime.

1.7 LTS (lts/1.7)

1.7.0

32

Stable maintenance line. 1.7.x accepts only compatibility, security, data-sync, and critical bug fixes.

Area

Python

TypeScript

MCP tools

Same 23 public tool names and required parameters (2.0) / 32 on 1.7 LTS

Same 23 (2.0) / 32 on 1.7 LTS

GameData

GAMEDATA_PATH or auto-synced zh_CN-excel.zip

GAMEDATA_PATH or auto-synced zh_CN-excel.zip

Level data

Auto-synced zh_CN-levels.zip beside GameData

Auto-synced zh_CN-levels.zip beside GameData

Story data

STORYJSON_PATH or auto-synced zh_CN.zip

STORYJSON_PATH or auto-synced zh_CN.zip

Bundled fallback data

Docker image only

Docker image and published npm package (PyPI stays data-light)

Tool

Description

search_prts(query, limit)

Search PRTS Wiki by keyword, returns matching article titles

prts_page(page_title, action, ...)

Read a wiki page or its metadata; action ∈ read / sections / categories / links / template

get_operator_archives(name)

Retrieve operator archive records (Chinese name)

get_operator_voicelines(name)

Retrieve operator voice lines (Chinese name)

get_operator_basic_info(name)

Retrieve basic operator profile: class, rarity, faction, recruit tags, talents (Chinese name)

list_story_events(category?)

List story events; optional filter: main (main story) or activities

list_stories(event_id, include_summaries?)

List chapters of an event in official order; include_summaries adds the event-level overview + per-chapter summaries

get_story_summary(story_key)

Single-chapter summary (LLM long summary or official one-liner)

read_story(story_key, include_narration)

Read full dialogue for a single chapter

read_activity(event_id, include_narration, page, page_size)

Read a complete activity's transcript, with pagination

search(scope, pattern, max_results)

Full-text regex search within a data domain: scope ∈ operators / enemies / stages / items

search_stories(pattern, character?, line_type?, context_lines?, max_results?, event_id?)

Full-text regex search across story dialogue, narration, and choice lines with filtering

list_enemies()

List all enemies in the handbook with threat level and description

get_enemy_info(name, stage_id?)

Retrieve full enemy handbook entry by name, or stage-specific stats when stage_id is provided

get_stage_enemies(stage_id)

List enemies actually spawned in a stage, with stage-specific levels and combat stats

get_enemy_appearances(name, limit?, offset?)

Reverse lookup stages where an enemy actually spawns

list_stages(chapter?, type?, limit?, offset?)

List stages with optional zone and stage-type filters

get_stage_info(stage_id)

Retrieve detailed stage information by stage ID

list_items(category?, limit?, offset?)

List items/materials from item_table.json with optional category filtering

get_item_info(name)

Retrieve item/material details, usage, obtain methods, drops, production, and shop links

get_operator_memoirs(name)

Resolve an operator's memoir (干员密录) story keys for follow-up read_story calls

find_character_appearances(name, scope?, max_events?)

Find chapters/events where a character speaks (dialog) or is mentioned (name substring)

find_speakers_in(event_id)

List every speaker in an event with dialog line counts

目录

语言

传输方式

适用场景

python/

Python 3.10+

stdio + Streamable HTTP

Claude Desktop / Claude Code 本地接入（stdio）、自建 HTTP 服务

ts/

TypeScript / Node.js + Bun

Streamable HTTP + stdio

自建 HTTP 服务、Claude Desktop / Claude Code 本地接入（stdio）

版本线

版本

工具数

状态

2.3（main）

2.3.1

23

Cross-transport parity：双端均支持 stdio + Streamable HTTP（Python 新增 HTTP，TypeScript 新增 stdio）。Bun 仍是 TS 默认运行时。

1.7 LTS（lts/1.7）

1.7.0

32

稳定维护线。1.7.x 仅接受兼容性、安全性、数据同步和关键缺陷修复。

范围

Python

TypeScript

MCP 工具

相同的 23 个工具名和必填参数（2.0）/ 1.7 LTS 为 32 个

相同的 23 个（2.0）/ 1.7 LTS 为 32 个

干员数据

GAMEDATA_PATH 或自动同步 zh_CN-excel.zip

GAMEDATA_PATH 或自动同步 zh_CN-excel.zip

关卡战斗数据

自动同步与 GameData 并列的 zh_CN-levels.zip

自动同步与 GameData 并列的 zh_CN-levels.zip

剧情数据

STORYJSON_PATH 或自动同步 zh_CN.zip

STORYJSON_PATH 或自动同步 zh_CN.zip

bundled 兜底数据

Docker 镜像

Docker 镜像和正式 npm 包（PyPI 保持轻量）

工具

说明

search_prts(query, limit)

关键词搜索 PRTS 维基词条，返回匹配标题列表

prts_page(page_title, action, ...)

读取词条正文或元数据；action ∈ read / sections / categories / links / template

get_operator_archives(name)

获取干员档案资料（中文名）

get_operator_voicelines(name)

获取干员语音记录（中文名）

get_operator_basic_info(name)

获取干员基本信息：职业、稀有度、所属、招募标签、天赋（中文名）

list_story_events(category?)

列出剧情活动，可选过滤：main（主线）或 activities（活动）

list_stories(event_id, include_summaries?)

列出指定活动的章节（按官方顺序）；include_summaries 附活动级概览 + 每章梗概

get_story_summary(story_key)

获取单章梗概（LLM 长摘要或官方一句话简介）

read_story(story_key, include_narration)

读取单章完整台词

read_activity(event_id, include_narration, page, page_size)

读取整个活动的完整剧情，支持分页

search(scope, pattern, max_results)

在指定数据域执行全文正则搜索：scope ∈ operators / enemies / stages / items

search_stories(pattern, character?, line_type?, context_lines?, max_results?, event_id?)

在剧情台词中执行全文正则搜索，支持按角色和台词类型过滤

list_enemies()

列出敌方图鉴中所有敌人及其威胁等级和描述

get_enemy_info(name, stage_id?)

获取指定敌人的详细图鉴资料；传入 stage_id 时返回关卡级数值

get_stage_enemies(stage_id)

获取指定关卡实际出场敌人及关卡级等级/战斗属性

get_enemy_appearances(name, limit?, offset?)

反查指定敌人实际出现在哪些关卡

list_stages(chapter?, type?, limit?, offset?)

列出关卡，支持按章节/区域和关卡类型过滤

get_stage_info(stage_id)

根据关卡 ID 获取关卡详细信息

list_items(category?, limit?, offset?)

列出物品/材料，支持按类别过滤和分页

get_item_info(name)

获取物品/材料详情、用途、获取方式、掉落、基建产出和商店关联

get_operator_memoirs(name)

解析干员密录的 story_key，便于后续 read_story 调用

find_character_appearances(name, scope?, max_events?)

查找角色在哪些章节/活动中开口（对话）或被提及（名字子串）

find_speakers_in(event_id)

列出指定活动中所有发言角色及其对话行数