MCP For Research

🚀 学術研究MCPサーバー

強力で統合された研究ツールです。PubMed、Google Scholar、ArXiv、JSTORから学術研究論文を見つけ、分析することができます。たった5つの強力なツールを通じてこれらの作業を行うことができます。

🚀 クイックスタート

このツールは以下の方法で使用することができます。

オプション1: AIアシスタントを通じて使用する（最も簡単 - セットアップ不要）

技術的なセットアップに慣れていない場合は、以下のようなAIアシスタントを通じてこのツールを使用することができます。

• Claude (Anthropic)
• ChatGPT (OpenAI)
• Cursor (AI付きコードエディター)

これらのアシスタントは、あなたが何もセットアップしなくても、このツールを使用して研究論文を見つけるのを助けることができます。

オプション2: 自分のコンピューターにMCPをセットアップする（上級者向け）

このオプションを選ぶと、あなたのコンピューター上のAIアシスタントで直接このツールを使用することができます。これは、あなたのAIアシスタントに研究論文を見つけるための特別なツールを与えるようなものです。

MCP（モデルコンテキストプロトコル）のセットアップ

MCPは、AIアシスタントがあなたのコンピューター上のツールと通信するための「言語」のようなものです。AIアシスタントが使用できる特別なアプリをインストールするようなものだと考えてください。

必要なもの

• コンピューター (Windows、Mac、またはLinux)
• MCPをサポートするAIアシスタント (Claude Desktop、Cursorなど)
• 基本的なコンピュータースキル (ファイルのダウンロード、プログラムの実行)

手順

1. ツールをダウンロードする

   git clone https://github.com/aringadre76/mcp-for-research.git
   cd mcp-for-research
   

2. 依存関係をインストールする

   npm install
   

3. ツールをビルドする

   npm run build
   

4. AIアシスタントを設定する

   • AIアシスタントの設定で「MCPサーバー」または「ツール」を見つけます。
   • 新しいMCPサーバーを追加します。
   • コマンドを node dist/index.js に設定します。
   • 作業ディレクトリをプロジェクトフォルダーに設定します。

5. セットアップをテストする

   npm run test:all-tools-bash
   

✨ 主な機能

• 5つの統合ツール：24個の個別ツールの代わりに、強力で多機能なツールを提供します。
• 複数ソースの検索：PubMed、Google Scholar、ArXiv、JSTORからの検索が可能です。
• ユーザー設定：検索や表示設定をカスタマイズできます。
• コンテンツ抽出：論文の全文取得と分析が可能です。
• 引用管理：複数の引用形式をサポートします。
• エラーハンドリング：堅牢なフォールバックメカニズムが備わっています。

📦 インストール

セットアップ手順

1. ツールをダウンロードする

   git clone https://github.com/aringadre76/mcp-for-research.git
   cd mcp-for-research
   

2. 依存関係をインストールする

   npm install
   

3. ツールをビルドする

   npm run build
   

💻 使用例

基本的な使用法

論文を検索する

{
  "method": "tools/call",
  "params": {
    "name": "research_search",
    "arguments": {
      "query": "machine learning",
      "sources": ["pubmed", "arxiv"],
      "maxResults": 15,
      "startDate": "2020/01/01"
    }
  }
}

論文を分析する

{
  "method": "tools/call",
  "params": {
    "name": "paper_analysis",
    "arguments": {
      "identifier": "12345678",
      "analysisType": "complete",
      "maxQuotes": 20
    }
  }
}

引用を取得する

{
  "method": "tools/call",
  "params": {
    "name": "citation_manager",
    "arguments": {
      "identifier": "12345678",
      "action": "all",
      "format": "apa"
    }
  }
}

📚 ドキュメント

プロジェクト構造

このツールはいくつかの主要なコンポーネントに整理されています。

コアコンポーネント

src/
├── index.ts                           # メインサーバーのエントリーポイント（統合済み）
├── adapters/                          # データソースコネクター
│   ├── pubmed.ts                      # PubMed API統合
│   ├── google-scholar.ts              # Google Scholarのウェブスクレイピング
│   ├── google-scholar-firecrawl.ts    # Firecrawl統合
│   ├── arxiv.ts                       # ArXiv統合
│   ├── unified-search.ts              # 基本的な複数ソース検索
│   ├── enhanced-unified-search.ts     # 高度な複数ソース検索
│   └── preference-aware-unified-search.ts # ユーザー設定統合
├── preferences/                       # ユーザー設定管理
│   └── user-preferences.ts            # 設定の保存と取得
└── models/                            # データ構造とインターフェース
    ├── paper.ts                       # 論文データモデル
    ├── search.ts                      # 検索パラメーターモデル
    └── preferences.ts                 # 設定モデル

ドキュメント

