Excel To Pdf MCP

🚀 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 服務器，可按以下步驟操作：

1. 在 Claude desktop 中配置你的 MCP 設置，通過在 mcp_settings.json 中添加此服務器：

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

2. 確保你的 Excel 或 Numbers 文件存放在項目目錄內。
3. 完成配置後，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"）

🔧 技術細節

如果你想從源代碼運行或為項目做出貢獻，可以按照以下步驟進行：

1. 克隆倉庫。
2. 安裝依賴項：npm install。
3. 構建項目：npm run build。
4. 運行服務器：npm start。

📄 許可證

本項目採用 MIT 許可證。