SovietRepublic-MCP
MCP server for Workers & Resources: Soviet Republic. Exposes live game data as tools for Claude Code and Claude Desktop.
What it does
Reads the game's autosave (stats.ini) on every tool call and returns current data — no background process, no stale cache.
Available tools
| Tool | Description |
|---|---|
get_stats | Full snapshot: population, economy, year/day |
get_population | Citizen counts and demographics |
get_economy | All resource prices in RUB and USD |
get_citizen_status | Happiness metrics (food, water, healthcare, …) on 0–1 scale |
get_history | Time series for any metric across all autosave records |
get_trade | Current period import/export totals |
get_trade_history | Trade volume over time for a specific resource |
list_saves | All available save folders |
Requirements
- Python 3.10+
- Workers & Resources: Soviet Republic installed (Steam)
mcp[cli]==1.3.0
pip install -r requirements.txt
Setup
The server expects the game installed at the default Steam path. The autosave is read from:
<game root>/media_soviet/save/autosave1/stats.ini
If your game is installed elsewhere, update STATS_PATH in mcp_server.py.
Claude Code (~/.claude/settings.json)
{
"mcpServers": {
"soviet-republic": {
"command": "python",
"args": ["E:/SteamLibrary/steamapps/common/SovietRepublic/soviet_dashboard/main.py"]
}
}
}
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"soviet-republic": {
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\Python\\Python313\\python.exe",
"args": ["E:\\SteamLibrary\\steamapps\\common\\SovietRepublic\\soviet_dashboard\\main.py"]
}
}
}
Restart Claude after editing the config. The server starts automatically when needed.
Usage
Once connected, ask Claude naturally:
"Wie entwickelt sich meine Bevölkerung?" "What's my current food supply satisfaction?" "Show me steel import history."
Project structure
main.py # Entry point — asyncio.run(run_mcp())
mcp_server.py # 8 MCP tools, reads fresh from disk per call
parser.py # Parses stats.ini → StatRecord dataclasses
requirements.txt # mcp[cli]==1.3.0