金大哥 - FILE-CONVERTER-MCP MCP 详情

article

README

🚀 Pandoc 多服务器控制协议（MCP）服务器

Pandoc-MCP 服务器是一款基于 Pandoc 的实用工具，可实现多种文件格式的转换与处理。它不仅能完成文件格式的转换，还可与 LangChain 等 MCP 客户端集成，为用户提供便捷的文件处理体验。

🚀 快速开始

若您想快速体验 Pandoc-MCP 服务器，可按以下步骤操作：

步骤一：构建 Docker 镜像

docker build -t your_username/pandoc-mcp-server .

步骤二：运行容器

docker run -it --rm -v $(pwd):/data your_username/pandoc-mcp-server:latest

✨ 主要特性

多格式转换：支持 Markdown、Word、PDF 等格式文件的相互转换，满足多样化的文件处理需求。
远程控制：借助 HTTP 协议提供服务，可远程调用文件处理功能，方便快捷。
Docker 支持：提供 Docker 镜像构建方案，便于快速部署和运行，节省时间和精力。
文档管理：支持批量处理、版本控制和文档存储，有效管理文档资源。

📦 安装指南

服务器端安装

方案一：基于 Docker 的安装（推荐）

此方案简单便捷，适合快速部署。

拉取镜像

docker pull your_username/pandoc-mcp-server:latest

启动容器

docker run -it --rm -v $(pwd):/data your_username/pandoc-mcp-server:latest

访问服务：服务器启动后，可通过 http://localhost:8000/sse 访问服务。

方案二：本地安装（需手动配置）

若您希望手动配置服务器，可选择此方案。

安装依赖
- 安装 Python 3.10 或更高版本。
- 安装 Pandoc 工具链 (pandoc --version)。
- 安装 LaTeX 环境 (pdflatex --version)。

克隆代码库

git clone https://github.com/your_username/pandoc-mcp-server.git
cd pandoc-mcp-server

创建虚拟环境（推荐）

python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或者：venv\Scripts\activate  # Windows

安装 Python 包
```
pip install -r requirements.txt
```
启动服务器
```
python pandoc_mcp_server.py
```

💻 使用示例

客户端集成示例（以 LangChain 为例）

from langchain.agents import MultiServerMCPClient

# 初始化客户端
client = MultiServerMCPClient(
    server_url="http://localhost:8000/sse",
    token="your_token"
)

# 调用文件转换服务
response = client.invoke("将 input.md 转换为 PDF")
print(response)

📚 详细文档

1. 文件格式转换

支持的格式：Markdown、.docx、PDF 等。

使用命令

# 将 markdown 转换为 PDF
./pandoc-mcp convert input.md output.pdf --format=pdf

# 批量处理文件
./pandoc-mcp batch process *.md output/

2. 文档管理

版本控制：支持文件的历史版本管理，方便追溯和恢复。
存储位置：默认存储在 /data/documents 目录。

3. 高级功能

自定义模板：通过配置 templates 目录，可使用自定义的 Pandoc 模板，满足个性化需求。
日志记录：服务器支持详细的日志输出，便于调试和监控。

示例场景

场景一：在线文档转换服务

# 启动服务并绑定端口 8000
docker run -it --rm -p 8000:8000 your_username/pandoc-mcp-server:latest

场景二：批量处理 Word 文件

# 将当前目录下所有 .docx 文件转换为 PDF
./pandoc-mcp batch convert *.docx output/pdf/

🔧 技术细节

项目结构

.
├── pandoc_mcp_server.py    # 主程序入口
├── requirements.txt        # Python 依赖管理
├── Dockerfile              # Docker 镜像构建文件
└── templates/             # Pandoc 模板目录

📄 常见问题

如何获取帮助？
- 查看 pandoc-mcp --help。
- 加入项目社区讨论组或提交 ISSUE。
如何处理错误？
- 检查日志输出 (docker logs)。
- 确保所有依赖已正确安装。

🤝 项目贡献

欢迎 fork 和 PR！您可以：

提交功能增强。
修复已知问题。
添加更多文件格式支持。

通过以上步骤，您可以轻松地搭建和使用 Pandoc-MCP 服务器，实现高效的文档管理和转换。

FILE-CONVERTER-MCP