vic3-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RAKALY | No | Path to the rakaly executable | |
| VIC3_GAME_DIR | No | Override the game installation directory | |
| VIC3_SAVE_DIR | No | Override the save game directory | |
| VIC3_USER_DIR | No | Override the user data directory | |
| VIC3_LLM_MODEL | No | Model name (default: kimi-k3) | |
| VIC3_MCP_CACHE | No | Cache directory for melted save data | |
| VIC3_LLM_API_KEY | No | API key for the LLM | |
| VIC3_LLM_BASE_URL | No | OpenAI compatible base URL for the LLM |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_savesA | 列出本机 Victoria 3 存档（Documents/Paradox Interactive/Victoria 3/save games）。 |
| load_saveC | 融化并载入一个 .v3 存档。name 可以是存档名（如 Qing_MCP）或完整路径。 |
| overviewC | 国家总览：日期、等级、GDP、威望、生活水平、人口、金库与列强名单。 |
| analyze_situationC | 根据存档数据给出风险标记和可执行建议（大清 1836 会附开局打法）。 |
| countryB | 单个国家的完整摘要（经济、人口、政府、省份列表）。 |
| list_countriesA | 列出存档里的国家。sort: gdp | prestige | population | tag。 |
| economyC | 金库、周收支、投资池、税率。 |
| politicsC | 利益集团、法案、机构、统治者/继承人。 |
| popsC | 人口结构：阶层、职业、文化、失业、生活水平。 |
| diplomacyC | 外交：关系、协定/敌对、战争。 |
| militaryD | 陆军/海军编制。 |
| technologyD | 已研究科技。 |
| journalC | 该国激活的日志条目。 |
| buildingsC | 建筑汇总：按类型的等级、利润，以及亏损建筑。 |
| statesB | 该国省份：名称、整合度、基础设施、人口。 |
| rankingsA | 威望排行与国家等级（列强/大国等）。 |
| compare_countriesA | 对比多个国家的 GDP、威望、人口、科技数。tags 为逗号分隔标签。 |
| search_saveA | 在融化后的存档文本里搜索原始字段（调试/查冷门数据）。 |
| localizeA | 查询游戏本地化。keys 为逗号分隔的 loc key，如 CHI,law_serfdom,ig_landowners。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| vic3_advisor | 让助手以维多利亚 3 顾问身份，基于当前存档给建议。 |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 19 tools
Tools are mostly separated by distinct game systems (economy, politics, pops, diplomacy, military, technology, buildings, states), so an agent can usually pick the right one. Some overlap exists among overview, country, rankings, and list_countries, but descriptions make their scopes reasonably clear.
All names are readable lowercase with underscores, but the pattern is mixed: many are bare noun section names like economy, politics, and pops, while others use verb_noun forms like load_save, compare_countries, and search_save. The naming is intuitive enough to navigate, but it does not follow a single predictable convention.
At 19 tools, the server is on the heavier side and includes many near-parallel section getters. Each tool maps to a legitimate Victoria 3 subsystem, but the set feels borderline and could be consolidated without losing much capability.
The tools cover the main Victoria 3 save-analysis surface: countries, economy, politics, pops, diplomacy, military, technology, buildings, states, rankings, and raw save searching. Missing conveniences like a market/trade or goods-price view are noticeable, but search_save can partially work around them.