跳到主要內容

部落格

不定期分享最新資訊文章

  • article-Codex × Concat 實測:打造 AI 短影音自動剪輯工作流

    2026/10/18

    Codex MCP 影音行銷
    Codex × Concat 實測:打造 AI 短影音自動剪輯工作流

    以前要做一支短影音,得自己找素材、排時間軸、剪接、上字幕、配樂,再匯出影片。AI 即使幫忙寫好文案,接下來仍要打開剪輯軟體,一段一段手動調整。 最近我改用開源剪輯軟體 Concat 做了一次實驗:讓 Codex 透過本機 MCP Bridge 呼叫 Concat 的 API,先輸出短測試片,再完成一支 30 秒招生短影音。接著,我把反覆驗證過的操作方式整理成專案內的 concat-video-editor Skill,讓剪輯流程可以再次使用。 這次經驗最有意思的地方,不是「講一句話就能剪出完美影片」,而是把一套剪輯流程拆成 Codex 能執行、檢查和重複操作的步驟。 本文記錄的是 2026 年 10 月 18 日,以 Concat 0.2.7 進行的本機實測。Concat 仍在持續開發,功能與 API 可能更新。官方 MCP 文件當日仍標示內建 MCP 尚未發布;同日的 Issue #337 則宣布官方開始投入內建 MCP 傳輸的開發。若要照本文操作,請先查看官方最新版本與文件。 Concat、MCP Bridge 和 Skill 各自負責什麼?Concat 是一套本機影片剪輯軟體,提供多軌時間軸、動態文字、配樂等剪輯能力,也有可供程式呼叫的 JSON-RPC API。這次實測使用的是 Concat 0.2.7。 串接時有三個容易混淆的部分: 元件 工作 這次實作 Concat API 讓外部程式呼叫剪輯功能 使用 Concat 提供的本機 JSON-RPC API MCP Bridge 把 AI 工具的 MCP 呼叫轉成 Concat API 指令 自行建立的本機 Python Bridge Skill 告訴 Codex 如何依照 SOP 規劃剪輯、操作和驗收 專案內的 concat-video-editor Skill 可把整體流程想成: 123456789剪輯需求 → Codex → concat-video-editor Skill ↓ MCP Bridge ↓ Concat JSON-RPC API ↓ 時間軸、影片與剪輯專案 ↓ 輸出與驗收 Bridge 解決「怎麼連上工具」;Skill 解決「連上之後怎麼按照規則完成工作」。只有 Skill、沒有可用的 MCP 連線,Codex 就不能呼叫 Concat;只有 Bridge、沒有剪輯 SOP,也不代表每次操作都會排出正確時間軸。 先看清楚 Concat 的 MCP 狀態這篇的實測版本是 0.2.7。官方開發者文件在 2026 年 10 月 18 日標示:Concat 的 API 與 JSON-RPC 傳輸已存在,但正式隨產品發布的 MCP Server 尚未到位;官方提供的當下作法,是以一個 MCP Server 包裝 JSON-RPC socket。官方同日也在 Issue #337 宣布開始開發內建的 MCP 傳輸。因此,本文的 Bridge 是我當時實際建立與測試的方案,不能直接推論為目前所有版本都需要自建 Bridge。 建立本機 Bridge:先連線,再操作剪輯這次使用 Apple Silicon MacBook Pro M2。Bridge 以 Python FastMCP 建立,共提供 22 個 MCP 工具,涵蓋專案管理、媒體匯入、片段編輯、文字、預覽影格、匯出及工作狀態查詢。這是我自行實作的工具數量,不代表 Concat 官方 MCP Server 的工具清單。 Concat Remote API 在本機監聽,例如 127.0.0.1:7420,並使用 Token 驗證。我的 Bridge 將 Token 放在本機環境檔,限制檔案權限,不把憑證寫進程式碼或公開文章。實際設定時也應把專案與輸出限制在指定工作資料夾,並先用全新的測試專案驗證。 在修改 Codex 的 MCP 設定前,我先備份原設定,再請 Codex 依實際位置填入 Bridge 執行檔與程式路徑。這次的 Bridge 另外加入了 macOS 自動啟動:連線被拒絕時,嘗試執行 /usr/bin/open -g -b app.concat.editor,最多等 15 秒讓 Remote API 就緒。這是我自行加入的 Bridge 功能,不是每一套串接都會自動啟動 Concat;一般情況仍要先開啟軟體。 Codex 的 MCP 設定會指向本機 Python 執行環境與 Bridge 程式,概念如下;路徑要換成自己的實際位置: 12345[mcp_servers.concat]command = "/你的工作目錄/.venv/bin/python"args = ["-u", "/你的工作目錄/concat_mcp.py"]startup_timeout_sec = 20tool_timeout_sec = 90 註冊後重新載入 MCP,再先做唯讀連線檢查: 123請呼叫 concat_version,回報 Concat 版本、API 版本、apiCompatible、可用能力與目前 MCP 工具。不要建立、修改或刪除任何專案。 我當時讀到的結果是 Concat 0.2.7、API 0.2、apiCompatible: true,能力包含 events 與 json-rpc。這只表示 Bridge 能連上相容的 API,還沒有證明影片可以順利匯出;因此下一步應用新測試專案完成端到端驗證。 先輸出一支 2.5 秒測試片我先使用簡單測試影片與繁體中文標題「Codex 連線測試」,輸出約 2.5 秒的 H.264 MP4。測試同時檢查: 匯出工作是否收到 export.done。 解析度、影格率、片長是否符合預期。 影片與音訊能否完整解碼。 指定時間點的預覽影格是否正確。 Concat 原生專案能否儲存與重新開啟。 原始測試素材是否保持不變。 匯出工具回傳「已啟動」不等於檔案已完成。Concat 的匯出工作是非同步的,必須追蹤 job 並等待完成事件;若連線在等待期間中斷,也先確認舊工作與輸出狀態,再決定是否重跑,避免重複輸出。 再完成 30 秒招生短影音小測試通過後,我才交給 Codex 三段素材與一段已授權的配樂,製作「AI 新時代」招生短影音。需求是: 9:16 直式,輸出 1080 × 1920。 整理操作畫面精華,加入大字文案與簡單動態文字。 不加旁白,搭配背景音樂。 片尾安排課程名稱與「立即洽詢課程」CTA。 保留原始素材和 Concat 專案,輸出新版本,不上傳、不發布。 最後輸出 AI新時代-30秒招生短影音-v02.mp4,並檢查片長、影像與音訊。這次成果證明的是:在這批素材與這套工作流程下,Codex 能透過 Concat 完成一支 30 秒影片;它不能代表任何素材、長度或畫幅都會有同樣結果。 把成功流程封裝成 concat-video-editor Skill第一次剪成功後,我把如何讀取素材、挑選片段、安排軌道、加文字和配樂、等待匯出、檢查結果等操作,整理成專案內的 concat-video-editor Skill。它保留在專案裡,不修改全域 Skill,也不包含 MCP Bridge、Python 虛擬環境或 Token。使用 Skill 前,Bridge 必須已經能正常連線。 固定規格的影片可以再寫成 manifest.json,例如設定畫幅、片長、幀率、片尾長度、文字與素材路徑: 123456789101112131415161718{ "ratio": "9:16", "duration": 30, "fps": 30, "cta_duration": 5, "title": "AI 新時代", "cta": "立即洽詢課程", "sources": [ { "path": "/完整路徑/A.mp4", "headline": "把 AI 變成你的工作助力" }, { "path": "/完整路徑/B.mp4", "headline": "課堂現場直接動手實作" } ]} 若沒有指定來源入點,這次的腳本會依素材順序分配片長並擷取中央區域;也能為素材指定 source_start 和 duration。但設定時間碼不等於 AI 已理解影片內容。若要挑出講師最精彩的一句話或最有感染力的畫面,仍要另外進行語音、影格或語意分析。 使用者不一定要自己撰寫 JSON。可以先請 Codex 根據需求整理 manifest,再用 –plan-only 預覽剪輯計畫,確認素材、時間與輸出規格後才執行。正式操作要在正確專案目錄進行,並避免覆蓋來源影片與既有版本。 為了保留可回復的成果,這次 Skill 也讓每次輸出使用遞增版本,例如 v001、v002、v003,不覆蓋先前影片;整合測試還比對舊版本的雜湊,確認它沒有被重跑流程改寫。 四輪整合測試與實際遇到的問題為了確認 Skill 不只對單一招生影片有效,我另外製作了三種解析度與影格率的合成測試影片,以及一段 WAV 配樂: 橫式 960 × 540、30 fps。 直式 540 × 960、25 fps。 方形 720 × 720、24 fps。 30 秒 WAV 音樂。 四輪測試各輸出 30 秒、30 fps、900 影格的影片,涵蓋建立專案、匯入素材、多軌剪輯、文字與 CTA、配樂混音、H.264/AAC 匯出、影格與音訊檢查,以及儲存、重開、修改、還原專案。測試也比對來源素材雜湊,確認原檔沒有變動,並檢查新版本不會覆蓋舊檔。 機器驗收全數通過,Codex 也檢視輸出影片的關鍵影格與文字效果。不過,完整播放、人耳聽感與 GUI 操作體驗仍需要人工檢查。規格檢查通過,不等於影片節奏、文案與音樂一定適合觀眾。 遇到的狀況 原因與修正方式 片段位置沒有落在預期時間 不同欄位要用對應的 API 命令。這次以 trimClip、moveClips 處理裁切與移動,操作後重新讀取時間軸確認位置。 標題被排到影片後面 同一軌道的片段可能互相推移。影片、標題、補充文字、品牌字樣與 CTA 視需要分軌,新增後再檢查時間軸。 時間軸有文字,輸出畫面卻看不到 文字本身的垂直位移和動畫位移疊加,可能把文字推到畫面外。要從實際輸出的 MP4 擷取影格確認。 裁切後片段短到不合理 裁切順序受相鄰片段影響。先移到沒有相鄰片段干擾的位置裁切,確認來源入點與片長後再移回時間軸。 有 AAC 音軌但聽起來太小聲 有音訊軌不代表混音合適。除了檢查峰值與訊號,也要實際聆聽人聲和配樂的平衡。 這些修正最後都寫回 Skill,讓下一輪可以重用檢查步驟,而不是只記得「上次成功了」。 這套工作流目前做得到與做不到的事MCP 操作不等於語意剪輯腳本可以照固定規則安排素材,也能透過 MCP 呼叫剪輯功能;要讓 AI 真正理解人物說了什麼、哪個鏡頭最有感染力,再依敘事挑選片段,還需要額外的轉錄或影像分析流程。不能把依序平均分配片長說成 AI 已完成精彩片段判斷。 本機 API 不會讓 Codex Cloud 直接連到你的 Mac127.0.0.1 指的是目前執行程式的那台電腦。Codex Cloud 裡的 127.0.0.1 是雲端執行環境,不是使用者的 Mac。本文這套 Bridge 因此以本機 Codex App 或 CLI 為使用情境。 GUI 正在開啟的專案有使用限制在 0.2.7 實測中,Remote API 不能同時操作 GUI 正在持有的同一個專案。工作時要讓 MCP 操作未被 GUI 開啟的專案,完成後儲存、關閉,再由 GUI 重新打開檢查。官方 Issue #337 正在討論即時操作開啟中專案與 MCP 傳輸;此項限制應以實際使用的 Concat 版本為準。 語音、字幕功能要看介面和 Bridge 有沒有串接Concat GUI 有文字轉語音與自動字幕功能,但我這次的 Bridge 沒有把這些功能包裝成 MCP 工具。測試完成的是文字標題、動態大字與 CTA;若要自動產生中文旁白或逐字字幕,還需要額外整合 TTS 或語音辨識,不能只因 GUI 有功能就宣稱 Bridge 已經支援。 若只是想先試 Concat 內建中文旁白,可以在 GUI 的語音設定下載 Kokoro compact 模型;官方教學列出的檔案大小約 132 MB。這是軟體介面裡的功能,和這次 MCP Bridge 有沒有提供 TTS 工具是兩回事。 三種畫幅測試不代表長片或 4K 保證可用這次測過 9:16、16:9、1:1,仍要針對每種畫幅重新檢查人物位置、文字換行與安全區。短影音成功也不代表一小時影片或 4K 專案有相同速度;素材數量、編碼、特效、記憶體與長度都會影響結果。初次練習可從 15~30 秒、1080p 開始。 費用也要拆開看:Concat 本身是免費開源軟體;Codex 的模型使用則取決於方案或 API 計費,電腦運算與儲存空間、外部 TTS 或音樂服務也可能有成本。 新手可以照五個階段練習 先會用 Concat:匯入影片、放到時間軸、加入標題並輸出 MP4。 再連上 Codex:建立 Bridge、設定 Token,唯讀呼叫版本資訊確認 API 相容。 完成最小測試:用新專案輸出 2~3 秒影片,檢查影片、音訊和匯出完成事件。 試做 30 秒短片:加入多段素材、動態文案、配樂和片尾 CTA,保留素材與專案。 最後封裝 Skill:把成功步驟、錯誤修正、驗收方式整理成可重複使用的工作流程,再用不同素材和畫幅測試。 如果你也在整理 AI 影片流程,可以延伸閱讀從 Shot List 到粗剪的 AI 短片製片 SOP。本篇則聚焦在另一個環節:讓 AI Agent 透過 API 實際操作剪輯軟體。 結語:把剪輯判斷整理成可以重複執行的規則這次我從第一次不知道該下載哪個語音模型,到建立本機 Bridge、匯出 2.5 秒測試片、完成 30 秒招生短影音,再把流程封裝成 Skill。過程中遇到時間軸跑位、片段裁太短、文字消失和音樂太小聲,逐一找出原因後再把修正方法寫進 SOP。 AI Agent 的價值不在於保證一句話就剪出神片,而是讓一次成功的工作經驗成為下一次可以檢查、修改和重複執行的能力。剪輯判斷仍然重要:你要知道什麼畫面好看、節奏是否合理,再把這些標準講清楚,才能讓 AI 照著做並協助驗收。 常見問答 (FAQ)Q1:讓 Codex 操作 Concat,需要準備哪些東西?需要可使用的 Concat 本機 API、一個相容的 MCP Bridge,以及 Codex 的 MCP 設定。若還希望 Codex 按照固定剪輯 SOP 工作,再加上 Skill。Token 應保存在本機的安全設定中,不要放進程式碼或公開內容。 Q2:Concat 0.2.7 已經內建 MCP Server 了嗎?依 2026 年 10 月 18 日的官方開發者文件,內建 MCP Server 當時尚未隨產品發布,文件提供以 MCP 包裝 JSON-RPC 的 Bridge 作法。官方同日宣布開始開發內建 MCP 傳輸;請在實際操作前確認最新 release 與文件。 Q3:這個 Skill 能自動找出影片中最精彩的片段嗎?不能只靠固定剪輯腳本做到。腳本可以依素材順序、入點和片長安排時間軸;要根據講話內容或畫面情緒挑選精彩片段,還需要語音轉錄或影像理解等分析步驟。 Q4:為什麼 Codex Cloud 不能直接操作我 Mac 上的 Concat?Bridge 連到的是本機 127.0.0.1。在雲端執行時,這個位址指向雲端環境本身,不會自動連回使用者的 Mac。因此本文流程使用本機 Codex App 或 CLI。 Q5:Concat 有配音和自動字幕,為什麼 Bridge 沒有?軟體 GUI 有某項功能,不代表 MCP Bridge 已經把它做成可呼叫的工具。這次的 22 個自製工具沒有直接包裝 TTS 或語音辨識;若要納入自動流程,需要另外接好相應工具並驗證輸出。 官方資源與本次實測參考 Concat GitHub 專案 Concat 官方下載與版本 Concat MCP 開發者文件 Concat JSON-RPC 文件 Concat API 方法 Concat 文字轉語音教學 Codex MCP 設定說明 本次實測資料:Concat MCP Bridge README、Concat MCP 測試報告(2026/10/18)、concat-video-editor Skill v001、Skill 四輪整合測試報告。 本文依據 2026 年 10 月 18 日的本機實測與當時官方文件整理。Concat 仍在持續開發,未來的功能、介面與 MCP 支援方式可能不同。

  • article-Public APIs 開始收錄 MCP Server:48 萬 Star 的工具清單怎麼用?

    2026/10/1

    AI工具 AI Agent MCP
    Public APIs 開始收錄 MCP Server:48 萬 Star 的工具清單怎麼用?

    最近整理 Skill Library 時,我發現自己收藏了不少 MCP,真正要做事時卻還是得重新搜尋:「有沒有 Gmail MCP?」「哪個 MCP 能查 YouTube?」接著逐一看 README、確認維護狀況、安裝方式和需要的權限。 這讓我重新注意到 GitHub 上的 public-apis/public-apis 專案。它原本以公開 API 分類清單聞名,現在也加上 MCP Servers 區塊。我查閱時,GitHub 顯示約 48.5 萬顆 Star;電腦王阿達在 2026 年 9 月 5 日的介紹則記錄當時已超過 47 萬顆。Star 數會變動,這裡的數字只是查閱時的快照。 比起多收藏一個目錄,我更想建立一個流程:先說清楚工作需要什麼能力,再讓 Agent 找候選工具、比較限制,最後才決定要不要安裝 MCP。 Public APIs 的 MCP 清單有什麼不同?Public APIs 原本把公開 API 依用途分類,例如 Weather、Finance、Email、Geocoding、Government、Video 等。清單除了名稱與說明,也會列出驗證方式、HTTPS 和 CORS 等資訊,方便開發者先篩選資料來源。 README 現在另有 MCP Servers 表格,欄位包含名稱、用途、驗證方式、Transport 和安裝入口。查閱時可看到 OpenSwissData、IPstack MCP、GitHub、Filesystem 等項目。這些資料讓讀者先比較需要什麼驗證、支援哪種傳輸方式,再前往專案或安裝目錄查看細節。 它的特色不是 MCP 數量最多,而是從「我需要天氣、金融或檔案能力」這類需求出發,再找可能的 API 或 MCP。要做天氣網站,直接呼叫 API 也許就夠;若 Agent 要在多次任務中反覆查詢或執行操作,MCP 才可能比較合適。 另外,清單名稱裡的「免費 API」不代表每個服務都能無限制免費使用。實際費率、免費額度、API Key 和使用條款都要再到服務官方文件確認。 API、MCP 和 Skill 各自負責什麼?這三者不是互相取代的工具,而是處理不同層次的問題: 元件 負責的事情 常見用法 API 服務提供的資料或操作介面 網站或程式依服務文件發送請求、處理回應 MCP Server 依 MCP 協定,把工具或其他上下文能力提供給相容的 Agent 讓 Agent 透過標準介面呼叫搜尋、檔案或服務工具 Skill 說明 Agent 怎麼完成一類工作 把需求拆解、檢查步驟和交付格式整理成可重複使用的 SOP MCP Server 有時會在背後呼叫 API,但 MCP 並不是 API 的另一個名稱;有些 API 也沒有對應 MCP。Skill 則可以教 Agent 如何呼叫已設定的 MCP,也可以規定何時直接用 API。 若你還想釐清 MCP、Skill 與 CLI 的分工,可以接著看一次搞懂 MCP、Skill 與 CLI 的差異。Skill 與 Plugin 的組合方式則整理在從個人工作流到團隊交付。 找 MCP 時可以先看哪幾個地方?我會依照需求和想確認的資訊,從以下入口開始找。它們的定位不同,搜尋結果也不等於品質或安全保證。 1. Official MCP Registry:查官方登錄資料Official MCP Registry 是 MCP 專案提供的公開 Server 目錄,可以搜尋 Server 名稱與版本,並查看其 metadata。它適合用來確認某個項目是否有公開登錄,以及對應的專案或套件資訊。 不過,「出現在 Registry」不等於「經過完整安全審核」。Registry 的資料由 Server 維護者發布,使用者仍要核對來源、版本和權限;官方說明也提到社群可檢舉違規項目,由維護者處理。 2. Public APIs:從需要的能力開始找如果你還不確定該找 API 還是 MCP,可以先按資料類型或用途查 Public APIs。MCP 區塊的清單目前較精簡,優點是會把 MCP 放在原有 API 資源旁邊,讓你比較是直接呼叫 API,還是透過 Agent 使用 MCP。 3. Glama:用搜尋與篩選比較大量候選Glama MCP Servers 提供伺服器索引與搜尋,頁面可按更新日期、GitHub Star、套件下載量等條件排序。網站在 2026 年 10 月 1 日查閱時顯示約 94,668 個 Server。索引數量會改變,應以網站當下顯示為準,也別只看總數或 Star 就決定安裝。 4. Smithery:搜尋並查看伺服器管理入口Smithery 提供類別與條件篩選,並展示部分 Server 的使用資訊。頁面在 2026 年 10 月 1 日查閱時顯示 13,151 個搜尋結果。平台和目錄功能可能持續調整,因此安裝方式、方案和服務狀態要回到當下的官方說明確認。 5. GitHub 與服務官方文件:確認實作細節找到候選項目後,接著查它連結的原始 Repository 和服務官方文件。目錄摘要可以幫你發現項目,卻無法代替版本紀錄、License、安裝需求、OAuth 範圍、API 費用及原始碼審查。 用 MCP Scout 把搜尋變成工作流程與其在看到「必裝 MCP 清單」時一律先收藏,我會希望 Agent 在開始實作前先做需求分析:完成任務需要哪些資料、外部服務和操作權限?是否已經有可用的 MCP?直接呼叫 API 或使用 CLI 會不會更簡單? 這個想法可以整理成一個 MCP Scout Skill。它不負責直接替你安裝工具,而是先找候選、標示來源與限制,再提出方案供你決定: 1234567891011121314151617181920你是我的 MCP Scout。我要完成以下工作:{{工作需求}}先分析需求並搜尋工具,不要直接開始實作、安裝或執行候選項目。第一階段:拆解需求列出完成工作需要的資料、操作與外部服務,例如搜尋、檔案、Database、Email、Calendar、Browser 或 SaaS。第二階段:搜尋候選依序查看 Official MCP Registry、public-apis/public-apis、Glama、Smithery、GitHub 與服務官方文件。最多列出 3 個候選,附上來源連結;清楚標示官方或社群專案,找不到證據時不要猜。第三階段:比較限制逐一整理提供的 Tools、Repository、License、最近更新、Transport、Agent 相容性、API Key 或 OAuth、費用、權限範圍,以及是否會讀寫本機檔案或執行 Shell。每個判斷都附上可查證的來源。第四階段:提出選擇比較使用現有 MCP、直接使用 API/SDK/CLI,或自行建立 MCP 的建置時間、維護成本、安全性、穩定性與可移植性,說明適合的方案與原因。先交付搜尋結果與建議,等待我確認後才進行安裝或授權設定。 這段流程的重點是先把需求和風險攤開來,不要讓搜尋結果直接變成安裝指令。MCP Scout 可以協助找資料,但不能只憑目錄標籤就替候選項目背書。 不需要為每件事都加上 MCP我會用三個問題快速選擇: 只是要取得一份資料或完成一次操作? 先看 API、SDK 或 CLI 是否更直接。 Agent 是否要在不同任務中反覆使用同一項能力? 再評估 MCP 的介面和維護成本。 真正需要保存的是工作步驟嗎? 把判斷方法整理成 Skill;需要工具時,再讓 Skill 指向 API 或 MCP。 例如天氣網站可以直接呼叫天氣 API;如果多個 Agent 都要在對話中查詢天氣、比較時段並安排活動,MCP 可能更容易重複使用。工具是否值得封裝,仍取決於實際使用頻率、權限需求和維護成本。 最後,我想收藏的不是更多 MCP 名稱,而是一條遇到需求時找工具、核對來源、比較限制的路徑。當 Skill 知道何時呼叫 MCP,Agent 又知道缺工具時該去哪裡找,工具庫才會從收藏清單變成真正能使用的工作流程。 常見問答 (FAQ)Q1:Public APIs 的 MCP Servers 清單適合拿來做什麼?它適合從 API 類別或能力需求出發,快速發現少量相關 MCP,並查看簡介、驗證方式、Transport 和安裝入口。找到候選後,仍應到 Repository 和官方文件確認細節。 Q2:要去哪裡搜尋 MCP Server?可以先看 Official MCP Registry 的登錄資料,再用 Public APIs 按需求找候選,或用 Glama、Smithery 搜尋和篩選。最後回到 GitHub Repository 及服務官方文件確認版本、授權、費用與權限。 Q3:怎麼判斷 MCP Server 是否適合安裝?至少要確認維護者與 Repository、License、最近更新、安裝程序、Transport、憑證和費用,以及它要求的檔案、網路或 Shell 權限。目錄列出項目不等於安全認證;對高權限工具,應先檢查程式碼並在受限環境評估。 Q4:MCP、API 和 Skill 要怎麼選?一次性或單純的資料請求可先用 API、SDK 或 CLI;需要讓 Agent 以一致介面反覆呼叫的能力,可評估 MCP;需要重複遵循的工作方法則適合整理成 Skill。三者也能搭配使用。 Q5:MCP Scout 可以自動安裝它找到的 MCP 嗎?MCP Scout 可以整理需求、搜尋候選和比較限制,但搜尋結果不能代替程式碼審查或權限判斷。建議先讓它提交來源和評估結果,經人確認後再安裝、提供憑證或授予本機權限。 參考資料 電腦王阿達|Public APIs 免費 API 資源庫介紹 GitHub|public-apis/public-apis MCP 官方專案|Introducing the MCP Registry Official MCP Registry Glama MCP Servers Smithery

  • article-華為「天才少年」把 AI Agent 寫成一本開源教科書,這幾章最值得先啃

    2026/9/22

    AI Agent Codex MCP
    華為「天才少年」把 AI Agent 寫成一本開源教科書,這幾章最值得先啃

    最近看到一個 GitHub 專案時,我原本以為又是一本 AI Agent 教學。 點進去之後才發現,規格有點誇張。 《深入理解 AI Agent:設計原理與工程實踐》不只免費開源,目前的 2.0 版還整理成:10 章正文、109 個配套實驗、PDF、EPUB、繁體中文版與 15 種語言版本,程式碼也一併公開。 我更在意的是,這不是把一堆工具名詞排在一起的入門書。它試圖回答一個更根本的問題:一個能在真實世界工作的 Agent 系統,到底要怎麼被設計出來? 作者李博杰的背景也讓這件事更有意思。公開資料顯示,他曾就讀中國科大少年班學院,完成中科大與微軟亞洲研究院聯合培養博士,並曾入選華為首批「天才少年」計畫;他的個人資料頁也列出系統、研究與工程相關經歷。中國科大資料與作者個人頁都可交叉參考。 所以我特別想看:一個實際做過系統、Infra、研究與工程的人,會怎麼拆解現在大家都在談的 AI Agent? 先記住這個公式:Agent = LLM + Context + Tools這本書一開始就把 Agent 壓成一個非常簡單的公式: Agent = LLM + Context + Tools LLM 是大腦:理解、推理、產生下一步。 Context 是它此刻知道什麼:任務、歷史、規則、檔案、記憶與工具描述。 Tools 是它做得到什麼:搜尋、查資料庫、改檔案、跑程式、操作瀏覽器或電腦。 看起來很簡單,但整本書就是沿著這三件事一路拆下去:Coding Agent、MCP、Computer Use、Memory、Multi-Agent,甚至 Agent 如何從執行紀錄持續進化。 這正是我覺得它值得讀的原因。 現在學 Agent,很容易學成「會 n8n、會串 API、會 MCP、會做 RAG、會用 Codex 或 Claude Code」。但這些其實比較像零件。 再往上一層,真正該問的是: 一個好的 Agent 系統,怎麼在正確的時候取得正確資訊、選對工具、完成任務,並且被驗證? 如果你已經開始用 Codex、Claude Code、MCP 或 Computer Use,我反而不建議一開始從第一章一路線性讀完。下面這幾章會更有感。 第一個最推薦:Context Engineering以前大家都在談 Prompt Engineering;但在 Agent 工作流裡,Prompt 往往只是 Context Engineering 的一小部分。 Agent 表現好不好,很大程度取決於: 它目前到底看到了哪些資訊? 哪些資料應該放進 Context,哪些要移出去? Skill 該在什麼時候載入? 對話與工作紀錄要如何壓縮? 工具說明要全部塞進去,還是動態發現? 工作做到一半 Context 撐不住時,系統要怎麼恢復? 書中的第二章直接談 KV Cache、提示工程、Agent Skills 與 Context Compression。對已經在使用 Coding Agent 的人來說,這一章的價值很高,因為你會開始理解:為什麼同一顆模型放在不同工作環境裡,結果可能差那麼多。 下一階段的競爭未必只是「哪個模型 IQ 更高」,而是: 誰能在正確的時候,把正確的 Context 給模型。 這也和我先前整理的從 Skill 到 Agent Harness很接近:模型能力只是其中一層,工作環境如何供應 Context、工具、規則與回饋,才決定它能不能把任務走完。 第二個必看:Tools 與 MCP第四章談工具,當然也包含 MCP;但我覺得比 MCP 名稱本身更重要的,是它背後的觀念: 工具就是 Agent 的手。 LLM 再聰明,如果只能產生文字,它仍然比較像聊天機器人。 接上搜尋,它能查資料;接上資料庫,它能查詢與寫入;接上 Gmail 或 ERP,它能處理企業流程;接上瀏覽器與 Computer Use,它甚至可以操作沒有 API 的網站與 GUI 軟體。 所以 MCP 不是終點,而是讓模型應用與外部能力更容易連接的介面。真正值得思考的是: Agent 怎麼知道現在需要哪一個工具? 工具描述是否足以讓它選對? 它沒有能力時,能不能發現並載入合適的 Skill、MCP 或 API? 任務結束後,怎麼把不必要的工具說明移出 Context? 這才是走向通用 Agent 的方向。若你還在釐清 MCP、Skill 與 CLI 的角色分工,可以先讀站內這篇:AI 工具名詞全解析。 第三個可以直接跳讀:Coding Agent這本書有一句我很喜歡: 程式碼,是「可以建立新工具的工具」。 這句話很能解釋,為什麼這一兩年 Coding Agent 會變得這麼重要。 以前的 Agent 遇到沒有工具的事情,可能只能停下來;現在的 Coding Agent 可以嘗試自己寫一個小工具、跑測試、修 bug,再拿這個程式完成原本的任務。 所以 Codex、Claude Code 真正值得注意的地方,不只是「幫你寫程式」,而是它們讓 Agent 開始具備擴充自己能力的能力。 當然,這不代表可以放任 Agent 任意執行。工具權限、Sandbox、測試、Review 與明確的完成條件,仍然是系統設計的一部分。會寫程式不等於任務一定完成;能測試、能回報、能被人驗收,才是可靠的工程流程。 第四個:從 Computer Use 看 Agent 的行動範圍過去自動化多半依賴 API、CLI、MCP 或 Browser Automation。但企業裡有大量系統根本沒有 API:ERP、MES、老舊 Windows 軟體、內部行政平台,甚至只能靠滑鼠點擊的工具。 這時候 Computer Use 的意義,就不只是「AI 會控制滑鼠」。書裡從兩個角度理解它: Observation Space:Agent 可以觀察到多少世界?文字、圖片、語音、螢幕,或實體環境。 Action Space:Agent 可以對世界做多少事?產生文字、呼叫工具、點擊 GUI,甚至控制機器人。 從這條線看,Agent 正在從聊天介面走向可以工作、可以觀察結果、也能根據結果再行動的代理人。 不過,Computer Use 也會把安全與可靠性問題放大:畫面改版、權限不足、不可逆操作、錯誤回饋不清楚,都需要在流程中設計 guardrail,而不是只追求「它能不能點」。 做企業 AI,一定要補:Agent Evaluation我覺得這是現在很多課程最容易略過、但企業最需要的一章。 我們常說 Claude 比較聰明、GPT 比較穩、Gemini 的 Context 比較大,或某個 Agent「感覺」比較好用。但當 Agent 要進入企業流程,不能只靠感覺。 更好的做法是建立自己的任務集,例如 100 個真實任務,然後觀察: 要測什麼 為什麼重要 成功率 任務是否真的被完成,而不只產生看似合理的回答 成本 Token、工具呼叫與人工覆核是否能負擔 延遲 工作流程是否能在可接受時間內交付 人工介入率 哪些步驟仍需要人,以及原因是什麼 重試次數 Agent 是否經常卡住、繞圈或選錯工具 錯誤類型 問題是 Context、工具、權限、模型還是流程設計 最後才有根據決定:哪個模型、哪個 Agent、哪種 Prompt、哪個 Harness,適合這一項工作。 Evaluation 不是最後才補的報表,而是用來推動系統改進的方向盤。 更接近「AI 員工」的關鍵:持續進化我自己也非常想看第九章的 Agent 持續進化。 現在很多所謂 AI 員工,本質上仍是: 固定 Prompt + 固定 Workflow + 幾個工具 它可以每天重複執行,但不一定會從結果學到東西。 更有意思的問題是:Agent 完成一個任務後,能不能留下可分析的執行軌跡(trajectory)?這次為什麼成功?失敗在哪裡?下一次要更新 Knowledge、Prompt、Skill、工具選擇,還是程式碼? 1234567891011任務 ↓執行 ↓留下 Trajectory ↓分析成功與失敗 ↓更新 Knowledge / Prompt / Skill / Code ↓下一次做得更好 這時候才開始接近「會成長的 AI 員工」,而不只是換了皮的 Chatbot。 前提是,你必須先有明確的成功標準與可觀測紀錄;否則 Agent 留下的只是一大串 log,沒有辦法轉成真正的改善訊號。 Multi-Agent 不是畫一張公司組織圖Multi-Agent 也很容易被玩成「行銷 Agent、PM Agent、工程 Agent、財務 Agent」排成一張組織圖。 但真正困難的工程問題反而是: Agent 之間應該分享多少 Context?哪些資訊必須隔離? 誰負責拆任務?誰擁有最後決策權? 交接資料如何結構化,才不會在對話中流失? Agent 意見衝突時怎麼處理? 怎麼避免它們彼此聊天、消耗 Token,卻沒有推進結果? 這些都是協作系統設計問題,不是多開幾個聊天視窗就會自然解決。 如果你已經會用 Agent,我建議這樣讀如果你已經在玩 Codex、Claude Code、MCP 或 Computer Use,我會建議先走這條路: 1234567Context Engineering → Tools / MCP → Coding Agent → Computer Use → Agent Evaluation → Agent 持續進化 → Multi-Agent 再回頭補 Memory / RAG、模型後訓練、SFT / RL,通常會更有感。因為你已經知道這些零件要被放進什麼樣的工作系統裡。 而且這套內容最棒的地方,不是只讓你讀。專案目前提供 109 個配套實驗,很多概念可以直接跑、直接觀察、直接改。比起再追 20 個剛推出的 AI 工具,我更想從中挑出大約 20 個最值得玩的實驗,再拿 Codex、Claude Code、MCP 與 Computer Use 重新實作一次。 工具會換,模型也會換;但 Context 如何設計、工具如何選擇、Memory 如何管理、Agent 如何評估、任務如何拆解、執行紀錄如何轉成改善,才是更能留下來的能力。 如果你最近也覺得 AI 工具已經多到追不完,或許現在正是回頭把「Agent 到底怎麼運作」真正弄懂一次的好時間。 資料來源與延伸閱讀 bojieli/ai-agent-book:深入理解 AI Agent:設計原理與工程實踐 作者李博杰公開個人資料 中國科大:李博杰獲 2017 年微軟學者獎學金 從 Skill 到 Agent Harness:讓 AI 從知道怎麼做,走到真正完成工作 常見問答 (FAQ)Q1:這本《深入理解 AI Agent》適合完全沒有程式背景的人嗎?可以先讀第一章建立全貌,但書內不少實驗需要讀懂並修改中等複雜度的 Python,並熟悉命令列、Git、JSON 與 REST API。若你的目標是實作,建議先從自己最常用的工具與一個小任務開始,再回頭閱讀對應章節。 Q2:為什麼已經會寫 Prompt,還要學 Context Engineering?Prompt 是一次交代模型怎麼回應的指令;Context Engineering 則處理整個工作過程中,哪些任務資料、歷史、規則、工具描述與記憶應該在何時被提供或移除。長任務與工具型 Agent 的品質,通常更受後者影響。 Q3:MCP 就是讓 AI Agent 變強的關鍵嗎?MCP 能讓模型應用以較一致的方式連接外部 Tools、Resources 與 Prompts,但它不是完整的 Agent 系統。工具選擇、權限、Context、錯誤處理、驗證與工作流程,仍需要由 Agent Harness 與產品設計處理。 Q4:企業要怎麼評估 Agent 是否真的可用?先建立由真實工作組成的任務集,為每個任務設定成功條件與不可接受的錯誤,再追蹤成功率、成本、延遲、人工介入率、重試次數與錯誤類型。不要只用單次展示或主觀體感選模型與工具。 Q5:Multi-Agent 一定比單一 Agent 好嗎?不一定。只有在任務能清楚分工、交接格式明確、資訊隔離與最終決策權都設計好時,多個 Agent 才可能帶來效益。若問題本來可由一個 Agent 穩定完成,多 Agent 反而可能增加成本、延遲與溝通失誤。