使用说明

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.开始使用

重新启动克劳德桌面
使用 convert_to_markdown 转换文档的工具
支持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类型注释

📋 支持格式

类别	格式
文件	PDF、DOCX、PPTX、RTF、TXT、MD
电子表格	XLSX、XLS、CSV
网络	HTML、XML、RSS
图像	PNG、JPG、GIF、BMP、TIFF
音频	MP3、WAV、M4A、OGG
韩语	HWP、OCR（韩语）
档案	ZIP（提取和转换）

🔧 配置

环境变量

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的比较

功能	微软MarkItDown	VoidLight MarkItDown MCP
安装	`pip install markitdown-mcp`	`pip install voidlight-markitdown-mcp`
设置	手动配置	自动设置 `--setup`
语言	英语重点	韩语+多语言
格式	20+种格式	50+种格式
云服务	基础	Azure+谷歌+OpenAI
演出	标准	优化+缓存
码头工人	❌	✅
CLI工具	基础	高级管理

🆘 故障排除

常见问题

在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 作为指导方针。

🔗 链接

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