前言¶
在 DSH 里做智能体工作流时，常见做法是让模型通过 MCP 调用外部工具。若目标是「真正在 Minecraft 里生存游玩」，而不是抽象模拟或脱离原生 UI 的远程控制，就需要客户端侧的空间感知、有边界的连续动作，以及和第一视角、血条、物品栏一致的原生体验。下面介绍维护者 tianyingAquila 发布的 minecraft-native-mcp：面向 DeepSeek Harness 的启动器集成，同时也可作为通用 stdio MCP 使用；社区目录归类为工作流，GitHub 仓库当前约 1 star（以页面显示为准）。
这是什么¶
Minecraft Native MCP 是一套 Native Minecraft MCP，带 DSH 启动器、空间感知、有界动作，以及可选的直播挂件扩展。它让 DeepSeek 或其他 MCP 客户端操作真正的 Minecraft Java 生存玩家：保留原生第一视角、血条、饱食度和物品栏，并提供空间概览、采集合成、寻路战斗、连续矿道与异常截图诊断等能力。容器观察会给出真实槽位/用途、空格、光标持物、原生取放条件与可用进度；熔炉等窗口会标明阻塞原因。移动时镜头跟随寻路方向，空间摘要包含真实群系与可见环境线索；遇到新线索时，长段机械任务会提前交回模型评估探索机会。
插件以 MIT 许可发布新增代码（package.json 版本 0.3.6）；核心依赖 mcpfabric、Baritone 等，第三方许可见仓库 THIRD_PARTY.md。
核心功能¶
游玩与控制¶
- 默认普通自主游玩，单场默认 120 分钟（可调），到时保存暂停；辅助规则含生命回复 I、抗性提升 I、夜视 I、死亡不掉落，模型已知。
- 近战：模型可选目标与背包武器，程序连续追击并按原生冷却挥击；危险、目标丢失或武器将损坏时交回决策。短等最多 5 秒、连续两次；反复无进展会诊断、重新规划或尝试已验证的局部脱困。
- 暂停/保存/退出：暂停保存冻结整局；保存停止关闭游戏；退出控制台释放其进程。
空间与 MCP 工具（通用客户端）¶
完成游戏准备后，可在兼容 stdio MCP 的客户端挂载服务。空间摘要覆盖周围 16 格、上下 12 格，区分可见表面与保守地面连通；复杂洞穴可查询多层切片。dig_tunnel 一次推进 1–12 格、最多 90 秒，危险或卡住时提前交回决策。截图只取游戏画面，成功间隔 15 秒；完整参数以 MCP 工具列表为准。
世界与存档¶
在控制台「我的世界存档」可新建世界或切换世界；每个世界独立保存地图、背包和 AI 记忆。切换、新建或删除前先保存并停止；删除会确认世界名称后将存档、AI 记忆及专属缓存打包移入 Windows 回收站（包内附恢复说明）。
可选直播扩展¶
基础版之外可安装 dsh-minecraft-stream，启用小鲸鱼、动态行动/事件气泡、偶尔的余额显示与直播预览；与基础版共用同一套游戏，不多开控制服务。当前没有弹幕接收、语音或自动推流。
安装与启用¶
DSH 生态理念是「一切皆插件」；SkillHub 目录页为社区收录站点，与 DeepSeek / 幻方无官方从属关系。收录申请审核中；收录前使用 README 给出的安装命令，不要自行 git clone 或凭名称拼接 dsh plugin add github:owner/repo。
在 PowerShell 中安装基础版：
dsh plugin --profile desktop add https://github.com/tianyingAquila/minecraft-native-mcp/releases/latest/download/minecraft-native-mcp.tgz
重新打开 DSH，在输入框上方标准模式右侧点 Minecraft，浏览器会打开控制台。
需要直播显示时再装扩展：
dsh plugin --profile desktop add https://github.com/tianyingAquila/minecraft-native-mcp/releases/latest/download/dsh-minecraft-stream.tgz
重开 DSH 后，在暂停状态下通过 Minecraft 旁的直播扩展 启用相关 UI。
安装前建议：插件以当前 DSH 进程权限运行；安装前应自行查看 GitHub 仓库 源码与许可证，确认符合你的环境与合规要求。
典型用法：控制台三步准备¶
使用前需准备：
- 已在启动器安装 Minecraft Java 1.21 系列正式版本（插件识别 1.21 至 1.21.11，自动选择或由你指定；第三方启动器可点「选择文件夹」）。插件复用已安装的原版客户端文件，创建独立 Fabric 实例。
- DSH 中已有可用的官方 DeepSeek API 密钥，账户至少保留 ¥1。插件自动复用私有凭据；自主控制台有自己的模型设置；仅有聊天订阅、第三方转发或 DSH 登录状态不能替代官方 API 凭据。
在控制台按顺序：
- 环境检查：显示游戏、Java、账户配置和运行文件情况，缺失项旁给出处理方法。
- 准备游戏：确认 Java 21、运行库、服务器和对应版本模组；校验通过则复用，缺失或不完整时才下载补齐。同一版本继续使用原目录和缓存。第一次联网访问 Mojang、Fabric、GitHub、Maven 等可能耗时数分钟。
- 实际启动、连接玩家并保存冻结后，才显示 准备完成 并允许 开始冒险。
普通用户无需安装 Git、Python 或 JDK，也不需要构建模组；失败时会显示步骤、原因与重试/选择目录等操作，「复制诊断信息」便于反馈。
作为通用 MCP 使用¶
游戏准备完成后，在兼容 stdio MCP 的客户端配置（路径需改为你本机实际位置）：
{"mcpServers":{"minecraft-native":{"command":"node","args":["C:/projects/minecraft-native-mcp/src/mcp-server.mjs","--launch"]}}}
--launch 会启动游戏并等待工具指令，不启动 DeepSeek 自主循环，也不要求 DeepSeek 密钥。独立 MCP 需要 Node 22.16+。已有运行中的原生实例可省略 --launch，用 FISH_BRIDGE_CONFIG 指定本机认证配置。避免多个控制器同时控制同一角色。
文件、升级与卸载¶
默认工作目录为 $DSH_HOME/minecraft-native-mcp（通常在用户目录 .dsh 下）：data 存世界和记忆，runtime 存便携工具及下载缓存，logs 存运行日志。
升级前保存停止并退出控制台，再更新插件并重开 DSH。卸载基础版：
dsh plugin --profile desktop remove minecraft-native-mcp
可选扩展：
dsh plugin --profile desktop remove dsh-minecraft-stream
重开 DSH 后生效；清理工作目录前请先备份世界。
适用场景与注意¶
适合：希望在 DSH 工作流里用 DeepSeek 驱动原生 Fabric 生存局、需要空间摘要与有界连续动作（矿道、战斗、容器操作）的开发者或实验用户；需要在直播画面叠加模型目标与行动气泡时可选用 stream 扩展。
边界与验证（以 README 为准）：
- 当前支持平台：Windows x64；DSH 0.2.0-rc.2 为本机验证版本。
- 逐游戏版本的编译/真实启动/挖掘/截图证据见仓库 兼容表。
- 完整无人值守生存、连续长局与末影龙通关仍未验收。
- 插件只停止自己启动的进程；无系统服务、开机启动、管理员安装或全局 PATH 修改。
结尾¶
Minecraft Native MCP 把「原生 Java 生存 + MCP 有界动作 + DSH 一键控制台」收进同一插件：DSH 侧用 release 包安装即可开玩，进阶用户可把同一套 MCP 挂到其他客户端。目录与详情见 SkillHub 插件页，源码与文档见 GitHub：tianyingAquila/minecraft-native-mcp。
