MCP URLフォーマットコンバーター

任意の URL からコンテンツを取得し、必要な出力形式に変換するモデル コンテキスト プロトコル (MCP) サーバー。

概要

MCP URLフォーマットコンバーターは、元のコンテンツの種類を問わず、あらゆるWeb URLからコンテンツを取得し、様々な形式（HTML、JSON、Markdown、プレーンテキスト）に変換するためのツールを提供します。Claude for Desktopを含むあらゆるMCP対応クライアントと連携するように設計されており、LLMは一貫した形式でWebコンテンツにアクセスし、変換および分析できます。

特徴

• 🔄フォーマット変換: あらゆるウェブコンテンツをHTML、JSON、Markdown、またはプレーンテキストに変換します
• 🌐ユニバーサル入力サポート：ウェブサイト、API、RAWファイルなどを処理します
• 🔍自動コンテンツ検出：ソース形式をインテリジェントに識別
• 🧰堅牢なライブラリサポート：業界標準のライブラリを使用します。
  • HTML解析用のCheerio
  • Markdown処理対象としてマーク
  • XML処理のための高速XMLパーサー
  • CSV変換のためのCSVtoJSON
  • セキュリティのためにHTMLをサニタイズする
  • HTMLからMarkdownへの変換のターンダウン
• 🔧高度なフォーマット処理：
  • メタデータ抽出によるHTML解析
  • JSONの整形印刷と構造の保存
  • スタイル付きのMarkdownレンダリング
  • CSVからテーブルへの変換
  • XMLからJSONへの変換
• 📜履歴追跡：最近取得したURLのログを保持します
• 🛡️セキュリティの焦点：XSS攻撃を防ぐためのコンテンツサニタイズ

インストール

前提条件

• Node.js 16.x 以上
• npmまたはyarn

クイックスタート

1. リポジトリをクローンします。
   git clone https://github.com/yourusername/mcp-url-converter.git cd mcp-url-converter
2. 依存関係をインストールします:
   npm install
3. プロジェクトをビルドします。
   npm run build
4. サーバーを実行します。
   npm start

Claude for Desktopとの統合

1. Claude for Desktop の構成ファイルを開きます。
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. URL コンバーター サーバーを構成に追加します。
   { "mcpServers": { "url-converter": { "command": "node", "args": ["/absolute/path/to/mcp-url-converter/build/index.js"] } } }
3. デスクトップ版のClaudeを再起動する

利用可能なツール

fetch

任意の URL からコンテンツを取得し、最適な出力形式を自動的に検出します。

パラメータ:

• url (文字列、必須): コンテンツを取得するURL
• format (文字列, オプション): 変換後のフォーマット ( auto 、 html 、 json 、 markdown 、 text )。デフォルト: auto

例：

fetch-json

任意の URL からコンテンツを取得し、JSON 形式に変換します。

パラメータ:

• url (文字列、必須): コンテンツを取得するURL
• prettyPrint (boolean, オプション): JSONを整形して印刷するかどうか。デフォルト: true

例：

fetch-html

任意の URL からコンテンツを取得し、HTML 形式に変換します。

パラメータ:

• url (文字列、必須): コンテンツを取得するURL
• extractText （ブール値、オプション）：テキストコンテンツのみを抽出するかどうか。デフォルト： false

例：

fetch-markdown

任意の URL からコンテンツを取得し、Markdown 形式に変換します。

パラメータ:

• url (文字列、必須): コンテンツを取得するURL

例：

fetch-text

任意の URL からコンテンツを取得し、プレーン テキスト形式に変換します。

パラメータ:

• url (文字列、必須): コンテンツを取得するURL

例：

web-searchとdeep-research

これらのツールは、Perplexity 検索機能へのインターフェイスを提供します (MCP ホストでサポートされている場合)。

利用可能なリソース

recent-urls://list

タイムスタンプと出力形式を含む最近取得した URL のリストを返します。

例：

安全

このサーバーはいくつかのセキュリティ対策を実装しています。

• XSS攻撃を防ぐためにsanitize-htmlを使用してHTMLをサニタイズする
• 処理前のコンテンツ検証
• エラー処理と安全なデフォルト
• Zodによる入力パラメータ検証
• 安全な出力エンコーディング

テスト

MCP Inspector を使用してサーバーをテストできます。

トラブルシューティング

よくある問題

1. 接続エラー: URL がアクセス可能であり、正しい形式であることを確認してください
2. 変換エラー: 複雑なコンテンツは、形式間できれいに変換されない場合があります。
3. クロスオリジンの問題: 一部のウェブサイトでは不明なソースからのリクエストがブロックされる可能性があります

デバッグモード

追加のデバッグ情報については、 DEBUG環境変数を設定します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• モデルコンテキストプロトコルで構築
• セキュリティを重視した、最新の積極的にメンテナンスされたライブラリを使用します
• OWASP の推奨事項に基づくサニタイズアプローチ

最終更新日: 2025年3月29日