docs/
├── README.md                          # ドキュメントのインデックスと概要
├── CONSOLIDATION_GUIDE.md             # 完全な統合ガイド
├── TOOL_CONSOLIDATION.md              # ツールマッピングのクイックリファレンス
├── PROJECT_STRUCTURE.md               # クリーンなプロジェクト構成
├── API_REFERENCE.md                   # 完全なAPIドキュメント
├── ARCHITECTURE.md                    # 技術的なシステム設計
├── DATA_MODELS.md                     # データ構造定義
├── DEVELOPMENT.md                     # 開発者向けセットアップガイド
└── TROUBLESHOOTING.md                 # 問題解決ガイド

テスト

tests/
├── test-preferences.js                # 設定システムのテスト
├── test-all-tools-simple.sh           # Bashテストランナー（推奨）
├── test_all_tools.py                  # Pythonテストランナー
└── test-all-tools.js                  # JavaScriptテストランナー

設定

├── package.json                       # プロジェクトの依存関係とスクリプト
├── tsconfig.json                      # TypeScriptの設定
├── .env.example                       # 環境変数のテンプレート
└── README.md                          # このファイル

利用可能なツール

サーバーは、以前の24個の個別ツールに代わる5つの統合MCPツールを提供します。

1. research_search

複数のソースからの包括的な研究論文検索で、高度なフィルタリングと統合された結果を提供します。

統合内容: PubMed、Google Scholar、ArXiv、JSTORのすべての個別検索ツール パラメーター: クエリ、ソース、フィルター、表示オプション、ソート

2. paper_analysis

包括的な論文情報、全文、引用、統計、調査結果などの分析を取得します。

統合内容: 論文取得、コンテンツ抽出、分析ツール パラメーター: 識別子、分析タイプ、引用上限、セクション長

3. citation_manager

複数の形式で引用を生成し、引用情報（引用数や関連論文など）を取得します。

統合内容: 引用ツール、引用数カウント、関連論文検索 パラメーター: 識別子、アクション、形式、関連論文上限

4. research_preferences

研究設定（ソースの優先順位、検索設定、表示オプション、キャッシュなど）を管理します。

統合内容: すべての設定管理ツール パラメーター: アクション、カテゴリ、様々な設定値

5. web_research

Firecrawlを使用した信頼性の高いコンテンツ抽出と分析を行うウェブベースの研究を実行します。

統合内容: Firecrawl統合とウェブ研究ツール パラメーター: アクション、ターゲット、オプション、クローリング上限

🔧 技術詳細

統合アプローチの利点

✅ ツール数が80％削減 (24個 → 5個)
✅ 覚えやすく、使いやすい
✅ 強力 - 単一の呼び出しで複数の操作が可能
✅ パフォーマンスが向上 - ツールの登録が少なくなる
✅ 保守が容易 - コードの重複が減る
✅ 一貫したインターフェース - 似たようなパラメーターパターン

旧バージョンからの移行

統合されたツールは下位互換性があります。つまり、同じ機能にアクセスできますが、より少ない、より強力なツールを通じてアクセスできます。各統合ツールは、あなたが正確に何をしたいかを指定できるパラメーターを受け取ります。

トラブルシューティング

一般的な問題と解決策

Q: ツールが起動しない A: まず npm install と npm run build を実行したことを確認してください。

Q: AIアシスタントがツールを見つけられない A: AIアシスタントの設定でMCPサーバーのパスが正しいことを確認してください。

Q: 検索結果が返されない A: 異なる検索用語を試してみるか、設定でソースが有効になっていることを確認してください。

Q: 特定の形式の論文を取得するにはどうすればいいですか？ A: 引用ツールを使用して、必要な形式（APA、MLAなど）の論文を取得してください。

開発

テストの実行

npm run test:all-tools-bash

ビルド

npm run build

開発モード

npm run dev

📄 ライセンス

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

ドキュメントについて

包括的なドキュメント、ガイド、技術的な詳細については、 ディレクトリを参照してください。

• ドキュメント概要 - 完全なドキュメントインデックス
• 統合ガイド - 新しいアプローチの詳細な説明
• ツールリファレンス - 旧ツールから新ツールへのクイックマッピング
• APIリファレンス - 完全なツールドキュメント
• プロジェクト構造 - クリーンなプロジェクト構成

サポート

もし助けが必要な場合は、以下の手順を試してみてください。

1. 上記のトラブルシューティングセクションを確認する
2. docs/ フォルダー内のドキュメントを参照する
3. GitHubで問題を報告する
4. CHANGELOG.md を確認して、最近の更新を確認する

バージョン履歴

• v2.0.0: 24個のツールを5つの強力なツールに統合
• v1.4.x: 24個の個別ツールを持つ前のバージョン
• v1.0.x: 最初のリリース

⚠️ 重要提示

このツールは、強力な研究機能を提供しながら使いやすく設計されています。統合されたアプローチにより、以前のバージョンと同じ機能を維持しながら、使いやすさが向上しています。

💡 使用建议

このツールを使用する際は、ドキュメントやトラブルシューティングセクションを参照することをおすすめします。また、新しいバージョンがリリースされた場合は、移行ガイドを確認して、スムーズに移行できるようにしてください。