Markdown转换MCP UTF8服务器
项目介绍
Markdownify MCP Server - 支持UTF-8增强版
这是对原始Markdownify MCP项目的增强版本，改进了UTF-8编码支持并优化了多语言内容处理。
增强功能
- 增加了全面的UTF-8编码支持
- 优化了多语言内容处理
- 解决了Windows系统上的编码问题
- 提升了错误处理机制
与原项目的主要区别
-
编码支持增强：
- 所有操作均支持完整的UTF-8编码
- 正确处理中文、日文、韩文及其他非ASCII字符
- 解决了Windows特有的编码问题（cmd.exe和PowerShell兼容性）
-
错误处理改进：
- 提供详细的英文和中文错误信息
- 对网络问题有更好的异常处理
- 转换失败时有优雅的回退机制
-
功能扩展：
- 增加了批量处理多个文件的支持
- 优化了YouTube视频字幕处理
- 改进了从各种文件格式中提取元数据的能力
- 更好地保存文档格式
-
性能优化：
- 优化了大文件转换时的内存使用
- 加快了多语言内容的处理速度
- 减少了依赖冲突
-
开发体验提升：
- 提供全面的调试选项
- 详细的日志系统
- 支持环境特定的配置
- 英文和中文的清晰文档
特性
支持将多种文件类型转换为Markdown：
- PDF文件
- 图像（带元数据）
- 音频（带转录）
- Word文档（DOCX）
- Excel电子表格（XLSX）
- PowerPoint演示文稿（PPTX）
- 网页内容：
- YouTube视频字幕
- 搜索结果
- 通用网页
- 已存在的Markdown文件
快速开始
-
克隆此仓库：
git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git cd markdownify-mcp-utf8 -
安装依赖项：
pnpm install注意：这也将安装
uv及相关Python依赖项。 -
构建项目：
pnpm run build -
启动服务器：
pnpm start
系统需求
- Node.js 16.0或更高版本
- Python 3.8或更高版本
- pnpm 包管理器
- Git
详细安装指南
1. 环境设置
-
安装Node.js：
- 从Node.js官方网站下载
- 验证安装：
node --version
-
安装pnpm：
npm install -g pnpm pnpm --version -
安装Python：
- 从Python官方网站下载
- 确保在安装过程中将Python添加到PATH
- 验证安装：
python --version
-
（仅限Windows）配置UTF-8支持：
# 设置全局UTF-8 setx PYTHONIOENCODING UTF-8 # 设置当前会话UTF-8 set PYTHONIOENCODING=UTF- # 在命令提示符中启用UTF-8 chcp 65001
2. 项目设置
-
克隆仓库：
git clone https://github.com/JDJR2024/markdownify-mcp-utf8.git cd markdownify-mcp-utf8 -
创建并激活Python虚拟环境：
# Windows python -m venv .venv .venv\Scripts\activate # Linux/macOS python3 -m venv .venv source .venv/bin/activate -
安装项目依赖项：
# 安装Node.js依赖项 pnpm install # 安装Python依赖项（将由setup.sh处理） ./setup.sh -
构建项目：
pnpm run build
3. 验证
-
启动服务器：
pnpm start -
测试安装：
# 将网页转换为Markdown python convert_utf8.py "https://example.com" # 将本地文件转换为Markdown python convert_utf8.py "path/to/your/file.docx"
使用指南
基本用法
-
转换网页：
python convert_utf8.py "https://example.com"转换后的Markdown将被保存为
converted_result.md -
转换本地文件：
# 转换DOCX python convert_utf8.py "document.docx" # 转换PDF python convert_utf8.py "document.pdf" # 转换PowerPoint python convert_utf8.py "presentation.pptx" # 转换Excel python convert_utf8.py "spreadsheet.xlsx" -
转换YouTube视频：
python convert_utf8.py "https://www.youtube.com/watch?v=VIDEO_ID"
高级用法
-
环境变量：
# 设置自定义UV路径 export UV_PATH="/custom/path/to/uv" # 设置自定义输出目录 export MARKDOWN_OUTPUT_DIR="/custom/output/path" -
批量处理： 创建一个批处理文件（例如，
convert_batch.txt），其中包含URL或文件路径：https://example1.com https://example2.com file1.docx file2.pdf然后运行：
while read -r line; do python convert_utf8.py "$line"; done < convert_batch.txt
故障排除
-
常见问题：
- 如果看到编码错误，请确保UTF-8已正确设置
- 对于Windows上的权限问题，请以管理员身份运行
- 对于Python路径问题，请确保虚拟环境已激活
-
调试：
# 启用调试输出 export DEBUG=true python convert_utf8.py "your_file.docx"
使用方法
命令行
将网页转换为Markdown：
python convert_utf8.py "https://example.com"
将本地文件转换为Markdown：
python convert_utf8.py "path/to/your/file.docx"
桌面应用集成
要将此服务器与桌面应用集成，请在应用的服务器配置中添加以下内容：
{
"mcpServers": {
"markdownify": {
"command": "node",
"args": [
"{ABSOLUTE_PATH}/dist/index.js"
],
"env": {
"UV_PATH": "/path/to/uv"
}
}
}
}
故障排除
-
编码问题
- 如果遇到字符编码问题，请确保
PYTHONIOENCODING环境变量设置为utf-8 - Windows用户可能需要运行
chcp 65001以启用UTF-8支持
- 如果遇到字符编码问题，请确保
-
权限问题
- 确保您有足够的文件读写权限
- 在Windows上，您可能需要以管理员身份运行
致谢
该项目基于Zach Caceres的原始工作。感谢原作者的杰出贡献。
许可证
此项目继续采用MIT许可证。详情请参阅LICENSE文件。
贡献
欢迎贡献！在提交Pull Request之前，请确保：
- 您的代码遵循项目的编码标准
- 添加必要的测试和文档
- 更新README中的相关部分
联系方式
对于问题或建议：