JinDaGe - excel-to-pdf-mcp MCP Details

article

README

🚀 Excel 转 PDF MCP 服务器

这是一个 MCP（模型上下文协议）服务器，可实现将 Excel（.xls/.xlsx）和 Apple Numbers（.numbers）文件转换为 PDF 格式的功能。该工具与 AI 助手（如 Claude）集成后，能直接通过对话完成文件转换，为用户提供了便捷的文件处理方式。

🚀 快速开始

Excel 转 PDF MCP 服务器是一款强大的工具，它允许你轻松地将 Excel 和 Apple Numbers 文件转换为 PDF 格式。通过与 AI 助手集成，你可以在对话中直接完成文件转换操作。

✨ 主要特性

支持将 Excel 文件（.xls、.xlsx）转换为 PDF 格式。
支持将 Apple Numbers 文件（.numbers）转换为 PDF 格式。
可通过 Model Context Protocol 与 AI 助手集成。
安全处理文件，严格尊重项目边界。
可通过 npm 轻松安装。

📦 安装指南

安装 LibreOffice

LibreOffice 是转换过程中必不可少的工具，请根据你的操作系统进行安装：

在 macOS 上：

brew install libreoffice

在 Ubuntu/Debian 上：

apt-get install libreoffice

在 Windows 上：

你可以从 LibreOffice 官方网站下载并安装。

安装 MCP 服务器

npm install -g excel-to-pdf-mcp

💻 使用示例

与 Claude Desktop 配合使用

要在 Claude desktop 中使用此 MCP 服务器，可按以下步骤操作：

在 Claude desktop 中配置你的 MCP 设置，通过在 mcp_settings.json 中添加此服务器：

{
  "mcpServers": {
    "excel-to-pdf-mcp": {
      "command": "npx",
      "args": ["excel-to-pdf-mcp"],
      "name": "Excel 转 PDF 转换器"
    }
  }
}

确保你的 Excel 或 Numbers 文件存放在项目目录内。
完成配置后，Claude 即可使用此工具将文件转换为 PDF。

示例对话

以下是一个与 Claude 对话的示例，展示了如何使用该工具进行文件转换：用户： "我需要将我的 quarterly_report.xlsx 转换为 PDF 格式以便与利益相关者分享。" Claude： "我可以帮助你将 Excel 文件转换为 PDF。让我使用 Excel 到 PDF 转换器工具。" Claude 会使用该工具进行操作：

Tool: convert_excel_to_pdf
Arguments: {
  "input_path": "quarterly_report.xlsx",
  "output_format": "pdf"
}

Claude： "我已经将你的 Excel 文件转换为 PDF。文件位于：project directory 中 quarterly_report-1628347658-a7b2c9.pdf。"

📚 详细文档

可用工具

此 MCP 服务器提供了以下两个实用工具：

1. convert_excel_to_pdf

该工具可将 Excel 文件（.xls/.xlsx）转换为 PDF 格式。 参数：

input_path：Excel 文件的相对路径（必需）
output_format：输出格式，当前仅支持 PDF（默认： "pdf"）

2. convert_numbers_to_pdf

该工具可将 Apple Numbers 文件（.numbers）转换为 PDF 格式。 参数：

input_path：Numbers 文件的相对路径（必需）
output_format：输出格式，当前仅支持 PDF（默认： "pdf"）

🔧 技术细节

如果你想从源代码运行或为项目做出贡献，可以按照以下步骤进行：

克隆仓库。
安装依赖项：npm install。
构建项目：npm run build。
运行服务器：npm start。

📄 许可证

本项目采用 MIT 许可证。

excel-to-pdf-mcp