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 等）开箱即用。添加付费 API 密钥即可解锁更多数据库。

🔧 故障排除

"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 上点个 ⭐！}