跳到主要內容
Lab Grimoire
TW EN
請喝咖啡
docmd:零配置 AI 優先文件引擎,內建 MCP Server 與 llms.txt 自動生成
回到文章總覽
by CY

docmd:零配置 AI 優先文件引擎,內建 MCP Server 與 llms.txt 自動生成


docmd:零配置 AI 優先文件引擎

Best For

已經在用 Markdown 撰寫文件、卻缺乏統一瀏覽與搜尋介面的開發者和研究人員。如果你的工作流需要讓 AI agent 透過 MCP Server 直接查閱文件,或是想在 build 階段自動產出 llms.txt 作為 AI 情境來源,docmd 在這裡有明顯優勢。

How I Actually Use It

本篇評測依據官方文件、GitHub repo 與 Live Editor 線上 demo,尚未完成完整本地安裝。

工作流很直覺:把 Markdown 目錄指向 docmd,跑 npx @docmd/core dev,它自動掃描資料夾結構、產生導覽列並啟動本機預覽。正式建置時輸出靜態 HTML,同時自動生成 llms.txt 和 llms-full.txt。要讓 AI agent 存取文件,跑 docmd mcp 啟動 stdio 模式的 MCP Server,agent 就能直接搜尋、讀取、驗證文件內容。

搬遷值得一提:docmd migrate 支援從 Docusaurus、VitePress、MkDocs 一步完成遷移,既有專案不必從頭來過。

Where It Is Strong

  • 零配置:自動偵測 Markdown 目錄結構並產生導覽,不需要撰寫任何設定檔
  • 極度輕量:初始 payload 約 18kb,相較 Docusaurus 約 250kb 輕了一個數量級
  • AI 原生設計:內建 MCP Server 供 agent 存取,自動生成 llms.txt 作為 AI 情境
  • 豐富內建外掛:離線搜尋、SEO、sitemap、git 歷史、Mermaid 圖表、OpenAPI 渲染
  • 遷移支援:一行指令從 Docusaurus、VitePress、MkDocs 搬遷
  • 容器化部署:官方 Docker 映像 ghcr.io/docmd-io/docmd

Where It Fails

  • 生態系仍小:社群外掛遠少於 Docusaurus 或 VitePress,客製化選項有限
  • 快速疊代中:專案版本更新頻繁,API 可能在版本間變動
  • Node.js 相依:對純 Python 或非 JS 工具鏈的團隊會產生輕微摩擦
  • 不適合複雜應用:若需要深度主題客製、互動元件或完整 React/Vue 整合,Docusaurus 或 VitePress 仍是更好的選擇

Pricing, Difficulty, and Risk

價格:完全免費開源,MIT 授權。無付費方案、無用量限制。

上手門檻:入門等級。一行 npx 指令即可啟動,只需熟悉 Markdown 與基本終端機操作。

風險:專案相對年輕,長期維護尚待觀察。輸出為純靜態 HTML,不存在伺服器端執行風險。MCP Server 以 stdio 模式運作,僅限本機通訊。作為 npm 套件,繼承標準 npm 供應鏈風險。

Verdict

手上有一堆 Markdown 想在一分鐘內變成文件站,docmd 是我目前找到最輕量的方案。內建 MCP Server 讓 AI agent 直接查閱文件這點不是噱頭,是真正有用的差異化功能。但若需要深度主題客製或龐大的外掛生態系,可以先觀望。

Source

常見問題

docmd 跟 Docusaurus 比起來如何?

docmd 初始載入約 18kb(Docusaurus 約 250kb),零配置,內建 MCP Server 供 AI Agent 存取。Docusaurus 有更大的外掛生態系和更深的主題客製能力。要速度和簡潔選 docmd,要客製化選 Docusaurus。

AI Agent 能透過 docmd 讀取我的文件嗎?

可以。執行 docmd mcp 啟動 stdio 模式的 MCP Server,Claude Desktop、Cursor 或 VS Code 中的 AI Agent 就能直接搜尋、讀取、驗證文件內容。

能從現有文件工具遷移嗎?

可以。docmd migrate 指令支援從 Docusaurus、VitePress、MkDocs 一步完成遷移。

覺得這篇有幫助?

追蹤以收到新的 AI × 生醫研究筆記:

或請我喝杯咖啡,讓新內容持續產出。

☕ 請我喝杯咖啡