Web Scout MCP Server

Web Scout MCP サーバー

DuckDuckGo によるウェブ検索とコンテンツ抽出を行う MCP サーバーです。複数の URL に対応し、メモリを最適化します。

✨ 特長

• 🔍 DuckDuckGo 検索：高速でプライバシーを重視したウェブ検索機能
• 📄 コンテンツ抽出：ウェブページから読みやすく整形されたテキストを抽出
• 🚀 並列処理：複数の URL から同時にコンテンツを抽出
• 💾 メモリの最適化：アプリケーションのクラッシュを防ぐスマートなメモリ管理
• ⏱️ レート制限：API によるブロックを回避するインテリジェントなリクエスト制御
• 🛡️ エラー処理：安定した動作を実現する堅牢なエラー処理

📦 インストール

Smithery 経由でのインストール

Smithery を使って、Claude Desktop 用の Web Scout を自動的にインストールするには：

npx -y @smithery/cli install @pinkpixel-dev/web-scout-mcp --client claude

グローバルインストール

npm install -g @pinkpixel/web-scout-mcp

ローカルインストール

npm install @pinkpixel/web-scout-mcp

🚀 使用方法

コマンドライン

グローバルにインストールした後、次を実行します：

web-scout-mcp

MCP クライアントでの使用

MCP クライアント（Claude Desktop、Cursor など）の config.json に次の内容を追加します：

{
  "mcpServers": {
    "web-scout": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/web-scout-mcp@latest"
      ]
    }
  }
}

環境変数

パッケージを埋め込み、自分で createServer() を呼び出す場合は、環境変数 WEB_SCOUT_DISABLE_AUTOSTART=1 を設定してください。デフォルトでは、公開済みのエントリーポイント（例：node dist/index.js または npx @pinkpixel/web-scout-mcp）を実行すると、stdio トランスポートが自動的に初期化されます。

🧰 ツール

サーバーでは、次の MCP ツールを利用できます：

🔍 DuckDuckGoWebSearch

DuckDuckGo 検索エンジンを使ってウェブ検索を実行し、整理された検索結果のリストを返します。

入力：

• query（文字列）：検索クエリ文字列
• maxResults（数値、省略可）：返す検索結果の最大数（デフォルト：10）

例：

{
  "query": "latest advancements in AI",
  "maxResults": 5
}

出力： タイトル、URL、スニペットを含む、整形済みの検索結果リストです。

📄 UrlContentExtractor

スクリプト、スタイル、ナビゲーションなどの不要な要素を取り除き、ウェブページから読みやすく整形されたコンテンツを取得して抽出します。

入力：

• url：単一の URL 文字列、または URL 文字列の配列

例（単一の URL）：

{
  "url": "https://example.com/article"
}

例（複数の URL）：

{
  "url": [
    "https://example.com/article1",
    "https://example.com/article2"
  ]
}

出力： 指定された URL から抽出したテキストコンテンツです。

🛠️ 開発

# Clone the repository
git clone https://github.com/pinkpixel-dev/web-scout-mcp.git
cd web-scout-mcp

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

📚 ドキュメント

プロジェクトの詳細については、次の資料をご覧ください：

• OVERVIEW.md - 技術概要とアーキテクチャ
• CONTRIBUTING.md - コントリビューター向けガイドライン
• CHANGELOG.md - バージョン履歴と変更内容

📋 要件

• Node.js >= 18.0.0
• npm または yarn

📄 ライセンス

このプロジェクトはApache 2.0 Licenseのもとでライセンスされています。

_{❤️ を込めて Pink Pixel が制作
✨ 夢を描き、ピクセルに ✨}