MCP 服务器

mcp-pandoc
精选

使用 Pandoc 的 MCP 服务器，用于无缝文档格式转换，支持 Markdown、HTML、PDF、DOCX (.docx)、csv 等格式。

内容获取

AI集成系统

Tools

convert-contents

Converts content between different formats. Transforms input content from any supported format into the specified output format. 🚨 CRITICAL REQUIREMENTS - PLEASE READ: 1. PDF Conversion: * You MUST install TeX Live BEFORE attempting PDF conversion: * Ubuntu/Debian: `sudo apt-get install texlive-xetex` * macOS: `brew install texlive` * Windows: Install MiKTeX or TeX Live from https://miktex.org/ or https://tug.org/texlive/ * PDF conversion will FAIL without this installation 2. File Paths - EXPLICIT REQUIREMENTS: * When asked to save or convert to a file, you MUST provide: - Complete directory path - Filename - File extension * Example request: 'Write a story and save as PDF' * You MUST specify: '/path/to/story.pdf' or 'C:\Documents\story.pdf' * The tool will NOT automatically generate filenames or extensions 3. File Location After Conversion: * After successful conversion, the tool will display the exact path where the file is saved * Look for message: 'Content successfully converted and saved to: [file_path]' * You can find your converted file at the specified location * If no path is specified, files may be saved in system temp directory (/tmp/ on Unix systems) * For better control, always provide explicit output file paths Supported formats: - Basic formats: txt, html, markdown - Advanced formats (REQUIRE complete file paths): pdf, docx, rst, latex, epub ✅ CORRECT Usage Examples: 1. 'Convert this text to HTML' (basic conversion) - Tool will show converted content 2. 'Save this text as PDF at /documents/story.pdf' - Correct: specifies path + filename + extension - Tool will show: 'Content successfully converted and saved to: /documents/story.pdf' ❌ INCORRECT Usage Examples: 1. 'Save this as PDF in /documents/' - Missing filename and extension 2. 'Convert to PDF' - Missing complete file path When requesting conversion, ALWAYS specify: 1. The content or input file 2. The desired output format 3. For advanced formats: complete output path + filename + extension Example: 'Convert this markdown to PDF and save as /path/to/output.pdf' Note: After conversion, always check the success message for the exact file location.

README

mcp-pandoc：文档转换 MCP 服务器

已正式包含在模型上下文协议服务器开源项目中。🎉

概述

一个使用 pandoc 进行文档格式转换的模型上下文协议服务器。该服务器提供在不同文档格式之间转换内容的工具，同时保留格式和结构。

请注意，mcp-pandoc 目前处于早期开发阶段。PDF 支持正在开发中，随着我们不断改进服务器，功能和可用工具可能会发生变化和扩展。

鸣谢：本项目使用 Pandoc Python 包进行文档转换，构成了本项目的基础。

演示

🎥 在 YouTube 上观看

更多内容即将推出...

工具

convert-contents
- 在支持的格式之间转换内容
- 输入：
  - contents (字符串)：要转换的源内容（如果未提供 input_file，则为必需）
  - input_file (字符串)：输入文件的完整路径（如果未提供 contents，则为必需）
  - input_format (字符串)：内容的源格式（默认为 markdown）
  - output_format (字符串)：目标格式（默认为 markdown）
  - output_file (字符串)：输出文件的完整路径（pdf、docx、rst、latex、epub 格式需要）
- 支持的输入/输出格式：
  - markdown
  - html
  - pdf
  - docx
  - rst
  - latex
  - epub
  - txt
- 注意：对于高级格式（pdf、docx、rst、latex、epub），需要 output_file 路径

支持的格式

当前支持的格式：

基本格式（直接转换）：

纯文本 (.txt)
Markdown (.md)
HTML (.html)

高级格式（需要完整文件路径）：

PDF (.pdf) - 需要安装 TeX Live
DOCX (.docx)
RST (.rst)
LaTeX (.tex)
EPUB (.epub)

注意：对于高级格式：

需要包含文件名和扩展名的完整文件路径
PDF 转换需要安装 TeX Live（请参阅“关键要求”部分 -> 对于 macOS：brew install texlive）
如果未指定输出路径：
- 基本格式：在聊天中显示转换后的内容
- 高级格式：可能会保存在系统临时目录中（Unix 系统上的 /tmp/）

