Academic Paper Search

🚀 学術論文検索MCPサーバー

このサーバーは、Model Context Protocol (MCP)に基づいて構築されており、複数のソースから学術論文情報を検索および取得することができます。

このサーバーは、大規模言語モデル（LLMs）に以下の機能を提供します：

• リアルタイムの学術論文検索機能
• 論文のメタデータと要約へのアクセス
• 利用可能な全文内容を取得する機能
• MCP規格に準拠した構造化データの応答

主にAnthropicのClaudeデスクトップクライアントとの統合を目的として設計されていますが、MCP規格により、他のツール/機能呼び出し能力をサポートするAIモデルやクライアント（例：OpenAIのAPI）とも互換性があります。

注意：このソフトウェアは積極的に開発中です。機能や特性は変更される可能性があります。

✨ 主な機能

このサーバーは以下のツールを提供します：

• search_papers：複数のソースで学術論文を検索します。

  • パラメータ：
    • query (str): 検索クエリのテキスト
    • limit (int, オプション): 結果の最大数（デフォルト値: 10）
  • 戻り値：論文の詳細情報を含むフォーマット済みの文字列

• fetch_paper_details：特定の論文の詳細情報を取得します。

  • パラメータ：
    • paper_id (str): 論文の識別子（DOIまたはSemantic Scholar ID）
    • source (str, オプション): データソース ("crossref" または "semantic_scholar", デフォルト値: "crossref")
  • 戻り値：以下を含む包括的な論文のメタデータを含むフォーマット済みの文字列
    • タイトル、著者、出版年
    • DOI、タイトル、要約

• search_by_topic：トピックで論文を検索します。

  • パラメータ：
    • topic (str): 検索するトピックまたはキーワード
    • year_range (tuple, オプション): 出版年の範囲（例: (2015, 2023)）
    • language (str, オプション): 論文の言語（例: "English", "Chinese" など）
  • 戻り値：一致する論文のタイトルと要約を含むリスト

📦 インストール

Smitheryを使用する場合

以下のコマンドを使用してサーバーをインストールし、実行します：

smithery install @afrise/academic-search-mcp-server
smithery run

手動でインストールする場合（uvを使用）

1. リポジトリをクローンします：git clone https://github.com/yourusername/academic-paper-search.git
2. 依存関係をインストールします：

   cd academic-paper-search
   pip install -r requirements.txt
   

3. 環境変数を設定します：

   export API_KEY=your_api_key_here  # 認証が必要な場合
   

4. サーバーを起動します：

   python server.py
   

💻 使用例

基本的な使用法

Claudeデスクトップクライアントでサーバーを設定するには、以下の手順を実行します：

1. 設定を開き、プラグインセクションに移動します。
2. 以下のJSON設定を追加します：

   {
     "server_url": "http://localhost:8000",
     "api_key": "your_api_key_here"
   }
   

🔧 技術詳細

このプロジェクトは以下の技術を使用しています：

• Python MCP SDK: MCPプロトコルのサポートを提供します。
• FastMCP: 高性能のMCPサーバーフレームワークです。
• httpx: 非同期HTTPクライアントとサーバーです。

APIのソース：

• Semantic Scholar API: 高品質の学術論文データを提供します。
• Crossref API: 出版物のメタデータを取得します。

📄 ライセンス

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

🤝 貢献ガイド

貢献を歓迎します！以下は参加方法です：

1. リポジトリをForkします：git clone https://github.com/yourusername/academic-paper-search.git
2. 機能ブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m 'Add amazing feature'
4. ブランチにプッシュします：git push origin feature/amazing-feature
5. Pull Requestを送信します。

注意事項：

• 既存のコードスタイルと規約に従ってください。
• 新しい機能にはテストを追加してください。
• 関連するドキュメントを更新してください。
• 変更がAGPL - 3.0ライセンスの条項に準拠していることを確認してください。

このプロジェクトに参加することで、あなたの貢献がAGPL - 3.0ライセンスに基づいて公開されることに同意するものとします。