Webtools MCP Server

🚀 ネットワークツール MCP サーバー

ネットワークツール MCP サーバーは、ウェブサイトの分析、パフォーマンステスト、品質保証に使用される複数のツールを統合した総合的なウェブ分析プラットフォームです。以下の主要機能を提供します。

✨ 主な機能

1. HTML ページの取得：JavaScript レンダリングをサポートして、ウェブページの内容を取得します。
2. スクリーンショットの生成：ウェブページのビューをキャプチャし、Base64 エンコードされた PNG 画像を返します。
3. ライトハウス審査：Lighthouse 審査を実行し、ウェブサイトのパフォーマンスと SEO を分析します。
4. パフォーマンステスト：さまざまなデバイスとネットワーク条件で、実際のユーザーシナリオをシミュレートします。
5. コードカバレッジ分析：JavaScript コードの使用状況を評価します。
6. デバッグツール：ページのエラーを診断し、レイアウトの揺れを監視します。

📚 ドキュメント

ウェブページ取得ツール

• 基本機能：ウェブページの HTML 内容を取得します。
• パラメータオプション：
  • url：必須。対象のウェブサイトの URL です。
  • waitForSelector：オプション。デフォルトは null。特定のセレクタが表示されるまで待ちます。
  • timeout：デフォルトは 30 秒。タイムアウト時間を設定します。

スクリーンショットツール

• 機能特性：
  • Base64 エンコードされた PNG 画像を返します。
  • カスタムビューポートサイズと拡大率をサポートします。
  • スクリーンショットのプレビュー URL リンクを提供します。

ライトハウス審査ツール

• 主要指標：
  • First Contentful Paint (FCP)
  • Largest Contentful Paint (LCP)
  • Time to Interactive (TTI)
  • Cumulative Layout Shift (CLS)

💻 使用例

応答形式

すべてのツールは、以下の統一された応答形式を使用します。

{
  "content": [
    {
      "type": "text",
      "text": "..." // Markdown 形式のレポート
    }
  ]
}

スクリーンショットの例

{
  "content": [
    {
      "type": "image",
      "data": "...", // Base64 エンコードされた PNG
      "mimeType": "image/png"
    }
  ]
}

💡 使用アドバイス

1. 段階的な分析：基本的な HTML 取得から始めて、高度な分析ツールを使用します。
2. 必要に応じたレンダリング：JavaScript コンテンツが必要な場合のみ、レンダリング機能を有効にします。
3. 適切なタイムアウト設定：複雑なページには、十分なタイムアウト時間を設定します。
4. セレクタの使用：セレクタを使用して対象領域を指定し、取得範囲を最適化します。
5. 条件付きでのプロキシ使用：地理的に制限されたコンテンツにアクセスする場合のみ、プロキシを使用します。

🔧 トラブルシューティング

Chrome のインストール問題

• 注意事項：Chrome は Puppeteer によって自動的にインストールされるため、追加の操作は必要ありません。
• 解決策：問題が発生した場合は、パッケージを再インストールしてください npm install -g @bschauer/webtools-mcp-server

接続問題

• 症状：ウェブサイトに接続できません。
• 診断：URL 形式、ウェブサイトの可用性を確認するか、プロキシを有効にします。

⚠️ 重要な注意事項

• このツールは任意のウェブサイトにアクセスできるため、慎重に使用してください。
• プロキシ機能は慎重に使用し、関連する法律や規制を遵守してください。
• 絶対に必要な場合を除き、SSL 証明書の検証を有効にしたままにしてください。

📄 ライセンス

このプロジェクトは MIT ライセンスに準拠しており、コミュニティからのコードとドキュメントの貢献を歓迎します。

詳細な情報については、元の英語のドキュメントを参照するか、開発チームに直接お問い合わせください。