開啟DSW執行個體的MCP服務後,即可將其接入Agent用戶端,讓Agent直接在執行個體中執行命令、讀寫檔案、運行代碼,實現雲端開發工作單位的智能託管。
前提條件
DSW執行個體或所屬的資源配額已配置VPC及安全性群組。
應用情境
將DSW執行個體接入Agent後,相當於給 Agent 開通了一台隨時可用的雲端開發機。它可以直接在執行個體裡讀寫代碼、執行命令、跑實驗,把您從重複的環境操作中解放出來。典型情境包括:
遠程代碼開發與調試:讓Agent在執行個體中建立、修改代碼並運行,自動定位報錯、修複後重跑,完成一個功能的閉環開發。
環境準備與依賴管理:一句話讓Agent安裝缺失的Python或系統依賴、檢查CUDA與架構版本、校正運行環境,省去逐條敲命令。
訓練與實驗任務託管:Agent啟動訓練指令碼後非同步等待,期間查看日誌、監控輸出,訓練結束自動匯總結果。
資料處理與文檔整理:批量檢索、清洗執行個體內的資料檔案,或把網頁、PDF、Office文檔轉成Markdown供後續分析。
操作步驟
步驟一:建立DSW執行個體並開啟MCP服務
開啟MCP服務共分三步:開啟服務開關、產生訪問憑證、在安全性群組允許存取連接埠。完成後,Agent即可通過MCP協議訪問該執行個體。
開啟MCP服務開關。以使用公用資源建立執行個體為例,建立DSW時配置以下關鍵參數,其他參數按需配置即可。
已存在的執行個體可在執行個體列表頁,單擊操作列下的變更配置,重新設定DSW執行個體。
资源类型:選擇公用資源。
专有网络配置:選擇同地區下的Virtual Private Cloud。必須配置VPC才能啟用MCP服務。
安全组:選擇建立的安全性群組。
交换机:選擇建立的交換器。
启用MCP服务:開啟開關。開啟後會出現名稱為MCP的服務,預設監聽執行個體的9806連接埠。
若要從公網訪問DSW執行個體(例如通過本地Agent串連),還需配置以下參數:
服务访问与端口配置:
公网访问:勾選。
公网访问端口:如1078。
从公网访问实例:選擇DNAT + EIP
NAT网关:選擇建立的NAT Gateway。
弹性公网IP:選擇NAT Gateway關聯的EIP。
配置完成後,單擊确定建立執行個體。
產生訪問憑證。DSW執行個體建立完成後,單擊執行個體名稱進入詳情頁面,在访问配置地區,單擊產生訪問憑證。該憑證用於Agent調用MCP服務時的身份鑒權,調用時以Bearer Token形式放入要求標頭。
至此,您得到了MCP的接入地址和訪問憑證。
說明憑證有效期間預設為7天,到期後可在同一位置重建;重建後需同步更新Agent側配置中的憑證。
步驟二:安全性群組允許存取連接埠和IP
在DSW詳情頁网络信息地區,單擊安全性群組名稱跳轉至安全性群組詳情頁面。在入方向頁簽單擊增加規則,配置以下參數,其他參數預設即可。
訪問來源:填寫Agent部署位置的IP地址(例如運行Agent的本地電腦公網出口IP)。
訪問目的(本執行個體):填寫9806連接埠。
步驟三:Agent串連到DSW執行個體
DSW MCP服務採用標準Streamable HTTP協議,主流Agent用戶端均可接入。開啟Agent用戶端(如Open Code、Qoder CLI),將以下提示詞發給Agent,替換其中的<MCP接入地址>和<訪問憑證>為實際值,Agent將自動完成MCP接入。
如果使用本地Agent用戶端串連DSW執行個體,MCP接入地址應該使用公網的接入地址。
幫我添加一個 MCP 伺服器,名稱 dsw-mcp,協議 Streamable HTTP,地址 http://<MCP接入地址>,要求標頭加 Authorization: Bearer <訪問憑證>。請按照你的 MCP 配置方式自動完成設定。串連完成後,您可以在Agent用戶端中輸入以下命令測試聯通性。
幫我在dsw的/mnt/workspace目錄下建立一個hello_world的python代碼檔案執行完成後,開啟DSW執行個體,可以看到在工作區產生的hello_world.py檔案。
支援的工具集
DSW MCP服務通過標準Streamable HTTP協議提供一組工具,Agent串連後自動載入工具清單。工具分為Shell、檔案、系統、格式轉換、代碼五類,共16個。
Shell域(5個)
在執行個體內執行命令,連續命令共用工作目錄,適合跑指令碼、裝依賴、啟動訓練。
工具 | 功能 | 關鍵參數 |
| 執行shell命令 | cmd(必填)、cwd、new_session、timeout |
| 查看會話累積輸出與狀態 | session_id、limit |
| 等待非同步命令執行完成 | session_id、seconds |
| 向運行中的進程發送輸入 | session_id、input、press_enter |
| 終止並清理會話 | session_id |
檔案域(7個)
讀寫、檢索、編輯執行個體內的檔案。
工具 | 功能 | 關鍵參數 |
| 讀取檔案內容(可按行範圍) | path(必填)、start_line、end_line、sudo |
| 寫入/追加檔案,支援base64二進位 | path、content、encoding、append |
| 檔案內全域替換字串 | path、old_str、new_str |
| 正則搜尋檔案內容 | path、regex |
| 按glob尋找檔案 | path、pattern |
| 列目錄(支援遞迴、按類型過濾) | path、recursive、file_types |
| 支援撤銷的編輯器 | command(view/create/str_replace/insert/undo_edit)、path等 |
系統域(2個)
查詢執行個體環境與已安裝依賴。
工具 | 功能 | 關鍵參數 |
| 查詢執行個體環境(OS/Python/Node/可用工具) | 無 |
| 列出已安裝的Python/Node.js包 | language |
格式轉換域(1個)
工具 | 功能 | 關鍵參數 |
| 將網頁/PDF/Office/圖片等轉為Markdown | uri |
代碼域(1個)
工具 | 功能 | 關鍵參數 |
| 執行代碼(當前支援Python) | code、language、timeout |
開啟MCP服務後,以上工具立即可用,無需額外配置。