AI导哈

文明VI游戏数据分析服务

一个为文明VI游戏提供实时数据分析的MCP服务器，通过连接Claude AI，提供战略分析、外交情报、军事评估等功能。

  • by lowrykun
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 lowrykun/civ6mcp

使用说明

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: %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.

相关 MCP