PRTS MCP 서버

PyPI npm License: MIT

Language / 언어: English | 中文

English

명일방주 팬 창작(同人創作) AI 에이전트를 위한 MCP 서버입니다. PRTS 위키 MediaWiki API와 자동 동기화되는 오퍼레이터 게임 데이터를 기반으로, Claude Desktop, Claude Code, Chatbox 등 MCP 호환 클라이언트에서 테라 세계관의 설정, 오퍼레이터 기록 및 음성 대사에 실시간으로 접근할 수 있게 합니다.

구현체

이 저장소는 서로 다른 배포 시나리오를 위한 두 가지 독립적인 구현을 포함합니다:

디렉토리	언어	전송 방식	사용 사례
`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)`	PRTS 위키 문서의 일반 텍스트 내용 가져오기
`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 위키 API (https://prts.wiki/api.php) — 세계관 문서, 소속 정보, 설정 항목
ArknightsGameData (Kengxxiao/ArknightsGameData) — 오퍼레이터 기록, 음성 대사, 기본 능력치
ArknightsStoryJson (3aKHP/ArknightsStoryJson) — 파싱된 스토리 대사, GitHub 릴리스에서 자동 동기화 (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 서버

English

구현체

도구

빠른 시작

데이터 소스

中文

实现版本

工具集

快速开始

数据源

License

Resources

Tools

Latest Blog Posts

MCP directory API