Гибридный игровой мод с управлением ИИ, который соединяет Stardew Valley с AI-ассистентами через протокол Model Context Protocol (MCP). Позволяет автономным агентам ИИ управлять и играть в Stardew Valley через синхронизацию состояния игры в реальном времени.

Архитектура

Предварительные требования

Для мода SMAPI

• Stardew Valley (игра)
• SMAPI (Stardew Modding API) v4.0.0+
• .NET 6.0 SDK

Для сервера MCP

• Go 1.23+
• Доступ к GitHub Copilot (для Claude Sonnet через Copilot SDK)

Здание

1. Создайте C# Mod

Это компилирует StardewMCP.dll и помещает его в bin/Debug/net6.0/.

2. Постройте сервер Go MCP

Это создаёт исполняемый файл stardew-mcp.

Установка

Установите мод SMAPI

1. Создайте мод (см. выше)
2. Скопируйте всю папку mod/StardewMCP/bin/Debug/net6.0/ в папку модов Stardew Valley:

• Windows: %AppData%\StardewValley\Mods\StardewMCP\
• macOS: ~/.config/StardewValley/Mods/StardewMCP/
• Linux: ~/.config/StardewValley/Mods/StardewMCP/

3. Скопировать manifest.json в ту же папку

Или используйте структуру папок модов SMAPI:

Использование

1. Начните Stardew Valley с помощью SMAPI

Запустите игру через SMAPI.

Stardew Valley MCP Bridge

A hybrid AI-controlled game mod that bridges Stardew Valley with AI assistants via the Model Context Protocol (MCP). Enables autonomous AI agents to control and play Stardew Valley through real-time game state synchronization.

Architecture

┌─────────────────────────────────────────────────────────┐
│ STARDEW VALLEY (Game)                                   │
│   SMAPI Mod (C# .NET 6)                                 │
│     ModEntry → GameStateSerializer                      │
│              → CommandExecutor (w/ Pathfinder)          │
│              → WebSocketServer                          │
└─────────────────────────────────────────────────────────┘
              ↕ ws://localhost:8765/game
┌─────────────────────────────────────────────────────────┐
│ MCP Server (Go)                                         │
│   GameClient: WebSocket connection, state tracking      │
│   StardewAgent: 12 tools + 30 cheats, autonomous loop   │
└─────────────────────────────────────────────────────────┘
              ↕ Copilot SDK
┌─────────────────────────────────────────────────────────┐
│ Claude Sonnet (via GitHub Copilot SDK)                  │
└─────────────────────────────────────────────────────────┘

Prerequisites

For the SMAPI Mod

• Stardew Valley (game)
• SMAPI (Stardew Modding API) v4.0.0+
• .NET 6.0 SDK

For the MCP Server

• Go 1.23+
• GitHub Copilot access (for Claude Sonnet via Copilot SDK)

Building

1. Build the C# Mod

cd mod/StardewMCP
dotnet build

This compiles StardewMCP.dll and places it in bin/Debug/net6.0/.

2. Build the Go MCP Server

cd mcp-server
go build -o stardew-mcp

This produces the stardew-mcp executable.

Installation

Install the SMAPI Mod

1. Build the mod (see above)
2. Copy the entire mod/StardewMCP/bin/Debug/net6.0/ folder to your Stardew Valley mods directory:
   • Windows: %AppData%\StardewValley\Mods\StardewMCP\
   • macOS: ~/.config/StardewValley/Mods/StardewMCP/
   • Linux: ~/.config/StardewValley/Mods/StardewMCP/
3. Copy manifest.json to the same folder

Or use SMAPI’s mod folder structure:

Mods/
└── StardewMCP/
    ├── manifest.json
    ├── StardewMCP.dll
    └── (other build outputs)

Usage

1. Start Stardew Valley with SMAPI

Launch the game through SMAPI. The mod will automatically start a WebSocket server on ws://localhost:8765/game.

2. Load a Save File

The mod activates once you load into a game save.

3. Run the MCP Server

cd mcp-server
./stardew-mcp                    # Run with default autonomous mode
./stardew-mcp -auto=false        # Connect without starting AI agent
./stardew-mcp -goal "Clear the farm and plant parsnips"
./stardew-mcp -url ws://localhost:8765/game  # Custom WebSocket URL

The server connects to the game via WebSocket and begins the autonomous AI agent loop.