AgentMD

io.github.djrobson5由 GitHub 帳號 djrobson5 發布v0.1.4更新於 Oct 24, 2026

Convert PDF, DOCX, HTML, and URLs to clean, LLM-ready markdown with tables preserved

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取檔案與儲存

概覽

AI 產生的概覽

AgentMD 將 PDF、DOCX、HTML 與網頁 URL 轉成乾淨、適合大型語言模型閱讀的 Markdown,並保留表格,讓助理能讀取原本難以解析的文件。

可以做什麼
將網頁或 http(s) 連結上的文件轉為 Markdown,擷取正文、把連結解析為絕對網址,並以 GFM 表格保留表格。將手上已有的文件(PDF、DOCX、HTML、純文字)以 base64 內容傳入後轉為 Markdown。只讀取大型文件的一部分:PDF 頁碼範圍、標題大綱、單一章節或 token 上限。回傳的 Markdown 前會附上偵測到的標題與警告訊息。
適用情境
適合助理需要讀取 PDF、Word 檔案或網頁,而原始格式難以被模型直接理解的場合。適用於重視表格與正文結構的研究、摘要與內容擷取工作。
執行需求
可使用服務商的遠端端點(streamable HTTP,需 Authorization bearer 標頭),或透過 npx 或 Docker 以 stdio 執行本機 npm 套件 agentmd-mcp。必須提供 AgentMD API 金鑰,透過 AGENTMD_API_KEY 或 Authorization 標頭傳入。AGENTMD_BASE_URL 為選用,用於指向自架或測試環境。需要網路存取。
安裝前請注意
API 金鑰是傳送給服務商的機密,請勿寫入共用設定或映像檔。提交的文件與 URL 會由第三方服務處理,應避免上傳機密資料。依用量計費:每個電子郵件 50 次免費轉換,之後每次成功轉換 0.002 美元,按月結算。掃描檔或純圖片 PDF 只會回傳警告,不做 OCR。單一文件上限 25 MB。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AgentMD,將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.djrobson5%2Fagentmd/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agentmd": {
      "type": "http",
      "url": "https://www.getagentmd.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

agentmd-mcp

MCP server for AgentMD — convert PDF, DOCX, HTML, and URLs into clean, LLM-ready markdown, with tables preserved and web-page boilerplate stripped.

Agents ingest documents constantly, and most document formats are hostile to language models. This gives your agent three tools that turn any of them into markdown it can actually read.

Install

Get a free API key (50 conversions, no card) at https://www.getagentmd.com — or fully programmatically:

bash
curl -X POST https://www.getagentmd.com/api/v1/keys/free \  -H "Content-Type: application/json" -d '{"email": "[email protected]"}'

Then:

Claude Code

bash
claude mcp add agentmd --env AGENTMD_API_KEY=<your-key> -- npx -y agentmd-mcp

Any MCP client (mcp.json / claude_desktop_config.json):

json
{  "mcpServers": {    "agentmd": {      "command": "npx",      "args": ["-y", "agentmd-mcp"],      "env": { "AGENTMD_API_KEY": "<your-key>" }    }  }}

Docker

bash
docker build -t agentmd-mcp .docker run -i --rm -e AGENTMD_API_KEY=<your-key> agentmd-mcp

The image runs the stdio server, so pass -i; the API key is supplied at run time with -e rather than baked into the image. To wire the container into an MCP client:

json
{  "mcpServers": {    "agentmd": {      "command": "docker",      "args": ["run", "-i", "--rm", "-e", "AGENTMD_API_KEY", "agentmd-mcp"],      "env": { "AGENTMD_API_KEY": "<your-key>" }    }  }}

Remote (no install) — the hosted server speaks streamable HTTP directly:

bash
claude mcp add --transport http agentmd https://www.getagentmd.com/api/mcp \  --header "Authorization: Bearer <your-key>"

Tools

ToolUse it for
convert_url_to_markdownA web page or a document at an http(s) URL
convert_file_to_markdownA document on the local filesystem, by path
convert_document_to_markdownDocument bytes you already hold, as base64

All three return markdown, prefixed with the detected title and any warnings.

Supported formats

  • PDF — text extraction (scanned/image-only PDFs return a warning; OCR is on the roadmap)
  • DOCX — headings, lists, and tables preserved
  • HTML / URLs — main-article extraction, GFM tables, links resolved to absolute URLs
  • Markdown / plain text — normalized passthrough

Limit: 25 MB per document.

Configuration

VariableRequiredPurpose
AGENTMD_API_KEYyesYour API key
AGENTMD_BASE_URLnoPoint at a different deployment (self-hosting, staging)

Pricing

First 50 conversions free (per email, no card). After that, $0.002 per successful conversion, billed monthly. No per-seat licensing — you pay for calls your agents actually make.

License

MIT (this client shim). The hosted service has its own terms.

來源:README.md,提交 ee199de

工具

2

convert_url_to_markdown

Convert URL to markdown

Fetch a URL (web page, PDF, DOCX, etc.) and convert it to clean, LLM-ready markdown. Extracts the main article content from web pages and preserves tables. Supports reading only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap.

輸入參數url必填modepagessectionmaxTokens

convert_document_to_markdown

Convert document to markdown

Convert a document you already have (PDF, DOCX, HTML, plain text) to clean, LLM-ready markdown. Pass the file contents as base64. Supports reading only part of a large document: PDF page ranges, a heading outline, a single section, or a token cap.

輸入參數modepagesbase64必填sectionfilenamemaxTokens

版本歷史

2
  1. v0.1.4最新Sep 16, 2026
  2. v0.1.1Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分