Google Scholar MCP Server

Google Scholar MCP サーバー

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

Google Scholar MCP サーバーは、Model Context Protocol（MCP）を通じて、AI アシスタントと Google Scholar をつなぎます。AI モデルが学術論文を検索し、その内容にプログラムからアクセスできるようにします。

✨ 主な機能

• 🔎 論文検索：カスタム検索文字列や高度な検索パラメーターを使って Google Scholar の論文を検索できます ✅
• 🚀 効率的な取得：論文のメタデータにすばやくアクセスできます ✅
• 👤 著者情報：著者の詳細情報を取得できます ✅
• 📊 研究支援：学術研究と分析を支援します ✅

🚀 クイックスタート

手動でインストールする

Smithery 経由でインストールする

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

claude

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

Cursor

以下を Settings → Cursor Settings → MCP → Add new server に貼り付けます：

• Mac/Linux

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

Windsurf

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

CLine

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 サーバーは以下のツールを提供します：

search_google_scholar_key_words

キーワードを使って Google Scholar の論文を検索します。

パラメーター：

• query（str）：検索クエリ文字列
• num_results（int、任意）：返す検索結果の数（デフォルト：5）

戻り値： 論文情報を含む辞書のリスト

search_google_scholar_advanced

Google Scholar の論文を高度な条件で検索します。

パラメーター：

• query（str）：一般的な検索クエリ
• author（str、任意）：著者名
• year_range（tuple、任意）：（start_year、end_year）を含むタプル
• num_results（int、任意）：返す検索結果の数（デフォルト：5）

戻り値： 論文情報を含む辞書のリスト

get_author_info

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

パラメーター：

• author_name（str）：検索する著者の名前

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

📁 プロジェクト構成

• google_scholar_server.py：FastMCP を使用した MCP サーバーの主要な実装
• google_scholar_web_search.py：Google Scholar を検索するためのウェブスクレイピングロジック

🔧 依存関係

• Python 3.10+
• mcp[cli]>=1.4.1
• scholarly>=1.7.0
• asyncio>=3.4.3

必要な依存関係は、以下のコマンドでインストールできます：

pip install -r requirements.txt

🤝 貢献

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

📄 ライセンス

このプロジェクトは MIT License のもとでライセンスされています。

⚠️ 免責事項

このツールは研究目的に限り使用できます。Google Scholar の利用規約を尊重し、責任を持ってご使用ください。