Neura Market
microsoft/markitdown logo

microsoft/markitdown

Free

MarkItDown MCP 工具访问 - 一个将多种文件格式（本地或远程）转换为 Markdown 以供 LLM 使用的库。

FreeFree tier
Type
Open Source
Company
Microsoft
Visit Website GitHub (40 stars)

About microsoft/markitdown

MarkItDown-MCP is a lightweight MCP (Model Context Protocol) server that exposes MarkItDown's file-to-Markdown conversion capabilities as a tool. It allows AI agents and applications to convert a wide range of file formats—including local files, remote HTTP/HTTPS resources, data URIs, and more—into Markdown format. The server supports STDIO, Streamable HTTP, and SSE transports, making it flexible for various integration scenarios. It is designed for local use with trusted agents, and comes with Docker support for easy deployment. The primary tool, convert_to_markdown(uri), accepts URIs of types http:, https:, file:, or data: and returns the converted Markdown content. This package is part of the Microsoft MarkItDown ecosystem and can be installed via pip install markitdown-mcp.

Key Features

Exposes a single MCP tool: convert_to_markdown(uri)
Supports STDIO, Streamable HTTP, and SSE transport protocols
Accepts URI types: http://, https://, file://, and data://
Docker image available for containerized deployment
Designed for local use with trusted agents and AI assistants
Easy integration with Claude Desktop via Docker
Simple pip installation: pip install markitdown-mcp

Pros & Cons

Pros
  • Lightweight and easy to install via pip
  • Supports both local files and remote URLs
  • Docker support simplifies deployment and isolation
  • Works out-of-the-box with Claude Desktop and other MCP clients
  • Uses the robust MarkItDown conversion engine from Microsoft
Cons
  • Only converts to Markdown format (no other output options)
  • Intended for local trusted environments; not suitable for public-facing services without security precautions
  • Requires the MarkItDown library as a dependency
  • Limited to a single conversion tool in the MCP server

Best For

Preprocessing documents into Markdown for LLM ingestionConverting web pages or local files to Markdown for AI agentsIntegrating file conversion into MCP-compatible AI tools and assistantsExtracting structured text from various formats for downstream processing

FAQ

What is MarkItDown-MCP?
MarkItDown-MCP is a lightweight MCP server that exposes a single tool for converting files to Markdown using the MarkItDown library. It supports STDIO, Streamable HTTP, and SSE transports, and can convert local files, remote HTTP/HTTPS resources, and data URIs.
How do I install MarkItDown-MCP?
You can install it using pip: pip install markitdown-mcp
How do I run the MCP server?
For STDIO transport, simply run: markitdown-mcp. For Streamable HTTP or SSE, run: markitdown-mcp --http --host 127.0.0.1 --port 3001
Can I run MarkItDown-MCP in Docker?
Yes. Build the Docker image with docker build -t markitdown-mcp:latest . and run with docker run -it --rm markitdown-mcp:latest. To access local files, mount a directory using -v.
How do I use MarkItDown-MCP with Claude Desktop?
Configure Claude Desktop's claude_desktop_config.json to use the Docker image as an MCP server. For example, set command to 'docker' with args ['run', '--rm', '-i', 'markitdown-mcp:latest'].