Q1 Crafter Mcp

🎓 Q1 Crafter MCP

Claude Desktop 向けの学術研究用 MCP サーバー
18 のデータベースからの文献検索から、Q1 品質の APA 7 形式の .docx 出力まで、
研究サイクル全体を自動化します。

機能 • クイックスタート • Claude Desktop • ツール • ソース • コントリビューション

✨ 機能

🚀 クイックスタート

インストール

pip install q1-crafter-mcp

設定

# Copy the example env file
cp .env.example .env

# Add your API keys (optional — free sources work without any keys!)
# Edit .env and fill in the keys you have

実行

q1-crafter-mcp

🖥️ Claude Desktop のセットアップ

Claude Desktop の設定ファイルに追加します。

{
  "mcpServers": {
    "q1-crafter": {
      "command": "python",
      "args": ["-m", "q1_crafter_mcp.server"],
      "env": {
        "SCOPUS_API_KEY": "your-scopus-key",
        "IEEE_API_KEY": "your-ieee-key",
        "SPRINGER_API_KEY": "your-springer-key",
        "NCBI_API_KEY": "your-pubmed-key",
        "UNPAYWALL_EMAIL": "[email protected]"
      }
    }
  }
}

{
  "mcpServers": {
    "q1-crafter": {
      "command": "python3",
      "args": ["-m", "q1_crafter_mcp.server"],
      "env": {
        "SCOPUS_API_KEY": "your-scopus-key",
        "IEEE_API_KEY": "your-ieee-key",
        "SPRINGER_API_KEY": "your-springer-key"
      }
    }
  }
}

💡 ヒント： すべての API キーを用意する必要はありません。無料のソース（arXiv、CrossRef、OpenAlex、PubMed など）はすぐに利用できます。有料キーを追加すると、さらに多くのデータベースを利用できます。

🔧 トラブルシューティング

"command": "python",
"args": ["-m", "q1_crafter_mcp.server"]

# Find where it's installed:
pip show q1-crafter-mcp
# Look at the "Location" field, then the Scripts folder next to it

# Example: C:\Users\YourName\AppData\Roaming\Python\Python313\Scripts\q1-crafter-mcp.exe

"command": "C:\\Users\\YourName\\AppData\\Roaming\\Python\\Python313\\Scripts\\q1-crafter-mcp.exe"

python -m q1_crafter_mcp.server

pip install --force-reinstall q1-crafter-mcp

🛠 利用可能なツール

🔍 検索ツール

📊 分析ツール

📈 可視化ツール

📝 出力ツール

🌐 対応ソース

🏗 アーキテクチャ

q1-crafter-mcp/
├── src/q1_crafter_mcp/
│   ├── server.py            # MCP server + 14 tool registrations
│   ├── config.py            # Settings & API key management
│   ├── models.py            # Pydantic data models
│   └── tools/
│       ├── search/          # 18 API clients + aggregator + dedup
│       ├── analysis/        # Gap analyzer, keywords, summarizer
│       ├── visualization/   # Charts, tables, citation network
│       └── output/          # APA formatter, section writer, DOCX
├── tests/                   # 120 unit tests
├── pyproject.toml
└── .env.example

動作の仕組み

graph LR
    A[Claude Desktop] -->|MCP| B[Q1 Crafter Server]
    B --> C[🔍 Search 18 APIs]
    C --> D[🔄 Deduplicate]
    D --> E[📊 Analyze]
    E --> F[📈 Visualize]
    E --> G[📝 APA 7 Format]
    G --> H[📄 .docx Output]

1. 検索 — 最大18のデータベースに並列でクエリを送信し、分野に応じて振り分けます（医学 → PubMed、コンピューターサイエンス → Semantic Scholar）
2. 重複排除 — DOI の完全一致とタイトルのあいまい一致（しきい値92％）により重複を除去します
3. 分析 — テーマ、ギャップ、傾向を特定し、キーワードを抽出します
4. 可視化 — グラフ、表、引用ネットワークを生成します
5. 書式設定 — 引用と参考文献に APA 第7版の規則を適用します
6. 出力 — すべてをまとめて、書式設定済みの .docx 原稿を作成します

📖 使用例

Claude に自然な言葉で尋ねるだけです。

🗣 「2020～2024年の創薬における機械学習に関する論文を検索し、結果を分析して、APA 第7版の引用を含む文献レビューのセクションを生成してください。」

Claude は自動的に次の処理を行います。

1. 利用可能なデータベースを検索します
2. 重複を排除し、結果を順位付けします
3. テーマを分析し、ギャップを特定します
4. 書式設定済みの引用を生成します
5. 適切な参考文献を含む、構成の整ったセクションを執筆します

🔑 API キーの設定

🧪 開発

# Clone the repo
git clone https://github.com/ZaEyAsa/q1-crafter-mcp.git
cd q1-crafter-mcp

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

📊 テストカバレッジ

📄 ライセンス

MIT © ZaEyAsa

より優れたツールを使うに値する研究者のために、❤️を込めて作られています。
_{研究に役立ったら、GitHub で ⭐ を付けてください！}