VoidLight MarkItDown MCP服务器
增强的MarkItDown MCP服务器,支持韩语,并为Claude Desktop提供高级文档转换功能。
🚀 快速安装```bash
pip install voidlight-markitdown-mcp
## ⚡ Claude桌面设置
### 1.安装和设置```bash
# Install the package
pip install voidlight-markitdown-mcp
# Auto-configure Claude Desktop
voidlight-markitdown-mcp --setup
2.手动配置
添加到您的Claude桌面配置(claude_desktop_config.json):```json
{
"mcpServers": {
"voidlight-markitdown": {
"command": "voidlight-markitdown-mcp"
}
}
}
### 3.开始使用
1. 重新启动克劳德桌面
1. 使用 `convert_to_markdown` 转换文档的工具
1. 支持50多种文件格式,包括:
- 📄 PDF、DOCX、PPTX、TXT
- 🌐 HTML、RTF、CSV、Excel
- 🖼️ OCR图像(支持韩语)
- 🎵 音频转录
- 📱 移动格式(HWP等)
## 📦 安装选项
### 核心安装(推荐)```bash
pip install voidlight-markitdown-mcp
具有所有功能```bash
pip install "voidlight-markitdown-mcp[all]"
### 特定功能集```bash
# 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使用
快速开始```bash
docker run -v $(pwd)/documents:/workdir ghcr.io/voidlight00/voidlight-markdown-mcp-server
### Docker Compose```bash
# 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使用情况
检查安装情况```bash
voidlight-markitdown-mcp --status
### 安装其他依赖项```bash
voidlight-markitdown-mcp --install-deps all
设置克劳德桌面```bash
voidlight-markitdown-mcp --setup
## 🌟 特性
### 增强的文档支持
- **50+文件格式**:PDF、DOCX、PPTX、Excel、HTML、RTF、CSV、TXT、图像
- **韩语优化**:增强的韩语文本处理和OCR
- **云集成**:Azure文档智能、谷歌云愿景
- **音频处理**:支持韩语的语音转文本
### 性能和可靠性
- **内存效率高**:大文件的流式处理
- **错误处理**:优美的回退和详细的错误消息
- **缓存**:用于重复转换的智能缓存
- **并行处理**:用于批处理操作的多线程转换
### 开发者体验
- **简单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(提取和转换)|
## 🔧 配置
### 环境变量```bash
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:```json
{
"conversion": {
"include_metadata": true,
"extract_images": false,
"korean_optimization": true
},
"performance": {
"max_workers": 4,
"memory_limit": "1GB"
}
}
## 🚀 发展
### 设置开发环境```bash
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/
建筑```bash
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上安装失败**```bash
# Install Python 3.11+ first
brew install python@3.11
pip3.11 install voidlight-markitdown-mcp
缺少的依赖```bash
Check status
voidlight-markitdown-mcp --status
Install missing dependencies
voidlight-markitdown-mcp --install-deps all
**Claude Desktop未检测到服务器**```bash
# 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包
- Docker Hub
- GitHub存储库
- 文档
- 问题与支持
⭐ 如果这个项目对你有帮助,请给它一颗星! ⭐
