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版本。
许可证
麻省理工学院