Voidlight Markdown MCP Server

VoidLight MarkItDown MCP服务器

](https://badge.fury.io/py/voidlight-markitdown-mcp) ](https://hub.docker.com/r/voidlight/markitdown-mcp)  

增强的MarkItDown MCP服务器，支持韩语，并为Claude Desktop提供高级文档转换功能。

🚀 快速安装

pip install voidlight-markitdown-mcp

⚡ Claude桌面设置

1.安装和设置

# Install the package
pip install voidlight-markitdown-mcp

# Auto-configure Claude Desktop
voidlight-markitdown-mcp --setup

2.手动配置

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "voidlight-markitdown": {
      "command": "voidlight-markitdown-mcp"
    }
  }
}

3.开始使用

1. 重新启动克劳德桌面
2. 使用 convert_to_markdown 转换文档的工具
3. 支持50多种文件格式，包括：

- 📄 PDF、DOCX、PPTX、TXT - 🌐 HTML、RTF、CSV、Excel - 🖼️ OCR图像（支持韩语） - 🎵 音频转录 - 📱 移动格式（HWP等）

📦 安装选项

核心安装（推荐）

pip install voidlight-markitdown-mcp

具有所有功能

pip install "voidlight-markitdown-mcp[all]"

特定功能集

# Office documents (Word, Excel, PowerPoint)
pip install "voidlight-markitdown-mcp[office]"

# PDF processing
pip install "voidlight-markitdown-mcp[pdf]"

# Image OCR
pip install "voidlight-markitdown-mcp[image]"

# Audio transcription  
pip install "voidlight-markitdown-mcp[audio]"

# Korean language support
pip install "voidlight-markitdown-mcp[korean]"

# Cloud services
pip install "voidlight-markitdown-mcp[cloud]"

🐳 Docker使用

快速开始

docker run -v $(pwd)/documents:/workdir ghcr.io/voidlight00/voidlight-markdown-mcp-server

Docker Compose

# Clone repository
git clone https://github.com/VoidLight00/voidlight-markdown-mcp-server.git
cd voidlight-markdown-mcp-server

# Start services
docker-compose up -d

# Process documents
docker-compose exec voidlight-markitdown-mcp voidlight-markitdown-mcp --status

🛠️ CLI使用情况

检查安装情况

voidlight-markitdown-mcp --status

安装其他依赖项

voidlight-markitdown-mcp --install-deps all

设置克劳德桌面

voidlight-markitdown-mcp --setup

🌟 特性

增强的文档支持

• 50+文件格式：PDF、DOCX、PPTX、Excel、HTML、RTF、CSV、TXT、图像
• 韩语优化：增强的韩语文本处理和OCR
• 云集成：Azure文档智能、谷歌云愿景
• 音频处理：支持韩语的语音转文本
• 图像OCR：从支持多语言的图像中提取文本

性能和可靠性

• 内存效率高：大文件的流式处理
• 错误处理：优美的回退和详细的错误消息
• 缓存：用于重复转换的智能缓存
• 并行处理：用于批处理操作的多线程转换

开发者体验

• 简单API：一个命令安装和设置
• 综合录井：详细的转换日志和指标
• 可扩展：自定义转换器的插件架构
• 类型安全：完整的TypeScript/Python类型注释

📋 支持格式

🔧 配置

环境变量

export MCP_WORKDIR=/path/to/workspace
export MCP_LOG_LEVEL=INFO
export AZURE_DOCUMENT_INTELLIGENCE_ENDPOINT=your_endpoint
export OPENAI_API_KEY=your_api_key

配置文件

创建 ~/.voidlight-markitdown-mcp/config.json:

{
  "conversion": {
    "include_metadata": true,
    "extract_images": false,
    "korean_optimization": true
  },
  "performance": {
    "max_workers": 4,
    "memory_limit": "1GB"
  }
}

🚀 发展

设置开发环境

git clone https://github.com/VoidLight00/voidlight-markdown-mcp-server.git
cd voidlight-markdown-mcp-server

# Install with development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
black src/
flake8 src/
mypy src/

建筑

# Build package
python -m build

# Build Docker image
docker build -t voidlight-markitdown-mcp .

📊 与微软MarkItDown的比较

🆘 故障排除

常见问题

在macOS上安装失败

# Install Python 3.11+ first
brew install python@3.11
pip3.11 install voidlight-markitdown-mcp

缺少的依赖

# Check status
voidlight-markitdown-mcp --status

# Install missing dependencies
voidlight-markitdown-mcp --install-deps all

Claude Desktop未检测到服务器

# Re-run setup
voidlight-markitdown-mcp --setup

# Check Claude Desktop config path
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🤝 贡献

欢迎投稿！请看 贡献.md 作为指导方针。

🔗 链接

• PyPI包
• 文档
• 问题与支持

______________________________________________________________________

⭐ 如果这个项目对你有帮助，请给它一颗星！ ⭐