Back to Home
trsdn icon

markitdown-mcp

Verified Safe

by trsdn

Overview

A Model Context Protocol (MCP) server for converting over 29 file formats (PDFs, Office docs, images, audio, etc.) into clean, structured Markdown, primarily for integration with AI workflows and MCP clients like Claude Desktop.

Installation

Run Command
markitdown-mcp

Environment Variables

  • MAX_FILE_SIZE_MB
  • CONVERSION_TIMEOUT
  • SAFE_DIRECTORIES
  • LOG_LEVEL
  • MCP_DEBUG

Security Notes

The server demonstrates a high commitment to security with robust input validation, content sanitization (XML, JSON, CSV), file size limits, and timeout protections. Path traversal attacks are explicitly mitigated through `validate_and_sanitize_path`, which restricts operations to defined 'safe directories' and blocks dangerous file types/patterns. Base64 content is validated and processed via temporary files with proper cleanup. Error messages are sanitized to prevent information disclosure. Extensive security testing is documented, covering DoS, malicious files, and path traversal. Communication is via stdin/stdout, limiting network attack surface. The core MarkItDown library's security profile is external to this audit but assumed to be robust. One minor point is that the `secure_compare` function is defined but its usage in the main server logic isn't evident in the provided code.

Similar Servers

Stats

Interest Score35
Security Score9
Cost ClassMedium
Avg Tokens5000000
Stars4
Forks0
Last Update2025-11-27

Tags

MCPMarkdown ConversionDocument ProcessingClaude DesktopAI Tools