🚀 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 许可证。