PRTS MCP Server

PyPI npm License: MIT

Language / Язык: English | 中文

English

MCP-сервер для ИИ-агентов, создающих фанатский контент по Arknights. Используя API MediaWiki PRTS Wiki и автоматически синхронизируемые игровые данные операторов, он предоставляет любому MCP-совместимому клиенту — Claude Desktop, Claude Code, Chatbox и другим — доступ в реальном времени к лору, архивам операторов и голосовым репликам из мира Терры.

Реализации

Этот репозиторий содержит две независимые реализации для различных сценариев развертывания:

Директория	Язык	Транспорт	Сценарий использования
`python/`	Python 3.10+	stdio	Локальный Claude Desktop / Claude Code, Docker
`ts/`	TypeScript / Node.js	Streamable HTTP	Самостоятельно развернутый сервер, удаленный HTTP-доступ

Инструменты

Обе реализации предоставляют одинаковый набор инструментов:

Инструмент	Описание
`search_prts(query, limit)`	Поиск в PRTS Wiki по ключевым словам, возвращает заголовки подходящих статей
`read_prts_page(page_title)`	Получение текстового содержимого статьи из PRTS Wiki
`get_operator_archives(operator_name)`	Получение архивных записей оператора (на китайском)
`get_operator_voicelines(operator_name)`	Получение голосовых реплик оператора (на китайском)
`get_operator_basic_info(operator_name)`	Получение базового профиля оператора: класс, редкость, фракция, теги найма, таланты (на китайском)
`list_story_events(category?)`	Список сюжетных событий; опциональный фильтр: `main` (основной сюжет) или `activities`
`list_stories(event_id)`	Список глав события в официальном порядке
`read_story(story_key, include_narration)`	Чтение полного диалога для одной главы
`read_activity(event_id, include_narration, page, page_size)`	Чтение полной расшифровки события с поддержкой пагинации

Быстрый старт

Локальный stdio (Python / Docker) → см. python/
HTTP-сервер (TypeScript / Docker) → см. ts/

Источники данных

PRTS Wiki API (https://prts.wiki/api.php) — статьи по лору, информация о фракциях, записи о мире
ArknightsGameData (Kengxxiao/ArknightsGameData) — архивы операторов, голосовые реплики, базовые характеристики
ArknightsStoryJson (3aKHP/ArknightsStoryJson) — разобранные диалоги сюжета, автоматически синхронизируемые из GitHub Releases (zh_CN.zip)

Игровые данные хранятся в томе gamedata. Данные сюжета хранятся в томе storyjson. Оба тома автоматически синхронизируются при запуске сервера.

中文

明日方舟同人创作辅助 MCP Server。通过 PRTS Wiki API 和自动同步的干员数据，为 MCP 客户端（Claude Desktop、Claude Code、Chatbox 等）提供泰拉世界观检索与干员资料查询能力。

实现版本

本仓库包含两个独立实现，适用于不同的部署场景：

目录	语言	传输方式	适用场景
`python/`	Python 3.10+	stdio	Claude Desktop / Claude Code 本地接入、Docker
`ts/`	TypeScript / Node.js	Streamable HTTP	个人服务器部署，供他人通过 HTTP 调用

工具集

两个实现提供相同的工具集：

工具	说明
`search_prts(query, limit)`	关键词搜索 PRTS 维基词条，返回匹配标题列表
`read_prts_page(page_title)`	读取指定词条的纯文本内容
`get_operator_archives(operator_name)`	获取干员档案资料（中文名）
`get_operator_voicelines(operator_name)`	获取干员语音记录（中文名）
`get_operator_basic_info(operator_name)`	获取干员基本信息：职业、稀有度、所属、招募标签、天赋（中文名）
`list_story_events(category?)`	列出剧情活动，可选过滤：`main`（主线）或 `activities`（活动）
`list_stories(event_id)`	列出指定活动的章节（按官方顺序）
`read_story(story_key, include_narration)`	读取单章完整台词
`read_activity(event_id, include_narration, page, page_size)`	读取整个活动的完整剧情，支持分页

快速开始

本地 stdio 接入（Python / Docker） → 见 python/
HTTP 服务部署（TypeScript / Docker） → 见 ts/

数据源

PRTS Wiki API (https://prts.wiki/api.php) — 世界观词条、阵营设定
ArknightsGameData (Kengxxiao/ArknightsGameData) — 干员档案、语音记录、基础信息
ArknightsStoryJson (3aKHP/ArknightsStoryJson) — 剧情台词解析数据，从 GitHub Releases 自动同步（zh_CN.zip）

干员数据存放在 gamedata volume，剧情数据存放在 storyjson volume，均在服务器启动时自动同步。

License

MIT

prts-mcp

PRTS MCP Server

English

Реализации

Инструменты

Быстрый старт

Источники данных

中文

实现版本

工具集

快速开始

数据源

License

Resources

Tools

Latest Blog Posts

MCP directory API