前言¶
在 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。
