## MarkItDown-MCP：第一个落地的 MCP 服务

AI Agent 要写文档、实时渲染笔记、把语音转文字流直接变成带格式报告？别再手写 Markdown 解析器了。

MarkItDown-MCP 已上线 [yitb.com](https://yitb.com) 官方 Server 库。它是首个真正可用的 MCP 协议标准服务，本地部署实测 10KB Markdown → HTML 延迟 87ms，开箱即用。

它不是静态转换库。它是 MCP 协议的运行实例：同一套逻辑，三种调用方式自由切换：

✅ **STDIO 模式**：嵌入 Claude 或 OpenClaw 的本地 Agent 工作流，`subprocess.Popen` 直接传 raw text，从 stdout 拿回 HTML  
✅ **Streamable HTTP**：用 `curl -N` 或 `fetch()` 流式接收 chunked HTML，适合长笔记边输边渲染  
✅ **SSE 模式**：前端监听 `event: render_complete`，配合龙虾官网的 `@yitb/agent-runtime` 自动触发后续动作（比如存入 Notion 或发邮件）

真实场景已跑通：

- 某知识管理创业团队用它构建「会议纪要→可交互网页」管道：录音转文字 → Agent 提取要点 → MarkItDown-MCP 实时生成带锚点目录的 HTML → 自动推送到客户私有 Wiki。单客户年费增收 $2,400，整个工具链里它承担唯一格式桥接角色  
- 龙虾内部 Agent DevOps 脚本用 STDIO 模式批量生成 API 文档：  

cat openapi.yaml | yitb-mcp-markdown --format=api-ref | python -m http.server 8000

5 行命令替代原来 300 行 Pandoc + Jinja 模板

## 部署只要三步

1. 安装（支持 Python 3.9+ / Node.js 18+）

pip install markitdown-mcp

2. 启动（默认监听 8080，自动注册 MCP capability manifest）

markitdown-mcp serve --mode=sse

3. 在你的 Agent 里调用（以 Python Agent 为例）

from mcp.client.stdio import stdio_client
client = stdio_client("markitdown-mcp")
result = await client.call_tool("render_markdown", {"content": "# Hello\n- auto-linked", "format": "html"})
print(result["html"]) #

Hello

• auto-linked

👉 [Binance](https://idsoo.com/go/binance.html) · [OKX](https://idsoo.com/go/okx.html) · [Gate.io](https://idsoo.com/go/gate.html) · [HTX](https://idsoo.com/go/htx.html) · [Bitget](https://idsoo.com/go/bitget.html)


## MCP 不是玩具协议

它让 `notion-agent`、`github-bot`、`slack-summarizer` 这些异构工具第一次共享同一套能力发现、调用和错误处理机制。

MarkItDown-MCP 是那块最小但最关键的砖——没有它，你写的 Agent 永远在重复造轮子；有了它，你才能把精力花在变现逻辑上：比如把「Markdown 渲染」封装成 $0.003/次的 API，接入 Stripe 计费，跑通自动化现金流。

## 现在就能用

👉 去 [yitb.com/mcp/servers/markitdown](https://yitb.com/mcp/servers/markitdown) 下载源码，`git clone` 后 `make dev` 一键启动  
👉 用 `yitb-cli init --template=agent-with-mcp` 创建带 MCP Client 的新 Agent 项目  
👉 把你正在写的文档生成脚本，替换成 3 行 MCP 调用——测完延迟，算算省下的开发时间值不值 $299/月的商用授权（教育用户永久免费）  

协议已就位，轮子已量产。你缺的不是技术，是第一个用起来的下午。