[!警告] Python 3.14+ / 基于Arch的用户： 如果你遇到安装超时或onnxruntime依赖冲突，请在安装前阅读🛠️下面的Python 3.14+快速修复部分。

该扩展将 MarkItDown 集成为 Zed 助手的模型上下文协议（MCP）服务器。

有关上游信息，请查看MarkItDown-MCP

这个扩展的作用

将任何文档转化为AI上下文 - 上传或引用任何文件，这个扩展会将其转换为AI能理解和操作的干净Markdown，无需多模态。

支持的文件类型

它暴露了一个工具：convert_to_markdown(uri)，其中uri可以是任意http:、https:、file:或data:的URI。

MarkItDown MCP Server for Zed

[!WARNING]
Python 3.14+ / Arch-based Users: If you encounter installation timeouts or onnxruntime dependency conflicts, please read the 🛠️ Python 3.14+ Quick Fix section below before installation.

This extension integrates MarkItDown as a Model Context Protocol (MCP) Server for for Zed’s Assistant.

for upstream information, check MarkItDown-MCP

What This Extension Does

Turn any Documents into AI Context - Upload or reference any file, and this extension converts it to clean Markdown that AI can understand and work with without Multimodality.

Supported File Types

It exposes one tool: convert_to_markdown(uri), where uri can be any http:, https:, file:, or data: URI.

Quick Start

Installation (dev)

# Clone the repo
git clone [https://github.com/G36maid/zed-mcp-server-markitdown.git](https://github.com/G36maid/zed-mcp-server-markitdown.git)
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

Usage Examples

Convert a PDF report:

Please analyze this PDF report and summarize the key findings.

Extract data from a spreadsheet:

Convert this Excel file to markdown and show me the top 5 entries.

Analyze a webpage:

Summarize the main points from this article form link in README.

Configuration

Optional Settings

Access through Zed’s settings or the Assistant configuration UI:

{
  "context_servers": {
    "mcp-server-markitdown": {
      "settings": {
        "package_version": "latest"
      }
    }
  }
}

• package_version: Specify npm package version (default: “latest”)

Prerequisites

• Node.js and npm (automatically handled by Zed)
• Rust (automatically handled by Zed)
• Internet connection (for initial package installation and web calls)

Local Development

# Clone the repo
git clone [https://github.com/G36maid/zed-mcp-server-markitdown.git](https://github.com/G36maid/zed-mcp-server-markitdown.git)
cd zed-mcp-server-markitdown

# Build the extension
cargo build --release