mcp-azureland

MCP server for managing AzurLaneAutoScript (ALAS) and other game automation scripts via AI agents.

Status: Phase 1 — Core process management, config tools, and monitoring.

Overview

mcp-azureland exposes ALAS as a set of MCP tools, enabling AI agents (OpenClaw, Hermes, Cursor, Claude Code, etc.) to:

• Start/stop ALAS automation processes

• Read/write ALAS JSON config files

• Monitor runtime status via logs and screenshots

• Schedule tasks (daily, campaign farming, event farming, etc.)

Design principles

Related MCP server: AstrBot MCP

Quick Start

Prerequisites

• Python 3.10+

• AzurLaneAutoScript installed and configured

• Windows (recommended)

Installation

# Clone and install
git clone git@github.com:Wislist/mcp-azureland.git
cd mcp-azureland
pip install -e .

Configuration

Edit config/server.yaml to set the path to your ALAS installation:

alas_path: "D:/Games/AzurLaneAutoScript"  # Absolute or relative path

Run

# Directly
python -m mcp_azureland.server

# Or via installed command
mcp-azureland

MCP Client Setup

Add to your AI agent's MCP configuration:

{
  "mcpServers": {
    "azureland": {
      "command": "python",
      "args": ["-m", "mcp_azureland.server"],
      "cwd": "/path/to/mcp-azureland"
    }
  }
}

MCP Tools

Process Management

Configuration

Monitoring

Architecture

AI Agent (OpenClaw/Hermes)
    │ MCP stdio (JSON-RPC)
    ▼
mcp-azureland server
    │
    ├── ProcessManager  ── subprocess ──► bridge/run_alas.py ── import ──► ALAS
    ├── ConfigManager   ── read/write ──► config/*.json
    └── MonitorManager  ── tail/read ───► log/*.txt, screenshots/

Extending

To add support for another game:

1. Create a new adapter in src/mcp_azureland/adapters/

2. Inherit from BaseGameAdapter and implement the abstract methods

3. Register the adapter in server.py

See adapters/base.py for the interface.

License

MIT