用法和配置

要使用已发布的版本

{
  "mcpServers": {
    "mcp-pandoc": {
      "command": "uvx",
      "args": ["mcp-pandoc"]
    }
  }
}

⚠️ 重要提示

关键要求

PDF 转换先决条件

尝试 PDF 转换之前必须安装 TeX Live

安装命令：

# Ubuntu/Debian
sudo apt-get install texlive-xetex

# macOS
brew install texlive

# Windows
# 从以下位置安装 MiKTeX 或 TeX Live：
# https://miktex.org/ 或 https://tug.org/texlive/

文件路径要求
- 保存或转换文件时，您必须提供包含文件名和扩展名的完整文件路径
- 该工具不会自动生成文件名或扩展名

示例

✅ 正确用法：

# 将内容转换为 PDF
"将此文本转换为 PDF 并另存为 /path/to/document.pdf"

# 在文件格式之间转换
"将 /path/to/input.md 转换为 PDF 并另存为 /path/to/output.pdf"

❌ 错误用法：

# 缺少文件名和扩展名
"将此另存为 /documents/ 中的 PDF"

# 缺少完整路径
"将此转换为 PDF"

# 缺少扩展名
"另存为 /documents/story"

常见问题和解决方案

PDF 转换失败
- 错误：“找不到 xelatex”
- 解决方案：首先安装 TeX Live（请参阅上面的安装命令）
文件转换失败
- 错误：“无效的文件路径”
- 解决方案：提供包含文件名和扩展名的完整路径
- 示例：/path/to/document.pdf 而不仅仅是 /path/to/
格式转换失败
- 错误：“不支持的格式”
- 解决方案：仅使用支持的格式：
  - 基本：txt、html、markdown
  - 高级：pdf、docx、rst、latex、epub

快速入门

安装

选项 1：通过 claude_desktop_config.json 配置文件手动安装

在 MacOS 上：open ~/Library/Application\ Support/Claude/claude_desktop_config.json
在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json

<details> <summary>开发/未发布的服务器配置</summary>

ℹ️ 将 <DIRECTORY> 替换为您本地克隆的项目路径

"mcpServers": {
  "mcp-pandoc": {
    "command": "uv",
    "args": [
      "--directory",
      "<DIRECTORY>/mcp-pandoc",
      "run",
      "mcp-pandoc"
    ]
  }
}

</details>

<details> <summary>已发布的服务器配置</summary>

"mcpServers": {
  "mcp-pandoc": {
    "command": "uvx",
    "args": [
      "mcp-pandoc"
    ]
  }
}

</details>

选项 2：通过 Smithery 自动安装已发布的服务器配置

运行以下 bash 命令，通过 Smithery 为 Claude Desktop 自动安装已发布的 mcp-pandoc pypi：

npx -y @smithery/cli install mcp-pandoc --client claude

注意：要使用本地配置的 mcp-pandoc，请按照上面的“开发/未发布的服务器配置”步骤操作。

开发

构建和发布

要准备用于分发的软件包：

同步依赖项并更新锁定文件：

uv sync

构建软件包分发：

uv build

这将在 dist/ 目录中创建源和 wheel 分发。

发布到 PyPI：

uv publish

注意：您需要通过环境变量或命令标志设置 PyPI 凭据：

令牌：--token 或 UV_PUBLISH_TOKEN
或用户名/密码：--username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于 MCP 服务器通过 stdio 运行，因此调试可能具有挑战性。为了获得最佳的调试体验，我们强烈建议使用 MCP Inspector。

您可以通过 npm 使用以下命令启动 MCP Inspector：

npx @modelcontextprotocol/inspector uv --directory /Users/vivekvells/Desktop/code/ai/mcp-pandoc run mcp-pandoc

启动后，Inspector 将显示一个 URL，您可以在浏览器中访问该 URL 以开始调试。

贡献

我们欢迎您为增强 mcp-pandoc 做出贡献！以下是您可以参与的方式：

报告问题：发现错误或有功能请求？在我们的 GitHub Issues 页面上打开一个 issue。
提交 Pull Request：通过创建 pull request 来改进代码库或添加功能。

mcp-pandoc 精选