Google-Scholar-MCP-Server

by JackKuo666
Verified

Integrations

  • Enables searching for academic papers using keywords or advanced search parameters, retrieving paper metadata, accessing author information, and supporting academic research and analysis through Google Scholar.

Google Scholar MCP サーバー

🔍 AI アシスタントがシンプルな MCP インターフェースを通じて Google Scholar 論文を検索しアクセスできるようにします。

Google Scholar MCPサーバーは、モデルコンテキストプロトコル(MCP)を介してAIアシスタントとGoogle Scholar間の橋渡しを提供します。これにより、AIモデルはプログラム的に学術論文を検索し、そのコンテンツにアクセスできるようになります。

✨ コア機能

  • 🔎 論文検索: カスタム検索文字列または高度な検索パラメータを使用して Google Scholar 論文を検索します ✅
  • 🚀 効率的な検索: 論文のメタデータへの高速アクセス ✅
  • 👤 著者情報: 著者に関する詳細情報を取得します ✅
  • 📊 研究支援:学術研究と分析を促進する ✅

🚀 クイックスタート

手動でインストールする

Smithery経由でインストール

Smithery経由で Claude Desktop 用の google-scholar Server を自動的にインストールするには:

クロード

npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client claude --config "{}"

カーソル

次の内容を「設定」→「カーソル設定」→「MCP」→「新しいサーバーの追加」に貼り付けます。

  • Mac/Linux
npx -y @smithery/cli@latest run @JackKuo666/google-scholar-mcp-server --client cursor --config "{}"

ウィンドサーフィン

npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client windsurf --config "{}"

Cライン

npx -y @smithery/cli@latest install @JackKuo666/google-scholar-mcp-server --client cline --config "{}"
  1. リポジトリをクローンします。
    git clone https://github.com/JackKuo666/google-scholar-MCP-Server.git cd google-scholar-MCP-Server
  2. 必要な依存関係をインストールします。
    pip install -r requirements.txt

開発の場合:

# Clone and set up development environment git clone https://github.com/JackKuo666/Google-Scholar-MCP-Server.git cd Google-Scholar-MCP-Server # Create and activate virtual environment python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate` # Install dependencies pip install -r requirements.txt

📊 使用方法

MCP サーバーを起動します。

python google_scholar_server.py

サーバーが起動したら、AIアシスタントやアプリケーションでMCPツールを使用できます。ツールの使用例をいくつかご紹介します。

例1: キーワードを使って論文を検索する

result = await mcp.use_tool("search_google_scholar_key_words", { "query": "artificial intelligence ethics", "num_results": 5 }) print(result)

例2: 詳細検索を実行する

result = await mcp.use_tool("search_google_scholar_advanced", { "query": "machine learning", "author": "Hinton", "year_range": [2020, 2023], "num_results": 3 }) print(result)

例3: 著者情報を取得する

result = await mcp.use_tool("get_author_info", { "author_name": "Geoffrey Hinton" }) print(result)

これらの例は、Google Scholar MCP サーバーが提供する 3 つの主要ツールの使い方を示しています。具体的なユースケースに合わせてパラメータを調整してください。

Claude Desktopでの使用

この設定をclaude_desktop_config.jsonに追加します。

(Mac OS)

{ "mcpServers": { "google-scholar": { "command": "python", "args": ["-m", "google_scholar_mcp_server"] } } }

(Windows版):

{ "mcpServers": { "google-scholar": { "command": "C:\\Users\\YOUR\\PATH\\miniconda3\\envs\\mcp_server\\python.exe", "args": [ "D:\\code\\YOUR\\PATH\\Google-Scholar-MCP-Server\\google_scholar_server.py" ], "env": {}, "disabled": false, "autoApprove": [] } } }

Clineと併用

{ "mcpServers": { "google-scholar": { "command": "bash", "args": [ "-c", "source /home/YOUR/PATH/.venv/bin/activate && python /home/YOUR/PATH/google_scholar_mcp_server.py" ], "env": {}, "disabled": false, "autoApprove": [] } } }

🛠 MCP ツール

Google Scholar MCP サーバーは次のツールを提供します。

検索_google_scholar_キーワード

キーワードを使用して Google Scholar で記事を検索します。

パラメータ:

  • query (str): 検索クエリ文字列
  • num_results (int, オプション): 返される結果の数 (デフォルト: 5)

**戻り値:**記事情報を含む辞書のリスト

検索_google_scholar_advanced

Google Scholar で記事の詳細検索を実行します。

パラメータ:

  • query (str): 一般的な検索クエリ
  • author (str, オプション): 著者名
  • year_range (タプル、オプション): (start_year、end_year) を含むタプル
  • num_results (int, オプション): 返される結果の数 (デフォルト: 5)

**戻り値:**記事情報を含む辞書のリスト

著者情報を取得する

Google Scholar から著者の詳細情報を取得します。

パラメータ:

  • author_name (str): 検索する著者名

**戻り値:**著者情報を含む辞書

📁 プロジェクト構造

  • google_scholar_server.py : FastMCP を使用したメインの MCP サーバーの実装
  • google_scholar_web_search.py : Google Scholarを検索するためのWebスクレイピングロジックが含まれています

🔧 依存関係

  • Python 3.10以上
  • mcp[cli]>=1.4.1
  • 学術的>=1.7.0
  • 非同期>=3.4.3

必要な依存関係は以下を使用してインストールできます。

pip install -r requirements.txt

🤝 貢献する

貢献を歓迎します!お気軽にプルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。

⚠️免責事項

このツールは研究目的のみにご使用ください。Google Scholarの利用規約を遵守し、責任を持ってご利用ください。

ID: i7tmfu11dl