Servidor MCP de PRTS

PyPI npm License: MIT

Idioma / 语言： English | 中文

Inglés

Un servidor MCP para agentes de IA de creación de fans de Arknights. Impulsado por la API de MediaWiki de PRTS Wiki y datos del juego de operadores sincronizados automáticamente, ofrece a cualquier cliente compatible con MCP — Claude Desktop, Claude Code, Chatbox y más — acceso en vivo al lore, archivos de operadores y líneas de voz del mundo de Terra.

Implementaciones

Este repositorio contiene dos implementaciones independientes para diferentes escenarios de despliegue:

Directorio	Lenguaje	Transporte	Caso de uso
`python/`	Python 3.10+	stdio	Claude Desktop / Claude Code local, Docker
`ts/`	TypeScript / Node.js	HTTP con streaming	Servidor autohospedado, acceso HTTP remoto

Herramientas

Ambas implementaciones exponen el mismo conjunto de herramientas:

Herramienta	Descripción
`search_prts(query, limit)`	Busca en la Wiki PRTS por palabra clave, devuelve títulos de artículos coincidentes
`read_prts_page(page_title)`	Obtiene el contenido en texto plano de un artículo de la Wiki PRTS
`get_operator_archives(operator_name)`	Recupera registros de archivos de operador (nombre en chino)
`get_operator_voicelines(operator_name)`	Recupera líneas de voz de operador (nombre en chino)
`get_operator_basic_info(operator_name)`	Recupera el perfil básico del operador: clase, rareza, facción, etiquetas de reclutamiento, talentos (nombre en chino)
`list_story_events(category?)`	Lista eventos de historia; filtro opcional: `main` (historia principal) o `activities`
`list_stories(event_id)`	Lista capítulos de un evento en orden oficial
`read_story(story_key, include_narration)`	Lee el diálogo completo de un solo capítulo
`read_activity(event_id, include_narration, page, page_size)`	Lee la transcripción completa de una actividad, con paginación

Inicio rápido

stdio local (Python / Docker) → ver python/
Servidor HTTP (TypeScript / Docker) → ver ts/

Fuentes de datos

API de PRTS Wiki (https://prts.wiki/api.php) — artículos de lore, información de facciones, entradas de construcción de mundo
ArknightsGameData (Kengxxiao/ArknightsGameData) — archivos de operadores, líneas de voz, estadísticas base
ArknightsStoryJson (3aKHP/ArknightsStoryJson) — diálogo de historia analizado, sincronizado automáticamente desde GitHub Releases (zh_CN.zip)

Los datos del juego residen en el volumen gamedata. Los datos de la historia residen en el volumen storyjson. Ambos se sincronizan automáticamente al iniciar el servidor.

中文

明日方舟同人创作辅助 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，均在服务器启动时自动同步。

Licencia

MIT

prts-mcp

Servidor MCP de PRTS

Inglés

Implementaciones

Herramientas

Inicio rápido

Fuentes de datos

中文

实现版本

工具集

快速开始

数据源

Licencia

Resources

Tools

Latest Blog Posts

MCP directory API