Twilight Imperium 4 游戏数据服务

提供Twilight Imperium 4的游戏数据、规则查询、阵营策略指南和设置辅助的服务器工具。

  • by surewht
  • TypeScript
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 surewht/ti4-mcp

使用说明

ti4 mcp

MCP服务器 黄昏帝国4 --通过提供游戏数据、规则查找、派系策略指南和设置帮助 模型上下文协议.

支持的内容

  • 基础游戏 (17个派别)
  • 国王的预言 (7个派系)
  • 食品法典I–IV (勘误表,更新的组成部分,Keleres理事会)
  • 雷霆之刃 (5个派系、突破、银河系事件)

安装

npm install
npm run build

需要Node.js 18+。

用法

克劳德代码

来自GitHub:

claude mcp add ti4 -- npx --yes github:surewht/ti4-mcp

从本地克隆:

claude mcp add ti4 node /path/to/ti4-mcp/dist/index.js

克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "ti4": {
      "command": "npx",
      "args": ["--yes", "github:surewht/ti4-mcp"]
    }
  }
}

检查员

npm run inspect

工具(27)

游戏背景

工具 说明
set_game_context 设置游戏会话上下文(扩展、玩家数量、派系、切片)——后续工具会自动应用它
get_game_context 查看当前游戏上下文
clear_game_context 清晰的游戏背景

派系

工具 说明
list_factions 列出活跃扩展的派系
get_faction 详细的派系信息(能力、起始技术、单位、领导人、本票)
get_faction_guide 战略指南——优势、劣势、技巧、技术路径
list_faction_guides 列出所有可用的派系指南

技术

工具 说明
get_tech 按ID查找技术
get_tech_path 获取派系的推荐技术路径

目标

工具 说明
list_objectives 列出目标,按类型(公共/秘密)和阶段(1/2)筛选
get_objective 查找特定目标

议程

工具 说明
list_agendas 列出议程卡,按类型(法律/指令)或选举类型筛选
get_agenda 查找具体议程

行动卡

工具 说明
list_action_cards 列出动作卡,按播放时间关键字过滤
get_action_card 查找特定的行动卡

遗迹与探索

工具 说明
list_relics 列出所有文物
get_relic 查找特定的文物
list_explore_cards 列出探索卡,按特征筛选

行星与系统

工具 说明
list_planets 列出行星,按特征或技术专长筛选
get_planet 查找特定的行星
get_system 按数字查找系统图块(行星、虫洞、异常)

策略与设置

工具 说明
get_strategy_notes 给定游戏状态的派系战略分析
setup_game 生成完整的游戏设置(选秀池、策略卡订单等)
suggest_map 为玩家数量建议平衡的地图布局
analyze_slices 分析地图切片以获得平衡(资源、影响力、技术专长)

规则和搜索

工具 说明
get_rules 按关键字查找规则
search 在所有游戏数据类别中进行全文搜索

游戏背景

设置游戏设置一次,所有工具都会自动应用它:

"Set game context: 6 players, base + PoK + Codex 3"

AI呼叫 set_game_context 随着你的扩展和玩家数量。之后,工具如 list_factions, list_objectives, suggest_map等自动使用这些扩展,而无需每次指定。

如果需要,您仍然可以覆盖每次调用的扩展。

数据

所有游戏数据都存在 data/ 作为JSON文件:

文件 内容
factions.json 30个具有能力、初始技术、单位和领导者的派系
technologies.json 扩展中的所有技术
objectives.json 公开阶段I/II和秘密目标
agendas.json 法律和指令议程卡
action-cards.json 带有游戏计时的动作卡
strategy-cards.json 具有主要/次要能力的策略卡
systems.json 带有行星、虫洞和异常的系统图块
planets.json 单个行星数据
units.json 单位统计数据(成本、战斗、移动、容量、能力)
promissory-notes.json 派系和通用本票
relics.json 文物(PoK)
explores.json 探索卡(PoK)
leaders.json 特工、指挥官、英雄
breakthroughs.json 突破(雷霆边缘)
galactic-events.json 银河系事件(雷霆边缘)
rules.json 规则参考小节
tile-tiers.json 用于地图平衡的瓷砖质量等级
factions/*.guide.json 来自竞争性社区的30个派系战略指南

扩展

工具接受 expansions 用于控制包含哪些内容的参数:

  • base --基础游戏
  • pok --国王的预言
  • codex-1 通过 codex-4 --食品法典卷(包括欧米茄替代品)
  • thunders-edge --Thunder的Edge扩展

当扩展包括codex卷时,更新的组件会自动替换其旧的base/PoK版本。

许可证

麻省理工学院