File Format Converter (Pandoc)

🚀 MCP-Pandoc 說明文檔

MCP-Pandoc 是一款強大的文件格式轉換工具，支持多種常見格式間的轉換。用戶只需指定內容或文件路徑，就能輕鬆將文本或文件轉換為 PDF、Markdown、HTML 等格式，為文件處理帶來極大便利。

🚀 快速開始

MCP-Pandoc 能實現多種文件格式間的轉換，通過簡單的配置和操作，即可完成文件格式的轉換。

✨ 主要特性

• 支持多種文件格式轉換，如 PDF、Markdown、HTML 等。
• 提供手動和自動兩種安裝方式，滿足不同用戶需求。

📦 安裝指南

方式一：通過配置文件手動安裝

• MacOS：打開 ~/Library/Application\ Support/Claude/claude_desktop_config.json 文件。
• Windows：訪問 %APPDATA%/Claude/claude_desktop_config.json 文件。

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

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

方式二：通過 Smithery 自動安裝已發佈的服務器配置

運行以下 bash 命令，自動使用 Smithery 安裝 已發佈 的 MCP-Pandoc PyPI 服務：

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

⚠️ 重要提示

要使用本地配置的 mcp-pandoc，請參考上方 "開發/未發佈的服務器配置" 部分。

📚 詳細文檔

開發指南

構建與發佈

為了將包準備好進行分發，可按以下步驟操作：

1. 同步依賴並更新鎖文件：

uv sync

2. 構建發行版本：

uv build

這將在 dist/ 目錄下創建源代碼和輪格式發行包。

3. 發佈到 PyPI：

uv publish

⚠️ 重要提示

您需要通過環境變量或命令行參數設置 PyPI 憑據：

• Token: --token 或 UV_PUBLISH_TOKEN
• 或者使用用戶名/密碼: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

調試指南

由於 MCP 服務器通過標準輸入輸出運行，調試較為困難。為了獲得最佳的調試體驗，我們強烈推薦使用 MCP Inspector。

您可以通過以下命令啟動 MCP Inspector：

<Inspector 啟動命令>

貢獻指南

如果您希望為項目貢獻力量，請參考 貢獻文檔 瞭解如何參與開發和提交代碼。

說明：本文檔介紹了 MCP-Pandoc 的基本功能、安裝方法以及開發配置等信息，幫助用戶快速上手使用該工具。