Civ6mcp

An MCP (Model Context Protocol) server that provides Claude with real-time access to your Civilization VI game data. Get strategic analysis, diplomatic intelligence, military assessments, and more by connecting Claude to your active game.

Features

• Strategic Overview - Comprehensive situational briefing combining all intelligence
• Diplomatic Intelligence - Track relationships, alliances, and the reasons behind them
• Military Analysis - Monitor troop strength, combat desire, and threat levels
• Production Tracking - See what every civilization is building
• City Status - Analyze city growth potential and food challenges
• Victory Progress - Track who's leading each victory type
• Score Breakdown - Understand where each civ's score comes from (Empire, Tech, Wonders, etc.)
• Trend Analysis - Identify rising powers and declining civilizations
• Combat History - Review recent battles and ongoing conflicts
• World Congress - Track voting records and resolutions
• Great People - Monitor the great people race
• Cultural Victory Tracking - Track Great Artists, Writers, and Musicians

Requirements

• Node.js 18+
• Civilization VI (macOS or Windows)
• Claude Desktop

Important: You must enable game logging in Civilization VI for the MCP server to access game data. See Enable Game Logging below.

Installation

1. Clone the repository:

   git clone https://github.com/lowrykun/civ6mcp.git
   cd civ6mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Enable Game Logging

The MCP server reads data from Civilization VI's log files. You need to enable logging:

1. Find your UserOptions.txt file:

   • macOS: ~/Library/Application Support/Sid Meier's Civilization VI/UserOptions.txt
   • Windows: %LOCALAPPDATA%\Firaxis Games\Sid Meier's Civilization VI\UserOptions.txt

2. Add or modify this line:

   GameHistoryLogLevel=1
   

3. Start Civilization VI and play at least one turn to generate log data.

Claude Desktop Configuration

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "civ6": {
      "command": "node",
      "args": ["/path/to/civ6mcp/dist/index.js"]
    }
  }
}

Replace /path/to/civ6mcp with the actual path to where you cloned the repository.

Claude Project Setup (Recommended)

For the best experience, create a Claude Project with the strategic advisor instructions:

1. In Claude, create a new Project called "Civilization VI"
2. Copy the contents of PROJECT_INSTRUCTIONS.md into the Project Instructions
3. Start a conversation in that project

This gives Claude context about all the available tools and how to provide strategic advice.

Available Tools

Tool	Description
get_strategic_overview	Comprehensive briefing: threats, opportunities, victory race
get_yield_comparison	Compare all civs' science, culture, gold, faith, military
get_victory_progress	Who's leading each victory type
get_civ_statistics	Detailed per-civ stats (specify turn number optional)
get_score_breakdown	Score breakdown by category (Empire, Tech, Wonders, etc.)
get_trend_analysis	Track changes over time, identify rising/declining powers
get_diplomatic_status	Relationships: allied, friendly, denounced, war
get_diplomatic_modifiers	Specific reasons for +/- relations
get_military_intelligence	Strength, combat desire, threat levels
get_combat_log	Recent battles, units, damage
get_city_production	What every city is building
get_city_status	City growth potential based on food advantage at founding
get_tech_status	Technology progress by civilization
get_world_congress	Voting records and resolution outcomes
get_great_people	Great People claimed and available
get_great_people_culture	Track Artists, Writers, Musicians for cultural victory
list_saves	Find save files
read_game_state	Parse save file for basic game info
get_strategy_brief	Formatted briefing from save file

See TOOLS.md for detailed documentation.

Usage Examples

Ask Claude things like:

• "What's my current strategic situation?"
• "Who is the biggest threat right now?"
• "What are my neighbors building?"
• "How are my yields compared to other civs?"
• "Show me the trend analysis for the last 10 turns"
• "What's the diplomatic situation with Persia?"

How It Works

The MCP server reads from two sources:

1. Save Files (.Civ6Save) - Basic game info like leader, turn, map settings
2. Log Files (CSV) - Detailed statistics generated each turn when logging is enabled

Log files provide much richer data including:

• All civilizations' yields and military strength
• Diplomatic relationships and their modifiers
• Combat records
• City production queues
• Technology progress
• World Congress votes

Platform Support

• macOS - Fully supported
• Windows - Fully supported

Troubleshooting

"No game data available"

• Make sure GameHistoryLogLevel=1 is set in UserOptions.txt
• Play at least one turn after enabling logging
• Check that log files exist in your Logs directory

Data seems outdated

• Log files update when you complete a turn
• Mid-turn, you'll only see your own civilization's latest data

License

MIT License - see LICENSE for details.