mcp-server-local-web-search

mcp-server-local-web-search

ローカルウェブ検索を実行する MCP サーバーです。このサーバーは、Model Context Protocol を通じてウェブページを検索し、コンテンツを抽出するツールを提供します。

機能

• 結果数をカスタマイズしてウェブ検索を実行します
• ウェブページからコンテンツを抽出して処理します
• タイトル、URL、説明を含む構造化された結果を返します
• コンテンツの切り詰めとドメインフィルタリングに対応します
• Readability を使用してコンテンツをすっきりと抽出します
• パフォーマンス向上のため、ヘッドレスブラウザーで動作します

インストール

依存関係をインストールするには、次のコマンドを実行します。

bun install

セットアップ

セットアップスクリプトを実行して、MCP サーバーを設定します。

bun run setup.ts

これにより、サーバーが Claude の MCP 設定に追加されます。

利用可能なツール

1. local_web_search
   • ウェブ検索を実行し、タイトル、URL、説明を含む結果を返します
   • パラメーター：
     • query：関連するコンテンツを見つけるための検索クエリ（必須）
     • excludeDomains：検索結果から除外するドメインのリスト（デフォルト：[]）
     • limit：返す結果の最大数（デフォルト：5）
     • truncate：結果ごとに返すコンテンツの最大文字数（デフォルト：4000）
     • show：デバッグ用にブラウザーウィンドウを表示するかどうか（デフォルト：false）
     • proxy：リクエストに使用するプロキシサーバー（任意）

必要条件

• Bun ランタイム
• Node.js の TypeScript サポート

開発

このプロジェクトでは、次を使用しています。

• JavaScript ランタイムとして Bun
• 型安全性のための TypeScript
• サーバー実装のための Model Context Protocol SDK
• ウェブ検索のための @egoist/local-web-search（playwright-core を使用）
• コンテンツ抽出のための Readability

コントリビューター

• egoist - オリジナルのローカルウェブ検索の作者
• FradSer - オリジナルの作者
• TheSethRose - Playwright の統合とパフォーマンス改善

ライセンス

MIT License

このプロジェクトは、bun v1.2.2 で bun init を使用して作成されました。Bun は高速なオールインワンの JavaScript ランタイムです。