Civilization VI MCP Server

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: ~/Documents/My 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

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.