AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
MCP Servers/
StardewValley-MCP
StardewValley-MCP logo

StardewValley-MCP

Active·★ 34·Apache-2.0·Updated 2026-06-04

Stardew MCP Bridge adds AI companions to Stardew Valley and exposes them through the Model Context Protocol. Companions are spawned as Player 2 or 3 with custom sprites and can be controlled directly by an AI agent: move, use tools, fight, fish, farm, explore the mines and open chests. It also has autonomous modes (follow, farm, mine, fish, idle) for hands-off play.

Two parts work together. A SMAPI mod written in C# runs inside the game, pairing each visible companion NPC with a hidden shadow farmer that performs the real game mechanics, and exchanges state with the second part through JSON files. A Node.js MCP server exposes 25 tools over stdio, 13 global tools and 12 direct-control tools for player mode, such as getting surroundings, moving to a tile, using a tool, attacking and casting a fishing rod. Auto-combat can be toggled because real-time fighting is too fast for model round trips. You build the server with npm, add it to your MCP client config and launch the game with SMAPI.

This write-up is based on the project's README and public repository data. We have not hand-tested the tool. Data as of 2026-10-17.

License
Apache-2.0
Latest release
v0.3.0 · 2026-03-10
Last commit
2026-06-04
Contributors
1
Forks
8
Open issues and PRs
0
First published
2026-02-22

Source: GitHub, npm and PyPI public APIs.

#ai#claude-ai#companion-ai#gaming#gaming-tools#mcp#mcp-server#mcp-servers
$ Install
$ cd smapi-mod && export GAME_PATH="C:/Program Files/Steam/steamapps/common/Stardew Valley" && dotnet build && cd ../mcp-server && npm install && npm run build
↗ Visit site★ GitHub
01

Features

01Spawn companions as Player 2/3 with custom sprites and shadow farmers
02Autonomous modes: follow, farm, mine, fish, idle
03Direct MCP control with 12 player mode tools (move, use tools, fight, fish, interact)
04Supports real-time auto-combat and auto-hook fishing
05Bridge data provides surroundings, inventory, and command results
02

Why choose it

+Gives an AI agent real in-game actions (tools, combat, fishing, farming) through 25 MCP tools.
+Offers both autonomous modes and a direct player mode where the agent acts as Player 2.
+Companions use actual game APIs through a shadow farmer, so mechanics follow the normal game rules.
+Auto-combat and auto-hook fishing handle actions that are too fast for model round trips.
03

Trade-offs

!It needs Stardew Valley with the SMAPI mod loader and a separate Node.js build, so setup is several manual steps.
!State is exchanged through JSON files between the mod and the server, so it works only on the machine running the game.
!It is a niche, hobby-style project (about 29 stars), and the README describes release notes up to v0.3.0.
04

Maintenance check

SlowingChecked: 2026-10-19
Last commit
2026-06-04
Commits, last 90 days
0
Releases, last 90 days
0
Latest release
v0.3.0 (2026-03-10)
Open issues
0
Recent issues with at least one comment
—
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

05

Compatibility

Stardew Valley
Game
Verified via docs
SMAPI
Mod Loader
Verified via docs
Node.js
Runtime
Verified via docs
06

Quick start

1
$ cd smapi-mod
2
$ export GAME_PATH="C:/Program Files/Steam/steamapps/common/Stardew Valley"
3
$ dotnet build
4
$ cd ../mcp-server
5
$ npm install
6
$ npm run build
07

Use cases

↳Automate farming tasks like watering and harvesting
↳Enable AI-controlled exploration and mining in the Skull Cavern
↳Create interactive NPC companions that follow and assist the player
08

Alternatives

⚡Top VS:
VSmcp-claude-spotify★53→VSGodot-MCP★301→VSpostman-mcp-server★324→VSmikrotik-mcp★303→
mcp-claude-spotify logo
mcp-claude-spotify★ 53
An integration that allows Claude Desktop to interact with Spotify using the Model Context Protocol (MCP).
VSCompare→
Godot-MCP logo
Godot-MCP★ 301
Godot-MCP — Model Context Protocol (MCP) integration for the Godot Engine. AI tools for the Godot Editor in C#, with cloud connection to ai-game.dev. Apache-2.0.
VSCompare→
postman-mcp-server logo
postman-mcp-server★ 324
Connect your AI to your APIs on Postman
VSCompare→
mikrotik-mcp logo
mikrotik-mcp★ 303
MCP server for Mikrotik
VSCompare→
turbovault logo
turbovault★ 155
Markdown and OFM SDK w/ MCP server that transforms your Obsidian vault into an intelligent knowledge system
VSCompare→
awesome-mcp-servers logo
awesome-mcp-servers★ 121
A curated list of the best MCP Servers, featuring top solutions, libraries, tools, and more. - https://mcpserver.works
VSCompare→
mcp-server logo
mcp-server★ 117
MCP server for AI-assisted development of CAP applications
VSCompare→
mcp-discord logo
mcp-discord★ 108
Implement Discord MCP server enabling AI assistants to interact with the Discord platform.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs04Maintenance check05Compatibility06Quick start07Use cases08Alternatives
amarisaster /
StardewValley-MCP
↗

MCP bridge that lets an AI agent play Stardew Valley as a companion

348Apache-2.0
Last commit4mo ago
StatusActive
CategoryMCP Servers
Contributors1
Latest releasev0.3.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.