StardewValley-MCP
活跃·★ 34·Apache-2.0·更新于 2026-06-04
Stardew MCP Bridge 给《星露谷物语》加入 AI 同伴,并通过 Model Context Protocol 对外提供控制。同伴会作为 2P 或 3P 生成,带有自定义精灵图,AI 智能体可以直接控制:移动、使用工具、战斗、钓鱼、种地、探索矿洞和打开箱子。它还有自主模式(跟随、种地、挖矿、钓鱼、待机),可以放手让它自己玩。
两部分协同工作。用 C# 编写的 SMAPI 模组在游戏内运行,把每个可见的同伴 NPC 与一个隐藏的影子农夫配对,由影子农夫执行真实的游戏机制,并通过 JSON 文件与第二部分交换状态。Node.js 的 MCP 服务通过 stdio 提供 25 个工具,其中 13 个全局工具、12 个玩家模式下的直接控制工具,例如获取周围环境、移动到某个格子、使用工具、攻击和甩杆钓鱼。自动战斗可以开关,因为实时战斗的速度超过模型的往返速度。用 npm 构建服务,写入 MCP 客户端配置,再用 SMAPI 启动游戏即可。
#人工智能#Claude AI#companion-ai#gaming#gaming-tools#MCP 协议#MCP 服务器
01
功能特性
01生成带有自定义精灵和影子农民的同伴作为玩家2/3
02自主模式:跟随、耕种、采矿、钓鱼、待机
03直接MCP控制,12个玩家模式工具(移动、使用工具、战斗、钓鱼、交互)
04支持实时自动战斗和自动挂钩钓鱼
05桥接数据提供周围环境、库存和命令结果
02
为什么选择它
+通过 25 个 MCP 工具,让 AI 智能体执行真实的游戏内动作(工具、战斗、钓鱼、种地)。
+既有自主模式,也有智能体扮演 2P 的直接玩家模式。
+同伴通过影子农夫调用真实游戏 API,机制遵循游戏的正常规则。
+自动战斗和自动提竿处理了模型往返跟不上的快速动作。
03
权衡点
!需要安装带 SMAPI 模组加载器的《星露谷物语》,还要单独构建 Node.js 服务,设置有好几个手动步骤。
!模组与服务之间通过 JSON 文件交换状态,所以只能在运行游戏的那台机器上使用。
!这是小众的兴趣类项目(约 29 个星标),README 的更新说明只到 v0.3.0。
04
维护状况检查
放缓检查日期: 2026-10-19
- 最近提交
- 2026-06-04
- 近 90 天提交数
- 0
- 近 90 天发布数
- 0
- 最新发布
- v0.3.0 (2026-03-10)
- 未关闭 issue
- 0
- 近期 issue 至少有一条评论的比例
- —
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
05
兼容性
Stardew Valley
游戏
已通过文档验证
SMAPI
模组加载器
已通过文档验证
Node.js
运行时
已通过文档验证
06
快速开始
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
使用场景
↳自动化耕种任务,如浇水和收获
↳实现AI控制的沙漠矿井探索和采矿
↳创建跟随并协助玩家的交互式NPC同伴
08
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