使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在为LLM客户端（如Claude）提供将 Excel (.xls, .xlsx) 和 Apple Numbers (.numbers) 文件转换为 PDF 格式的功能。通过集成此MCP服务器，AI助手可以直接在对话中调用文件转换工具，实现便捷的文件处理。

主要功能点

Excel转PDF: 支持将 Microsoft Excel 文件（.xls, .xlsx）转换为 PDF 文档。
Numbers转PDF: 支持将 Apple Numbers 文件（.numbers）转换为 PDF 文档。
MCP集成: 遵循 Model Context Protocol 协议，易于与支持 MCP 的 AI 助手集成。
安全文件处理: 文件操作限制在项目目录内，保障数据安全。

安装步骤

安装 LibreOffice: 文件转换依赖 LibreOffice，请根据您的操作系统安装 LibreOffice。
- macOS: 打开终端，运行命令 'brew install libreoffice'
- Ubuntu/Debian: 打开终端，运行命令 'apt-get install libreoffice'
- Windows: 访问 LibreOffice 官方网站下载并安装。
安装 MCP 服务器: 打开终端，运行命令 'npm install -g excel-to-pdf-mcp' 即可全局安装此 MCP 服务器。

服务器配置

要将此 MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要在客户端的 MCP 设置中添加以下 JSON 配置。通常，您需要编辑客户端的 'mcp_settings.json' 文件，并加入以下 server 配置：

{
  "mcpServers": {
    "excel-to-pdf-mcp": {  //  服务器名称，用于在客户端中标识和引用
      "command": "npx",    //  启动服务器的命令，这里使用 npx 执行 npm 包
      "args": ["excel-to-pdf-mcp"], //  启动命令的参数，这里是执行 excel-to-pdf-mcp 命令
      "name": "Excel to PDF Converter" //  服务器在客户端显示的友好名称
    }
  }
}

基本使用方法

确保您的 Excel 或 Numbers 文件位于您的项目目录中，以便 MCP 服务器可以访问。
在配置好 MCP 服务器的客户端中，与 AI 助手进行对话。例如，您可以向 AI 助手发送指令：“请将我的 Excel 文件 '财务报表.xlsx' 转换为 PDF 格式”。
AI 助手如果配置了此 MCP 服务器，将自动调用相应的工具进行文件转换。转换后的 PDF 文件将保存在项目目录中，并由 AI 助手告知您文件路径。

注意: 使用前请确保 LibreOffice 已正确安装，并且 'excel-to-pdf-mcp' 命令可以成功执行。

关键词