Websearch

🚀 ネットワーク検索ガイド

WebSearch MCPサーバーは、ネットワーク検索を実行するためのツールです。特定のドメインの除外、言語や地域の指定など、さまざまな高度な機能をサポートしています。以下に詳細な使用ガイドを示します。

🚀 クイックスタート

WebSearch MCPサーバーを使用するには、まずサーバーを起動する必要があります。起動方法には、Dockerを使用する方法と手動でインストールする方法があります。

📦 インストール

Dockerを使用したサービスの実行

以下のコマンドを使用すると、WebSearch MCPサーバーをすばやく起動できます。

docker-compose up --build

このコマンドは、WebSearchサービスとFlareSolverr（反スパム検証を処理するためのもの）を含むすべての必要なコンテナを構築して実行します。

手動インストール

1. リポジトリをクローンします。

   git clone <repository-url>
   cd websearch-mcp-server
   

2. 依存関係をインストールします。

   npm install
   

3. 開発モードを起動します。

   npm run dev
   

✨ 主な機能

WebSearch MCPサーバーは以下の機能を提供します。

• 多言語対応：指定した言語に基づいて検索結果を返します。
• 地域制限：地域コードに基づいて結果をフィルタリングできます。
• ドメインの除外：特定のドメインを指定して、そのサイトの内容が表示されないようにできます。
• 複数の結果タイプ：「all」、「news」、「blogs」の3種類の結果タイプをサポートしています。

応答例

{
  "query": "機械学習のトレンド",
  "results": [
    {
      "title": "2025年の人工知能の発展トレンド",
      "snippet": "2025年の重要な人工知能のトレンドには、マルチモーダルAI、生成モデル、量子人工知能の企業での応用などがあります...",
      "url": "https://example.com/ml-trends-2025",
      "siteName": "人工知能研究今日",
      "byline": "ジェーン・スミス博士"
    },
    {
      "title": "機械学習の5年間の進化：2020 - 2025",
      "snippet": "過去5年間で、機械学習は教師あり学習方法から、より複雑な自己教師付き学習や強化学習のパラダイムに発展しました...",
      "url": "https://example.com/ml-evolution",
      "siteName": "テクノロジー洞察",
      "byline": "ジョン・ドウ"
    }
  ]
}

💻 使用例

基本的な使用法

コマンドラインツールとして

以下のコマンドを実行してMCPサーバーを起動します。

npm run start

次に、提供されているテストクライアントを使用してサーバーとやり取りします。

npm run test-client

ライブラリとして

このパッケージをプログラムで使用することもできます。

import { createMCPClient } from '@modelcontextprotocol/sdk';

// MCPクライアントを作成
const client = createMCPClient({
  transport: { type: 'subprocess', command: 'npx websearch-mcp' }
});

// ネットワーク検索を実行
const response = await client.request({
  method: 'call_tool',
  params: {
    name: 'web_search',
    arguments: {
      query: 'あなたの検索キーワード',
      numResults: 5,
      language: 'zh'
    }
  }
});

console.log(response.result);

📚 ドキュメント

トラブルシューティング

ネットワーク検索サービスの問題

• エラーメッセージ：エラーログの出力がないか確認してください。
• 反スパム検証：FlareSolverrが正常に動作していることを確認してください。

開発上の問題

• 依存関係の欠落：インストールが失敗した場合は、npm installを再度実行してください。
• ビルド失敗：プロジェクトのpackage.jsonファイルが完全であることを確認してください。

プロジェクト構造

websearch-mcp-server/
├── src/                 # ソースコードディレクトリ
│   ├── index.js       # エントリーファイル
│   └── server.js      # サーバー設定
├── package.json       # 依存関係とスクリプト
└── docker-compose.yml # Docker設定ファイル

npmパッケージの公開

1. package.jsonのバージョン番号を更新します。
2. 変更をコミットします。

   git add .
   git commit -m "バージョン更新"
   

3. パッケージをパックして公開します。

   npm pack
   npm publish
   

コントリビューションガイド

• リポジトリをフォークし、あなたのブランチで開発を行ってください。
• Pull Requestを送信する前に、コードがすべてのテストに合格していることを確認してください。

ありがとうございました！WebSearch MCPサーバーをご利用いただきまして。何か問題があれば、いつでもメンテナンスチームにお問い合わせください。