Website To Pdf MCP

🚀 ウェブサイトからPDF/MarkdownへのMCPサーバー

このMCPサーバーは、ウェブサイト（認証保護されたサイトを含む）を取得し、PDFまたはMarkdownドキュメントに変換することができます。また、ウェブページ上のリンクをたどり、生成されたドキュメントに含めることも、見つかったURLを返すこともできます。

✨ 主な機能

• 単一のウェブページをPDFに変換する
• ウェブページをMarkdown形式に変換する
• ウェブページ上のリンクをたどり、複数のページを1つの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）

レスポンス： レスポンスは、適切なContent-Typeヘッダーを持つPDFドキュメントになります。

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と同じです。

レスポンス： レスポンスは、適切なContent-Typeヘッダーを持つMarkdownドキュメントになります。

Content-Type: text/markdown

Markdownコンテンツは、レスポンスボディに直接返されます。

ウェブサイトをたどり、URLを取得する

POST /api/get-urls

リクエストボディ：

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

パラメータ： /api/convertと同じです。

レスポンス： レスポンスは、見つかったすべてのURLを含むJSON配列になります。

[
  "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」で認証する