MCP Web Search

MCP Web Search Serverのstdioサーバーです。MCPプロトコル処理とCursor連携を担当し、Web検索、論文検索、特許検索の3つのツールを提供します。

インストール

# グローバルインストール
npm install -g mcp-web-search

# またはnpxで直接実行
npx mcp-web-search

概要

このstdioサーバーは以下の機能を提供します：

• MCPプロトコル処理: Cursor等のMCPクライアントとの通信
• ツール登録: 3つの検索ツール（Web、論文、特許）の登録
• API呼び出し: APIサーバーへのHTTPリクエスト
• レスポンス変換: APIレスポンスをMCP形式に変換

利用可能なツール

1. Web検索ツール（search_web）

• 機能: Google Custom Search APIを使用したWeb検索
• パラメータ:
  • query: 検索クエリ（必須）
  • site: 特定サイト限定検索（オプション）
  • maxResults: 取得する結果数（1-50、デフォルト: 10）
  • dateRange: 期間指定（オプション）

2. 学術論文検索ツール（search_papers）

• 機能: arXiv、PubMedでの学術論文検索
• パラメータ:
  • query: 検索クエリ（必須）
  • sources: 検索対象のデータベース（arxiv, pubmed、デフォルト: arxiv）
  • maxResults: 取得する結果数（1-50、デフォルト: 10）
  • sortBy: ソート順（relevance, date、デフォルト: relevance）
  • dateRange: 期間指定（オプション）

3. 特許検索ツール（search_patents）

• 機能: EPO APIを使用した特許検索
• パラメータ:
  • query: 検索クエリ（必須）
  • searchField: 検索フィールド（all, title, abstract, claims、デフォルト: all）
  • countryFilter: 国フィルター（オプション）
  • maxResults: 取得する結果数（1-100、デフォルト: 10）
  • dateRange: 期間指定（オプション）

Cursor設定

mcp.json設定

Cursorの設定ファイル（mcp.json）に以下を追加：

通常利用（推奨）

{
  "mcpServers": {
    "mcp-web-search": {
      "command": "npx",
      "args": ["mcp-web-search"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

注意: API_SERVER_URLは設定不要です。デフォルトでhttps://mcp-web-search-api.run.appが使用されます。

ローカル開発時

{
  "mcpServers": {
    "mcp-web-search": {
      "command": "npx",
      "args": ["mcp-web-search"],
      "env": {
        "API_SERVER_URL": "http://localhost:8080",
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

環境変数

| 変数名 | 必須 | デフォルト値 | 説明 | |---|---|---|---| | API_KEY | ✅ | - | API認証キー | | API_SERVER_URL | ❌ | https://mcp-web-search-api.run.app | APIサーバーのURL |

設定例

# 通常利用（API_SERVER_URLは設定不要）
export API_KEY="your_api_key_here"

# ローカル開発時
export API_SERVER_URL="http://localhost:8080"
export API_KEY="your_api_key_here"

使用方法

Cursor内での利用

セットアップ完了後、Cursor内で以下のツールが利用可能になります：

// Web検索
search_web({
  query: "AI最新ニュース",
  maxResults: 5,
  dateRange: "1w"
})

// 論文検索
search_papers({
  query: "深層学習",
  sources: ["arxiv", "pubmed"],
  maxResults: 10
})

// 特許検索
search_patents({
  query: "AI特許",
  searchField: "title",
  maxResults: 10
})

開発

セットアップ

# 依存関係のインストール
npm install

# 開発モードで起動
npm run dev

ビルド

# TypeScriptコンパイル
npm run build

# 実行
npm start

テスト

# 単体テスト
npm test

# 動作確認
npx mcp-web-search --version

ライセンス

ISC License

著作権

Copyright (c) 2024 株式会社QunaSys