One Search MCP

🚀 OneSearch MCP サーバー：ネットワーク検索、クローリング、抽出

OneSearch MCPサーバーは、Searxng、Tavily、DuckDuckGo、Bingなどの複数の検索エンジンを統合したモデルコンテキストプロトコル（MCP）サーバーです。ネットワーク検索、ローカルブラウザ検索、ウェブページのクローリング、コンテンツの抽出機能をサポートし、Firecrawlとも統合されています。

✨ 主な機能

• 複数の検索・クローリングツールをサポート：SearXNG、Firecrawl、Tavily、DuckDuckGo、Bingなどの様々なツールを利用できます。
• ローカルブラウザ検索：Bing、Google、Baidu、Sogouなどの複数の検索エンジンをサポートします。
  • puppeteer-coreを使用してウェブページの内容を取得します。
  • Chromium、Google Chrome、Google Chrome Canaryなどのローカルブラウザのインストールが必要です。
  • 無料で使用でき、APIキーも不要です。
• 有効化されたツール：one_search、one_scrape、one_map
• 自ホストサービスのサポート：SearXNG、Firecrawlなどの自ホストサービスをサポートしています（デプロイを参照）。

📦 インストール

Smitheryを使用した自動インストール

Smitheryを通じて、Claude DesktopにOneSearchを自動インストールできます。

npx -y @smithery/cli install @yokingma/one-search --client claude

手動インストール

# 手動インストール（オプション）
npm install -g one-search-mcp

# npxを使用する場合
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp

環境変数の設定

検索エンジン関連

• SEARCH_PROVIDER（オプション）：使用する検索プロバイダーで、searxng、duckduckgo、bing、tavily、localがサポートされており、デフォルトはlocalです。
• SEARCH_API_URL（オプション）：SearxNG APIのURLで、searxngを使用する場合は必須です。
• SEARCH_API_KEY（オプション）：使用する検索エンジンに応じたAPIキーです。

設定例

# Searxngを使用し、プロキシとログレベルを指定する
SEARXNG_API_URL=https://api.searxng.org \
SEARXNG_API_KEY=your_api_key_here \
SEARCH_PROVIDER=searxng \
LOG_LEVEL=debug

各プラットフォームでの実行設定

Cursorでの実行設定

{
  "mcp": {
    "servers": [
      {
        "type": "file",
        "path": "./config.json"
      }
    ],
    "tools": {
      "one_search": {
        "env": {
          "SEARCH_API_URL": "http://127.0.0.1:8080",
          "FIRECRAWL_API_URL": "http://127.0.0.1:3002"
        }
      }
    }
  }
}

Windsurfでの実行設定

{
  "mcp_server": {
    "tools": {
      "one_search": {},
      "one_scrape": {},
      "one_map": {}
    }
  }
}

自ホストサービス

• Searxng：API呼び出しによるネットワーク検索をサポートします。
• Firecrawl：強力なウェブページクローリングとクローラー機能を提供します。

トラブルシューティング

ネットワーク接続問題

SearxngまたはFirecrawlサービスにアクセスできない場合は、ネットワーク設定とプロキシ設定を確認してください。

# APIの接続性を確認する
curl https://api.searxng.org

ログとデバッグ情報

問題の解決を支援するために、詳細なログ出力を有効にすることができます。

# debugレベルのログを有効にする
LOG_LEVEL=debug one-search-mcp

📄 ライセンス

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

以上の内容を参考に、OneSearch MCPサーバーのインストール、設定、使用方法を詳細に理解し、実際のニーズに合わせて調整・最適化することができます。