https://github.com/korigamik/markitdown_mcp_server
A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.
https://github.com/korigamik/markitdown_mcp_server
Last synced: 6 months ago
JSON representation
A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.
- Host: GitHub
- URL: https://github.com/korigamik/markitdown_mcp_server
- Owner: KorigamiK
- License: mit
- Created: 2025-01-28T13:38:06.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-01-28T13:42:19.000Z (8 months ago)
- Last Synced: 2025-01-28T14:37:20.487Z (8 months ago)
- Language: Python
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# MarkItDown MCP Server
[](https://smithery.ai/server/@KorigamiK/markitdown_mcp_server)
A Model Context Protocol (MCP) server that converts various file formats to Markdown using the MarkItDown utility.
## Supported Formats
- PDF
- PowerPoint
- Word
- Excel
- Images (EXIF metadata and OCR)
- Audio (EXIF metadata and speech transcription)
- HTML
- Text-based formats (CSV, JSON, XML)
- ZIP files (iterates over contents)
## Installation
### Installing via Smithery
To install MarkItDown MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@KorigamiK/markitdown_mcp_server):
```bash
npx -y @smithery/cli install @KorigamiK/markitdown_mcp_server --client claude
```
### Manual Installation
1. Clone this repository
2. Install dependencies:
```bash
uv install
```
## Usage
### As MCP Server
The server can be integrated with any MCP client. Here are some examples:
#### Zed Editor
Add the following to your `settings.json`:
```json
"context_servers": {
"markitdown_mcp": {
"settings": {},
"command": {
"path": "uv",
"args": [
"--directory",
"/path/to/markitdown_mcp_server",
"run",
"markitdown"
]
}
}
}
```
### Commands
The server responds to the following MCP commands:
- `/md ` - Convert the specified file to Markdown
Example:
```bash
/md document.pdf
```
## Supported MCP Clients
Works with any MCP-compliant client listed at [modelcontextprotocol.io/clients](https://modelcontextprotocol.io/clients), including:
- Zed Editor
- Any other MCP-compatible editors and tools
## License
MIT License. See [LICENSE](LICENSE) for details.
## Acknowledgements
https://github.com/microsoft/markitdown#readme