Website To Pdf MCP

🚀 網站到PDF/Markdown MCP服務器

此MCP服務器能夠抓取網站（包括需要身份驗證的網站），並將其轉換為PDF或Markdown文檔。它還支持遍歷網頁上的鏈接，將生成的文檔包含在內，或者返回發現的URL，為網頁內容處理提供了便利。

🚀 快速開始

此MCP服務器可幫助你輕鬆將網站轉換為PDF或Markdown文檔，以下是快速開始的步驟：

1. 克隆此倉庫
2. 安裝依賴項：

   npm install
   

3. 複製示例環境文件：

   cp .env.example .env
   

4. 啟動服務器：

   npm start
   

✨ 主要特性

• 🔄 將單個網頁轉換為PDF
• 📝 將網頁轉換為Markdown格式
• 🔗 遍歷網頁上的鏈接並將多個頁面轉換為一個PDF或Markdown文件
• 🔐 支持通過用戶名和密碼進行身份驗證
• ⚙️ 可配置的最大頁面限制（用於鏈接遍歷）
• 🔍 遍歷網站鏈接並返回發現的URL而不進行轉換

📦 安裝指南

1. 克隆倉庫：將項目倉庫克隆到本地。
2. 安裝依賴：在項目根目錄下運行以下命令安裝所需依賴。

   npm install
   

3. 配置環境：複製示例環境文件並進行必要的配置。

   cp .env.example .env
   

4. 啟動服務：運行以下命令啟動服務器。

   npm start
   

📚 詳細文檔

API端點

將網站轉換為PDF

POST /api/convert

請求正文：

{
  "url": "https://example.com",
  "username": "optional-username",
  "password": "optional-password",
  "traverseLinks": true,
  "maxPages": 10
}

參數說明：

• url：（必填）要轉換為PDF的URL。
• username：（可選）用於身份驗證的用戶名。
• password：（可選）用於身份驗證的密碼。
• traverseLinks：（可選）是否遍歷網頁上的鏈接（默認值：false）。
• maxPages：（可選）遍歷鏈接時處理的最大頁面數（默認值：10）。 響應：響應將是一個PDF文檔，帶有適當的Content-Type頭。

Content-Type: application/pdf
Content-Disposition: attachment; filename="example_com.pdf"

二進制的PDF內容直接在響應正文返回。

將網站轉換為Markdown

POST /api/to-markdown

請求正文：

{
  "url": "https://example.com",
  "username": "optional-username",
  "password": "optional-password"
}

參數：與/api/convert相同。 響應：響應將是一個Markdown文檔，帶有適當的Content-Type頭。

Content-Type: text/markdown

Markdown內容直接在響應正文返回。

遍歷網站並獲取URL

POST /api/get-urls

請求正文：

{
  "url": "https://example.com",
  "username": "optional-username",
  "password": "optional-password"
}

參數：與/api/convert相同。 響應：響應將是一個JSON數組，包含所有發現的URL。

[
  "https://example.com/page1",
  "https://example.com/page2",
  ...
]

使用說明

對於本地開發，你可以使用工具如ngrok將本地服務器暴露到互聯網：

npm start
# 在另一個終端
ngrok http 3000

然後在Claude中設置MCP時使用ngrok URL。

通過此MCP服務器，你可以在與Claude的對話中直接使用以下功能：

1. 將example.com轉換為PDF
2. 將example.com轉換為Markdown
3. 獲取example.com的所有URL
4. 使用用戶名“myuser”和密碼“mypass”進行身份驗證