prts-mcp-ts 0.1.0

package/README.md

@@ -0,0 +1,76 @@
+# PRTS MCP Server — TypeScript 实现
+
+明日方舟同人创作辅助 MCP Server，TypeScript 版本。通过 **Streamable HTTP 传输**（单端点 `/mcp`）对外提供服务，适合部署在个人服务器或云环境，供他人通过 HTTP 接入。
+
+提供工具集：`search_prts` / `read_prts_page` / `get_operator_archives` / `get_operator_voicelines`
+
+---
+
+## 快速开始（Docker）
+
+```bash
+# 从仓库根目录构建（需先预置数据，详见下方）
+docker build -f ts/Dockerfile -t prts-mcp-ts .
+
+# 运行（named volume 持久化游戏数据，推荐）
+docker run -d -p 3000:3000 -v prts-mcp-ts-data:/data/gamedata prts-mcp-ts
+```
+
+服务启动后 MCP 端点为 `http://<host>:3000/mcp`，健康检查端点为 `http://<host>:3000/health`。
+
+### 接入 MCP 客户端
+
+在客户端配置中选择 **Streamable HTTP** 传输类型，端点填写：
+
+```
+http://localhost:3000/mcp
+```
+
+---
+
+## 快速试用（npx）
+
+无需克隆仓库，直接运行：
+
+```bash
+npx prts-mcp-ts
+```
+
+服务启动后 MCP 端点为 `http://localhost:3000/mcp`。
+
+## 本地开发
+
+```bash
+cd ts
+npm install
+npm run dev       # tsx 直接运行，支持热重载
+npm run build     # 编译到 dist/
+npm start         # 运行编译后的版本
+```
+
+---
+
+## 数据机制
+
+服务器启动时自动从 [ArknightsGameData](https://github.com/Kengxxiao/ArknightsGameData) 同步干员数据，结果缓存至挂载的 volume（`/data/gamedata`）。镜像内置 bundled 数据作为网络不可用时的离线保底。
+
+---
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|------|--------|------|
+| `PORT` | `3000` | 监听端口 |
+| `HOST` | `0.0.0.0` | 监听地址 |
+| `GAMEDATA_PATH` | 未设置 | 设置后指向自定义数据目录，**auto-sync 被禁用** |
+| `GITHUB_TOKEN` | 空 | 用于提高 GitHub API 限额，降低限流风险 |
+
+---
+
+## 预置 bundled 数据（本地构建推荐）
+
+```bash
+pip install -e python/
+python python/scripts/fetch_gamedata.py
+docker build -f ts/Dockerfile -t prts-mcp-ts .
+```

package/dist/api/prtsWiki.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PRTS Wiki API client with rate limiting.
+ * Mirrors python/src/prts_mcp/api/prts_wiki.py.
+ */
+export interface SearchResult {
+    title: string;
+    snippet: string;
+}
+/**
+ * Search PRTS wiki and return a list of { title, snippet } objects.
+ * Mirrors prts_wiki.search_prts().
+ */
+export declare function searchPrts(query: string, limit?: number): Promise<SearchResult[]>;
+/**
+ * Fetch plain-text extract for a PRTS wiki page.
+ * Mirrors prts_wiki.read_page().
+ */
+export declare function readPage(title: string): Promise<string>;

package/dist/api/prtsWiki.js

@@ -0,0 +1,79 @@
+/**
+ * PRTS Wiki API client with rate limiting.
+ * Mirrors python/src/prts_mcp/api/prts_wiki.py.
+ */
+import { PRTS_API_ENDPOINT, RATE_LIMIT_INTERVAL, USER_AGENT, } from "../config.js";
+import { stripWikitext } from "../utils/sanitizer.js";
+// ---------------------------------------------------------------------------
+// Rate limiter
+// ---------------------------------------------------------------------------
+// Tracks the earliest time the next request is allowed to fire.
+// Updated immediately (before any await) so concurrent callers each
+// reserve a distinct slot — avoiding the check-then-act race.
+let nextAllowedTime = 0;
+async function rateLimit() {
+    const now = Date.now();
+    const intervalMs = RATE_LIMIT_INTERVAL * 1000;
+    // Reserve a slot: advance nextAllowedTime by one interval.
+    const slot = Math.max(now, nextAllowedTime);
+    nextAllowedTime = slot + intervalMs;
+    const waitMs = slot - now;
+    if (waitMs > 0) {
+        await new Promise((resolve) => setTimeout(resolve, waitMs));
+    }
+}
+// ---------------------------------------------------------------------------
+// API helpers
+// ---------------------------------------------------------------------------
+const DEFAULT_HEADERS = { "User-Agent": USER_AGENT };
+async function prtsGet(params) {
+    await rateLimit();
+    const url = new URL(PRTS_API_ENDPOINT);
+    for (const [k, v] of Object.entries(params)) {
+        url.searchParams.set(k, String(v));
+    }
+    const res = await fetch(url.toString(), {
+        headers: DEFAULT_HEADERS,
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok)
+        throw new Error(`PRTS API error: HTTP ${res.status}`);
+    return res.json();
+}
+/**
+ * Search PRTS wiki and return a list of { title, snippet } objects.
+ * Mirrors prts_wiki.search_prts().
+ */
+export async function searchPrts(query, limit = 5) {
+    const data = (await prtsGet({
+        action: "query",
+        list: "search",
+        srsearch: query,
+        srlimit: limit,
+        format: "json",
+    }));
+    return (data.query?.search ?? []).map((item) => ({
+        title: item.title,
+        snippet: stripWikitext(item.snippet ?? ""),
+    }));
+}
+/**
+ * Fetch plain-text extract for a PRTS wiki page.
+ * Mirrors prts_wiki.read_page().
+ */
+export async function readPage(title) {
+    const data = (await prtsGet({
+        action: "query",
+        titles: title,
+        prop: "extracts",
+        explaintext: "1",
+        format: "json",
+    }));
+    const pages = data.query?.pages ?? {};
+    for (const page of Object.values(pages)) {
+        if (page.extract)
+            return stripWikitext(page.extract);
+    }
+    return `页面 '${title}' 未找到或内容为空。`;
+}
+//# sourceMappingURL=prtsWiki.js.map

package/dist/api/prtsWiki.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prtsWiki.js","sourceRoot":"","sources":["../../src/api/prtsWiki.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Runtime configuration for PRTS-MCP (TypeScript).
+ *
+ * Path design mirrors python/src/prts_mcp/config.py:
+ *
+ *   DEFAULT_GAMEDATA_PATH — where auto-sync writes data at runtime.
+ *     Priority (highest → lowest):
+ *     1. GAMEDATA_PATH env var  — user-supplied; auto-sync is DISABLED.
+ *     2. /data/gamedata         — fixed volume mount-point inside Docker
+ *                                 (detected via PRTS_MCP_ROOT == "/app").
+ *     3. Per-user data dir      — ~/.local/share/prts-mcp/ (Linux/macOS)
+ *                                 or %LOCALAPPDATA%\prts-mcp\ (Windows).
+ *
+ *   BUNDLED_GAMEDATA_PATH — read-only fallback baked into the Docker image.
+ *     Always /app/data/gamedata inside the container.
+ */
+export declare const PRTS_API_ENDPOINT = "https://prts.wiki/api.php";
+export declare const USER_AGENT = "PRTS-MCP-Bot/0.1 (Arknights fan-creation helper)";
+/** Minimum seconds between PRTS API requests. */
+export declare const RATE_LIMIT_INTERVAL = 1.5;
+/** Bundled data baked into the image at build time. */
+export declare const BUNDLED_GAMEDATA_PATH = "/app/data/gamedata";
+export declare const DEFAULT_GAMEDATA_PATH: string;
+export interface Config {
+    /** Sync write target (volume or user dir). */
+    gamedataPath: string;
+    /** True when GAMEDATA_PATH was explicitly set by the user. */
+    isCustomGamedata: boolean;
+    /** Primary excel path (under gamedataPath). */
+    excelPath: string;
+    /** Bundled excel path (read-only fallback, only exists inside Docker). */
+    bundledExcelPath: string;
+    /**
+     * The path operator.ts should actually read from.
+     * Prefers the sync path when complete; falls back to bundled data; null
+     * when neither location has data.
+     */
+    effectiveExcelPath: string | null;
+}
+export declare function hasOperatorData(cfg: Config): boolean;
+export declare function loadConfig(): Config;

package/dist/config.js

@@ -0,0 +1,81 @@
+/**
+ * Runtime configuration for PRTS-MCP (TypeScript).
+ *
+ * Path design mirrors python/src/prts_mcp/config.py:
+ *
+ *   DEFAULT_GAMEDATA_PATH — where auto-sync writes data at runtime.
+ *     Priority (highest → lowest):
+ *     1. GAMEDATA_PATH env var  — user-supplied; auto-sync is DISABLED.
+ *     2. /data/gamedata         — fixed volume mount-point inside Docker
+ *                                 (detected via PRTS_MCP_ROOT == "/app").
+ *     3. Per-user data dir      — ~/.local/share/prts-mcp/ (Linux/macOS)
+ *                                 or %LOCALAPPDATA%\prts-mcp\ (Windows).
+ *
+ *   BUNDLED_GAMEDATA_PATH — read-only fallback baked into the Docker image.
+ *     Always /app/data/gamedata inside the container.
+ */
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const PRTS_API_ENDPOINT = "https://prts.wiki/api.php";
+export const USER_AGENT = "PRTS-MCP-Bot/0.1 (Arknights fan-creation helper)";
+/** Minimum seconds between PRTS API requests. */
+export const RATE_LIMIT_INTERVAL = 1.5;
+const REQUIRED_OPERATOR_FILES = [
+    "character_table.json",
+    "handbook_info_table.json",
+    "charword_table.json",
+];
+/** Fixed volume mount-point inside Docker. */
+const DOCKER_VOLUME_PATH = "/data/gamedata";
+/** Bundled data baked into the image at build time. */
+export const BUNDLED_GAMEDATA_PATH = "/app/data/gamedata";
+// ---------------------------------------------------------------------------
+// Path resolution
+// ---------------------------------------------------------------------------
+function resolveDefaultGamedataPath() {
+    // Inside Docker (PRTS_MCP_ROOT == "/app") use the fixed volume path.
+    if (process.env["PRTS_MCP_ROOT"] === "/app")
+        return DOCKER_VOLUME_PATH;
+    // Outside Docker: per-user data directory.
+    if (process.platform === "win32") {
+        const base = process.env["LOCALAPPDATA"] ?? join(homedir(), "AppData", "Local");
+        return join(base, "prts-mcp", "gamedata");
+    }
+    const base = process.env["XDG_DATA_HOME"] ?? join(homedir(), ".local", "share");
+    return join(base, "prts-mcp", "gamedata");
+}
+export const DEFAULT_GAMEDATA_PATH = resolveDefaultGamedataPath();
+function excelPath(gamedataRoot) {
+    return join(gamedataRoot, "zh_CN", "gamedata", "excel");
+}
+function filesComplete(excel) {
+    return REQUIRED_OPERATOR_FILES.every((f) => existsSync(join(excel, f)));
+}
+export function hasOperatorData(cfg) {
+    return cfg.effectiveExcelPath !== null;
+}
+export function loadConfig() {
+    const isCustomGamedata = "GAMEDATA_PATH" in process.env;
+    const gamedataPath = isCustomGamedata
+        ? process.env["GAMEDATA_PATH"]
+        : DEFAULT_GAMEDATA_PATH;
+    const ep = excelPath(gamedataPath);
+    const bep = excelPath(BUNDLED_GAMEDATA_PATH);
+    let effectiveExcelPath = null;
+    if (filesComplete(ep))
+        effectiveExcelPath = ep;
+    else if (filesComplete(bep))
+        effectiveExcelPath = bep;
+    return {
+        gamedataPath,
+        isCustomGamedata,
+        excelPath: ep,
+        bundledExcelPath: bep,
+        effectiveExcelPath,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,kDAAkD,CAAC;AAC7E,iDAAiD;AACjD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC,MAAM,uBAAuB,GAAG;IAC9B,sBAAsB;IACtB,0BAA0B;IAC1B,qBAAqB;CACb,CAAC;AAEX,8CAA8C;AAC9C,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAE1D,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAS,0BAA0B;IACjC,qEAAqE;IACrE,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM;QAAE,OAAO,kBAAkB,CAAC;IAEvE,2CAA2C;IAC3C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,GACR,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,IAAI,GACR,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,EAAE,CAAC;AAElE,SAAS,SAAS,CAAC,YAAoB;IACrC,OAAO,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC;AAuBD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,kBAAkB,KAAK,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,gBAAgB,GAAG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IACxD,MAAM,YAAY,GAAG,gBAAgB;QACnC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAE;QAC/B,CAAC,CAAC,qBAAqB,CAAC;IAE1B,MAAM,EAAE,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,SAAS,CAAC,qBAAqB,CAAC,CAAC;IAE7C,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAC7C,IAAI,aAAa,CAAC,EAAE,CAAC;QAAE,kBAAkB,GAAG,EAAE,CAAC;SAC1C,IAAI,aAAa,CAAC,GAAG,CAAC;QAAE,kBAAkB,GAAG,GAAG,CAAC;IAEtD,OAAO;QACL,YAAY;QACZ,gBAAgB;QAChB,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,GAAG;QACrB,kBAAkB;KACnB,CAAC;AACJ,CAAC"}

package/dist/data/operator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Operator data reader — loads and formats game data from local JSON files.
+ * Mirrors python/src/prts_mcp/data/operator.py.
+ *
+ * JSON files are large (character_table.json ~4 MB) so they are loaded
+ * lazily on first call and cached in module-level variables.
+ */
+/** Return formatted archive text for an operator by Chinese name. */
+export declare function getOperatorArchives(name: string): string;
+/** Return formatted voice-line text for an operator by Chinese name. */
+export declare function getOperatorVoicelines(name: string): string;

package/dist/data/operator.js

@@ -0,0 +1,146 @@
+/**
+ * Operator data reader — loads and formats game data from local JSON files.
+ * Mirrors python/src/prts_mcp/data/operator.py.
+ *
+ * JSON files are large (character_table.json ~4 MB) so they are loaded
+ * lazily on first call and cached in module-level variables.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { loadConfig, hasOperatorData } from "../config.js";
+let _characterTable = null;
+let _handbookTable = null;
+let _charwordTable = null;
+let _nameToId = null;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function missingDataMessage() {
+    const cfg = loadConfig();
+    return ("干员数据暂不可用。" +
+        "容器启动时的 auto-sync 可能仍在进行中，请稍后重试；" +
+        "若持续出现此提示，请检查网络连接或提供 GITHUB_TOKEN 以降低限速风险。" +
+        `（当前同步目标路径：${cfg.excelPath}）`);
+}
+function loadJson(filePath) {
+    if (!existsSync(filePath)) {
+        throw new Error(`干员数据文件不存在：${filePath}。` +
+            "数据目录可能为空，或挂载路径有误（GAMEDATA_PATH 应指向 ArknightsGameData 仓库根目录）。");
+    }
+    return JSON.parse(readFileSync(filePath, "utf-8"));
+}
+function excelFile(name) {
+    const ep = loadConfig().effectiveExcelPath;
+    if (ep === null)
+        throw new Error("effectiveExcelPath is null");
+    return join(ep, name);
+}
+function getCharacterTable() {
+    if (_characterTable === null) {
+        _characterTable = loadJson(excelFile("character_table.json"));
+    }
+    if (_characterTable === undefined)
+        throw new Error("character_table failed");
+    return _characterTable;
+}
+function getHandbookTable() {
+    if (_handbookTable === null) {
+        _handbookTable = loadJson(excelFile("handbook_info_table.json"));
+    }
+    if (_handbookTable === undefined)
+        throw new Error("handbook_table failed");
+    return _handbookTable;
+}
+function getCharwordTable() {
+    if (_charwordTable === null) {
+        _charwordTable = loadJson(excelFile("charword_table.json"));
+    }
+    if (_charwordTable === undefined)
+        throw new Error("charword_table failed");
+    return _charwordTable;
+}
+function resolveCharId(name) {
+    if (_nameToId === null) {
+        const ct = getCharacterTable();
+        _nameToId = new Map(Object.entries(ct)
+            .filter(([, info]) => info.name)
+            .map(([cid, info]) => [info.name, cid]));
+    }
+    return _nameToId.get(name) ?? null;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Return formatted archive text for an operator by Chinese name. */
+export function getOperatorArchives(name) {
+    const cfg = loadConfig();
+    if (!hasOperatorData(cfg))
+        return missingDataMessage();
+    let charId;
+    try {
+        charId = resolveCharId(name);
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    if (charId === null) {
+        return `未找到干员 '${name}'。请使用游戏内中文名称（如'阿米娅'）。`;
+    }
+    let handbook;
+    try {
+        handbook = getHandbookTable();
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    const entry = handbook.handbookDict?.[charId];
+    if (!entry)
+        return `干员 '${name}' 暂无档案数据。`;
+    const sections = [];
+    for (const story of entry.storyTextAudio ?? []) {
+        const title = story.storyTitle ?? "";
+        const texts = (story.stories ?? [])
+            .map((s) => s.storyText ?? "")
+            .filter(Boolean);
+        if (texts.length > 0) {
+            sections.push(`### ${title}\n` + texts.join("\n"));
+        }
+    }
+    if (sections.length === 0)
+        return `干员 '${name}' 档案内容为空。`;
+    return `# ${name} - 干员档案\n\n` + sections.join("\n\n");
+}
+/** Return formatted voice-line text for an operator by Chinese name. */
+export function getOperatorVoicelines(name) {
+    const cfg = loadConfig();
+    if (!hasOperatorData(cfg))
+        return missingDataMessage();
+    let charId;
+    try {
+        charId = resolveCharId(name);
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    if (charId === null) {
+        return `未找到干员 '${name}'。请使用游戏内中文名称（如'阿米娅'）。`;
+    }
+    let charwords;
+    try {
+        charwords = getCharwordTable();
+    }
+    catch (err) {
+        return err instanceof Error ? err.message : String(err);
+    }
+    const lines = [];
+    for (const entry of Object.values(charwords.charWords ?? {})) {
+        if (entry.charId === charId && entry.voiceText) {
+            const title = entry.voiceTitle ?? "未知";
+            lines.push(`**${title}**: ${entry.voiceText}`);
+        }
+    }
+    if (lines.length === 0)
+        return `干员 '${name}' 暂无语音数据。`;
+    return `# ${name} - 语音记录\n\n` + lines.join("\n");
+}
+//# sourceMappingURL=operator.js.map

package/dist/data/operator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.js","sourceRoot":"","sources":["../../src/data/operator.ts"],"names":[],"mappings":"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"}

package/dist/data/sync.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GitHub-backed data sync for PRTS-MCP (TypeScript implementation).
+ *
+ * Mirrors the behaviour of python/src/prts_mcp/data/sync.py exactly:
+ * - Checks the upstream commit SHA via the GitHub Commits API.
+ * - Downloads required game data files only when the upstream has changed.
+ * - Falls back gracefully to cached / bundled data when the network is
+ *   unavailable.
+ * - Skips the upstream check entirely when cached data is fresher than the TTL.
+ */
+export declare const GAMEDATA_FILES: readonly string[];
+/** Describes an upstream GitHub repository and the files required from it. */
+export interface RepoSpec {
+    owner: string;
+    repo: string;
+    branch: string;
+    files: readonly string[];
+    /** Absolute path to the local directory where files are written. */
+    localRoot: string;
+}
+export type SyncStatus = "updated" | "up_to_date" | "offline_fallback" | "no_data";
+export interface SyncResult {
+    spec: RepoSpec;
+    status: SyncStatus;
+    commitSha: string | null;
+    error: string | null;
+}
+/**
+ * Return the latest commit SHA from GitHub, or `null` on any failure.
+ */
+export declare function checkUpstreamSha(spec: RepoSpec, timeoutMs?: number): Promise<string | null>;
+/**
+ * Download all required files atomically, then write cache metadata.
+ *
+ * Uses a write-to-tmp-then-rename pattern so partially downloaded files
+ * never appear to the data loader as complete.
+ */
+export declare function downloadFiles(spec: RepoSpec, sha: string, timeoutMs?: number): Promise<void>;
+/**
+ * Check upstream and download files if needed.
+ *
+ * Decision tree (mirrors Python sync.py):
+ *   1. Cache is fresh AND files exist → up_to_date (skip API call)
+ *   2. Call GitHub commits API:
+ *      a. Network failure:
+ *           files present → offline_fallback
+ *           no files      → no_data
+ *      b. SHA matches cache AND files present → up_to_date (refresh fetchedAt)
+ *      c. Otherwise → downloadFiles()
+ *           success → updated
+ *           failure → files present → offline_fallback / no files → no_data
+ */
+export declare function syncRepo(spec: RepoSpec): Promise<SyncResult>;
+/** Sync each RepoSpec sequentially and return all results. */
+export declare function syncAll(specs: RepoSpec[]): Promise<SyncResult[]>;

package/dist/data/sync.js

@@ -0,0 +1,215 @@
+/**
+ * GitHub-backed data sync for PRTS-MCP (TypeScript implementation).
+ *
+ * Mirrors the behaviour of python/src/prts_mcp/data/sync.py exactly:
+ * - Checks the upstream commit SHA via the GitHub Commits API.
+ * - Downloads required game data files only when the upstream has changed.
+ * - Falls back gracefully to cached / bundled data when the network is
+ *   unavailable.
+ * - Skips the upstream check entirely when cached data is fresher than the TTL.
+ */
+import { existsSync } from "node:fs";
+import { mkdir, readFile, rename, unlink, writeFile, } from "node:fs/promises";
+import { dirname, join } from "node:path";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const GAMEDATA_FILES = [
+    "zh_CN/gamedata/excel/character_table.json",
+    "zh_CN/gamedata/excel/handbook_info_table.json",
+    "zh_CN/gamedata/excel/charword_table.json",
+];
+const GITHUB_UA = "PRTS-MCP-Bot/0.1 (Arknights fan-creation helper)";
+/** Skip the upstream SHA check if cached data is fresher than this (seconds). */
+const CACHE_TTL_SECONDS = 3600;
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function githubHeaders() {
+    const headers = { "User-Agent": GITHUB_UA };
+    const token = process.env["GITHUB_TOKEN"];
+    if (token)
+        headers["Authorization"] = `Bearer ${token}`;
+    return headers;
+}
+function cacheMetaPath(spec) {
+    return join(spec.localRoot, "cache_meta.json");
+}
+async function loadCacheMeta(spec) {
+    try {
+        const text = await readFile(cacheMetaPath(spec), "utf-8");
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+async function saveCacheMeta(spec, meta) {
+    const p = cacheMetaPath(spec);
+    await mkdir(dirname(p), { recursive: true });
+    await writeFile(p, JSON.stringify(meta, null, 2), "utf-8");
+}
+function cacheIsFresh(cache) {
+    try {
+        const ageMs = Date.now() - new Date(cache.fetchedAt).getTime();
+        return ageMs < CACHE_TTL_SECONDS * 1000;
+    }
+    catch {
+        return false;
+    }
+}
+function filesPresent(spec) {
+    return spec.files.every((f) => existsSync(join(spec.localRoot, f)));
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Return the latest commit SHA from GitHub, or `null` on any failure.
+ */
+export async function checkUpstreamSha(spec, timeoutMs = 10_000) {
+    const url = `https://api.github.com/repos/${spec.owner}/${spec.repo}/commits/${spec.branch}`;
+    try {
+        const res = await fetch(url, {
+            headers: githubHeaders(),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}`);
+        const data = (await res.json());
+        return data.sha;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Download all required files atomically, then write cache metadata.
+ *
+ * Uses a write-to-tmp-then-rename pattern so partially downloaded files
+ * never appear to the data loader as complete.
+ */
+export async function downloadFiles(spec, sha, timeoutMs = 60_000) {
+    const tmpPairs = [];
+    try {
+        for (const filePath of spec.files) {
+            const url = `https://raw.githubusercontent.com/${spec.owner}/${spec.repo}/${spec.branch}/${filePath}`;
+            const res = await fetch(url, {
+                headers: githubHeaders(),
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status} for ${filePath}`);
+            const dest = join(spec.localRoot, filePath);
+            const tmp = dest + ".tmp";
+            await mkdir(dirname(dest), { recursive: true });
+            // Write raw bytes to preserve exact encoding from upstream.
+            await writeFile(tmp, Buffer.from(await res.arrayBuffer()));
+            tmpPairs.push([tmp, dest]);
+        }
+        // All downloads succeeded — atomically rename into place.
+        for (const [tmp, dest] of tmpPairs) {
+            await rename(tmp, dest);
+        }
+        tmpPairs.length = 0;
+        await saveCacheMeta(spec, {
+            repo: `${spec.owner}/${spec.repo}`,
+            branch: spec.branch,
+            commitSha: sha,
+            fetchedAt: new Date().toISOString(),
+            files: [...spec.files],
+        });
+    }
+    catch (err) {
+        // Clean up any temp files on failure.
+        for (const [tmp] of tmpPairs) {
+            try {
+                await unlink(tmp);
+            }
+            catch {
+                // best-effort cleanup
+            }
+        }
+        throw err;
+    }
+}
+/**
+ * Check upstream and download files if needed.
+ *
+ * Decision tree (mirrors Python sync.py):
+ *   1. Cache is fresh AND files exist → up_to_date (skip API call)
+ *   2. Call GitHub commits API:
+ *      a. Network failure:
+ *           files present → offline_fallback
+ *           no files      → no_data
+ *      b. SHA matches cache AND files present → up_to_date (refresh fetchedAt)
+ *      c. Otherwise → downloadFiles()
+ *           success → updated
+ *           failure → files present → offline_fallback / no files → no_data
+ */
+export async function syncRepo(spec) {
+    const cache = await loadCacheMeta(spec);
+    const filesOk = filesPresent(spec);
+    // Fast path: cache is fresh, no need to hit the API.
+    if (cache !== null && filesOk && cacheIsFresh(cache)) {
+        return {
+            spec,
+            status: "up_to_date",
+            commitSha: cache.commitSha,
+            error: null,
+        };
+    }
+    const upstreamSha = await checkUpstreamSha(spec);
+    if (upstreamSha === null) {
+        return filesOk
+            ? {
+                spec,
+                status: "offline_fallback",
+                commitSha: cache?.commitSha ?? null,
+                error: "Network unavailable",
+            }
+            : {
+                spec,
+                status: "no_data",
+                commitSha: null,
+                error: "Network unavailable and no cached data",
+            };
+    }
+    if (cache !== null && cache.commitSha === upstreamSha && filesOk) {
+        // Refresh fetchedAt so the TTL resets from now.
+        await saveCacheMeta(spec, { ...cache, fetchedAt: new Date().toISOString() });
+        return {
+            spec,
+            status: "up_to_date",
+            commitSha: upstreamSha,
+            error: null,
+        };
+    }
+    try {
+        await downloadFiles(spec, upstreamSha);
+        return { spec, status: "updated", commitSha: upstreamSha, error: null };
+    }
+    catch (err) {
+        const error = errorMessage(err);
+        return filesOk
+            ? {
+                spec,
+                status: "offline_fallback",
+                commitSha: cache?.commitSha ?? null,
+                error,
+            }
+            : { spec, status: "no_data", commitSha: null, error };
+    }
+}
+/** Sync each RepoSpec sequentially and return all results. */
+export async function syncAll(specs) {
+    const results = [];
+    for (const spec of specs) {
+        results.push(await syncRepo(spec));
+    }
+    return results;
+}
+//# sourceMappingURL=sync.js.map

package/dist/data/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/data/sync.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,141 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import express from "express";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { searchPrts, readPage } from "./api/prtsWiki.js";
+import { getOperatorArchives, getOperatorVoicelines } from "./data/operator.js";
+import { syncAll, GAMEDATA_FILES } from "./data/sync.js";
+// ---------------------------------------------------------------------------
+// Logging
+// ---------------------------------------------------------------------------
+function log(level, msg) {
+    const ts = new Date().toISOString();
+    process.stderr.write(`${ts} ${level} prts_mcp.server: ${msg}\n`);
+}
+// ---------------------------------------------------------------------------
+// MCP Server factory — one instance per session
+// ---------------------------------------------------------------------------
+function createMcpServer() {
+    const server = new McpServer({
+        name: "PRTS_Wiki_Assistant",
+        version: "0.1.0",
+    });
+    server.tool("search_prts", "搜索 PRTS 明日方舟中文维基词条。返回匹配的词条标题和摘要。", { query: z.string(), limit: z.number().int().min(1).max(20).default(5) }, async ({ query, limit }) => {
+        const results = await searchPrts(query, limit);
+        if (results.length === 0) {
+            return { content: [{ type: "text", text: `未找到与 '${query}' 相关的词条。` }] };
+        }
+        const text = results
+            .map((r) => `**${r.title}**\n${r.snippet}`)
+            .join("\n\n---\n\n");
+        return { content: [{ type: "text", text }] };
+    });
+    server.tool("read_prts_page", "读取 PRTS 维基指定词条的纯文本内容。", { page_title: z.string() }, async ({ page_title }) => {
+        const text = await readPage(page_title);
+        return { content: [{ type: "text", text }] };
+    });
+    server.tool("get_operator_archives", '获取指定干员的档案资料（使用游戏内中文名，如"阿米娅"）。', { operator_name: z.string() }, ({ operator_name }) => {
+        const text = getOperatorArchives(operator_name);
+        return { content: [{ type: "text", text }] };
+    });
+    server.tool("get_operator_voicelines", '获取指定干员的语音记录（使用游戏内中文名，如"阿米娅"）。', { operator_name: z.string() }, ({ operator_name }) => {
+        const text = getOperatorVoicelines(operator_name);
+        return { content: [{ type: "text", text }] };
+    });
+    return server;
+}
+// ---------------------------------------------------------------------------
+// Startup data sync (fire-and-forget)
+// ---------------------------------------------------------------------------
+function runStartupSync() {
+    const cfg = loadConfig();
+    if (cfg.isCustomGamedata) {
+        log("INFO", `GAMEDATA_PATH is custom (${cfg.gamedataPath}); auto-sync disabled.`);
+        return;
+    }
+    const specs = [
+        {
+            owner: "Kengxxiao",
+            repo: "ArknightsGameData",
+            branch: "master",
+            files: GAMEDATA_FILES,
+            localRoot: cfg.gamedataPath,
+        },
+    ];
+    syncAll(specs)
+        .then((results) => {
+        for (const r of results) {
+            const sha = r.commitSha ? r.commitSha.slice(0, 8) : "unknown";
+            if (r.status === "updated") {
+                log("INFO", `Data updated from GitHub (${r.spec.repo} @ ${sha}).`);
+            }
+            else if (r.status === "up_to_date") {
+                log("INFO", `Data is up to date (${r.spec.repo} @ ${sha}).`);
+            }
+            else if (r.status === "offline_fallback") {
+                log("WARN", `Network unavailable; using cached data (${r.spec.repo} @ ${sha}). Error: ${r.error}`);
+            }
+            else {
+                log("ERROR", `Sync failed for ${r.spec.repo} — no data. Error: ${r.error}`);
+            }
+        }
+    })
+        .catch((err) => {
+        log("ERROR", `Startup sync threw unexpectedly: ${err instanceof Error ? err.message : String(err)}`);
+    });
+}
+// ---------------------------------------------------------------------------
+// Express + StreamableHTTP
+// ---------------------------------------------------------------------------
+const app = express();
+// Parse JSON bodies — StreamableHTTP transport accepts req.body as parsedBody.
+app.use(express.json());
+const transports = new Map();
+app.all("/mcp", async (req, res) => {
+    const sessionId = req.headers["mcp-session-id"];
+    let transport = sessionId ? transports.get(sessionId) : undefined;
+    if (!transport) {
+        const newTransport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (id) => {
+                transports.set(id, newTransport);
+                log("INFO", `Session ${id} initialized.`);
+            },
+        });
+        newTransport.onclose = () => {
+            if (newTransport.sessionId) {
+                transports.delete(newTransport.sessionId);
+                log("INFO", `Session ${newTransport.sessionId} closed.`);
+            }
+        };
+        try {
+            const server = createMcpServer();
+            await server.connect(newTransport);
+        }
+        catch (err) {
+            log("ERROR", `Failed to connect MCP server to transport: ${err instanceof Error ? err.message : String(err)}`);
+            res.status(500).json({ error: "Internal server error" });
+            return;
+        }
+        transport = newTransport;
+    }
+    // Pass req.body explicitly so the transport uses the already-parsed body
+    // rather than attempting to re-read the consumed stream.
+    await transport.handleRequest(req, res, req.body);
+});
+app.get("/health", (_req, res) => {
+    res.json({ status: "ok" });
+});
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+const PORT = Number(process.env["PORT"] ?? 3000);
+const HOST = process.env["HOST"] ?? "0.0.0.0";
+runStartupSync();
+app.listen(PORT, HOST, () => {
+    log("INFO", `PRTS MCP Server listening on ${HOST}:${PORT} (StreamableHTTP at /mcp)`);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/utils/sanitizer.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wikitext sanitiser — strips markup and returns plain text.
+ * Mirrors python/src/prts_mcp/utils/sanitizer.py exactly.
+ */
+/** Remove common wikitext markup and return plain text. */
+export declare function stripWikitext(text: string): string;

package/dist/utils/sanitizer.js

@@ -0,0 +1,22 @@
+/**
+ * Wikitext sanitiser — strips markup and returns plain text.
+ * Mirrors python/src/prts_mcp/utils/sanitizer.py exactly.
+ */
+/** Remove common wikitext markup and return plain text. */
+export function stripWikitext(text) {
+    // Remove {{template}} blocks (non-greedy, single-level)
+    text = text.replace(/\{\{[^}]*\}\}/g, "");
+    // Remove [[File:...]] / [[文件:...]] image links
+    text = text.replace(/\[\[(File|文件|Image|图像):[^\]]*\]\]/g, "");
+    // Convert [[link|display]] -> display, [[link]] -> link
+    text = text.replace(/\[\[[^|\]]*\|([^\]]+)\]\]/g, "$1");
+    text = text.replace(/\[\[([^\]]+)\]\]/g, "$1");
+    // Remove HTML tags
+    text = text.replace(/<[^>]+>/g, "");
+    // Remove category links
+    text = text.replace(/\[\[(Category|分类):[^\]]*\]\]/g, "");
+    // Collapse multiple blank lines
+    text = text.replace(/\n{3,}/g, "\n\n");
+    return text.trim();
+}
+//# sourceMappingURL=sanitizer.js.map

package/dist/utils/sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitizer.js","sourceRoot":"","sources":["../../src/utils/sanitizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,wDAAwD;IACxD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC;IAC9D,wDAAwD;IACxD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,IAAI,CAAC,CAAC;IACxD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC/C,mBAAmB;IACnB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpC,wBAAwB;IACxB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC,CAAC;IACzD,gCAAgC;IAChC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "prts-mcp-ts",
+  "version": "0.1.0",
+  "description": "MCP Server for Arknights PRTS Wiki & game data (TypeScript / Streamable HTTP)",
+  "type": "module",
+  "main": "dist/server.js",
+  "bin": {
+    "prts-mcp-ts": "./dist/server.js"
+  },
+  "files": [
+    "dist/"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/server.ts",
+    "start": "node dist/server.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "tsc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/3aKHP/prts-mcp.git",
+    "directory": "ts"
+  },
+  "volta": {
+    "node": "24.14.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.8.0"
+  }
+}