Zed的MarkItDown MCP服务器
\[！警告\]\ 基于Python 3.14+/Arch的用户： 如果您遇到安装超时或 onnxruntime 依赖冲突，请阅读 🛠️ Python 3.14+快速修复 安装前，请参阅以下部分。此扩展集成 MarkItDown 作为Zed助手的模型上下文协议（MCP）服务器。
有关上游信息，请检查 MarkItDown MCP
此扩展功能是什么
将任何文档转换为AI上下文 -上传或引用任何文件，此扩展将其转换为干净的Markdown，AI可以在没有Multimodal的情况下理解和使用。
支持的文件类型
它公开了一个工具： convert_to_markdown(uri)，其中uri可以是任何 http:, https:, file:，或 data: URI。
| 类别 | 格式 | AI用例 |
|---|---|---|
| 文件 | PDF、Word（.docx）、Excel（.xlsx）、PowerPoint（.pptx） | 分析报告、总结演示文稿、提取数据 |
| 图像 | JPG、PNG、GIF（带OCR） | 从屏幕截图中读取文本，分析图表，描述图像 |
| 音频 | MP3、WAV（带转录） | 转录会议，分析演讲内容 |
| 网络 | HTTP/HTTPS URLs | 总结文章，提取关键信息 |
| 数据 | CSV、JSON、XML | 处理结构化数据，生成见解 |
| 档案 | ZIP文件 | 一次分析多个文件 |
快速开始
安装（dev）
# Clone the repo
git clone
cd zed-mcp-server-markitdown
# Build the extension
cargo build --release
# Add as a dev extension in Zed:
# In Zed, go to Extensions → Install Dev Extension → Select this directory用法示例
转换PDF报告：
Please analyze this PDF report and summarize the key findings.从电子表格中提取数据：
Convert this Excel file to markdown and show me the top 5 entries.分析网页：
Summarize the main points from this article form link in README.配置
可选设置
通过Zed的设置或助手配置UI访问：
{
"context_servers": {
"mcp-server-markitdown": {
"settings": {
"package_version": "latest"
}
}
}
}package_version：指定npm包版本（默认：“latest”）
先决条件
- Node.js和npm （由Zed自动处理）
- 锈 （由Zed自动处理）
- 互联网连接 （用于初始软件包安装和web调用）
本地开发
# Clone the repo
git clone
cd zed-mcp-server-markitdown
# Build the extension
cargo build --release
# Add as a dev extension in Zed:
# In Zed, go to Extensions → Install Dev Extension → Select this directory🛠️ Python 3.14+快速修复
如果您在Arch Linux或已更新到Python 3.14的其他系统上遇到安装超时或依赖冲突，建议配置 uvx 直接在Zed的 settings.json。这使用了一个隔离的Python 3.13环境，绕过了上游兼容性问题。
1.先决条件
确保 紫外线 已安装在您的系统上。
2.配置Zed
打开 settings.json 在Zed中（命令选项板：键入 settings)并添加以下配置：
{
"context_servers": {
"markitdown": {
"command": "uvx",
"args": [
"--python",
"3.13",
"markitdown-mcp"
]
}
}
}3.预热环境（重要）
由于第一家初创公司下载了Python 3.13和相关的AI模型（如Magika），它可能会超过Zed的60秒启动限制。在终端中运行一次以确保缓存完成：
uvx --python 3.13 markitdown-mcp当你看到 Connected to markitdown-mcp 或类似的启动成功消息，按 Ctrl+C 停止它。然后重新加载Zed，它将正常工作。
优点：
- 不需要Node.js：直接调用Rust编写的Python包
uv较短的路径。 - 环境隔离:
uvx自动处理环境，而不会打乱系统路径。 - 显式版本管理：使用强制运行时环境
--python 3.13，完美解决onnxruntime被困在3.14。
______________________________________________________________________
相关项目
- 微软MarkItDown -核心转换工具（Python）
- MarkItDown MCP -官方MCP服务器
- markitdown mcp npx -此扩展使用的NPX包装器
- 上下文7 MCP -类似Zed MCP扩展示例
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
致谢
- 微软AutoGen团队 用于创建MarkItDown
- Zed工业 优秀的扩展平台
- 启动 为MarkItDown MCP创建npx包装
______________________________________________________________________
使用MarkItDown MCP Server for Zed将您的文档转换为AI就绪的上下文。