MCP Url Fetcher

🚀 MCP URL 格式转换器

MCP URL 格式変換器は、任意の URL からコンテンツを取得し、必要な出力形式に変換するモデルコンテキストプロトコル（MCP）サーバーです。このツールは、大規模言語モデルが一貫した形式でウェブコンテンツにアクセス、変換、分析するのを支援します。

🚀 クイックスタート

MCP URL 形式変換器は、元のコンテンツタイプに関係なく、任意のソースからコンテンツを取得し、HTML、JSON、Markdown、またはプレーンテキストなどの複数の形式に変換するツールを提供します。これは、デスクトップ用のClaudeを含む、すべての MCP 互換クライアントとともに使用するように設計されています。

✨ 主な機能

• 🔄 形式変換：任意のウェブコンテンツを HTML、JSON、Markdown、またはプレーンテキストに変換します。
• 🌐 汎用入力サポート：ウェブサイト、API、生ファイルなどを処理します。
• 🔍 スマートコンテンツ認識：ソース形式を自動検出します。
• 🧰 強力なライブラリサポート：
  • Cheerio を使用した HTML 解析
  • Marked を使用した Markdown 処理
  • Fast-XML-Parser を使用した XML 処理
  • CSVtoJSON を使用した CSV 変換
  • SanitizeHTML を使用したコンテンツのサニタイズ
  • Turndown を使用した 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. サーバーを起動します：

node index.js

💻 使用例

基本的な使用法

# 例：HTML を JSON に変換する
curl -X POST http://localhost:3000/convert \
     --data-raw '{"url":"https://example.com","format":"json"}'

📚 ドキュメント

1. MCP URL 形式変換器の機能概要

このツールは、ユーザーが任意の URL からコンテンツを取得し、必要な形式に変換することを可能にします。サポートされる形式には、HTML、JSON、Markdown、およびプレーンテキストが含まれます。

2. インストールと設定

インストールする前に、システムが以下の要件を満たしていることを確認してください：

• Node.js バージョン >=16.x
• npm または yarn が正しくインストールされている

次に、以下の手順に従ってください：

1. このリポジトリをローカルにクローンします。
2. プロジェクトディレクトリで npm install を実行して、すべての依存関係をインストールします。
3. サーバーを起動して使用を開始します。

🔧 技術詳細

ツール一覧

セキュリティ対策

このツールには、いくつかのセキュリティ対策が組み込まれています：

• コンテンツのサニタイズ（SanitizeHTML）による XSS 攻撃防止
• コンテンツの検証と処理前のセキュリティチェック
• エラー処理とデフォルトのセキュリティ設定
• 入力パラメータの検証（Zod を使用）
• 出力エンコーディングのセキュリティ

テスト

MCP チェッカーを使用してこのツールをテストすることができます：

npm run test

よくある質問

1. 接続エラー

接続エラーが発生した場合は、URL が正しく、アクセス可能であることを確認してください。

2. 変換エラー

一部の複雑なコンテンツは、必要な形式にうまく変換できない場合があります。

3. クロスオリジン問題

一部のウェブサイトは、未知のソースからのリクエストをブロックする場合があります。

4. デバッグモード

より多くのデバッグ情報が必要な場合は、DEBUG 環境変数を設定します：

DEBUG=mcp:* npm start

📄 ライセンス

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

謝辞

• モデルコンテキストプロトコル を使用して構築
• 最新で、積極的に保守され、セキュリティに配慮したライブラリを採用
• コンテンツのサニタイズは OWASP の推奨事項に基づいています

更新日: 2025年3月29日