Q1 Crafter Mcp

Created By

zaeyasa3 months ago

Overview

🎓 Q1 Crafter MCP

Academic Research MCP Server for Claude Desktop
Automates the full research cycle — from source discovery across 18 databases
to Q1-quality, APA 7-formatted .docx output.

Features • Quick Start • Claude Desktop • Tools • Sources • Contributing

✨ Features

Category	Highlights
🔍 Multi-Source Search	Query 18 academic APIs in parallel with smart field-based routing
🔄 Intelligent Dedup	Two-phase deduplication: exact DOI match → fuzzy title (92% Levenshtein)
🇹🇷 Turkish Sources	Native support for TR Dizin, DergiPark (OAI-PMH), YÖK Tez Merkezi
📊 Literature Analysis	Gap detection, keyword extraction (TF-IDF), citation validation
📈 Visualizations	Publication trends, source distribution, citation network (Mermaid)
📝 APA 7 Engine	Full citation formatter — handles 1/2/3+/20+ author rules, DOI formatting
📄 DOCX Generator	One-click manuscript generation with title page, sections, references
⚡ Zero Config	Free sources work instantly; paid APIs activate when keys are provided

🚀 Quick Start

Installation

pip install q1-crafter-mcp

Configuration

# 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

Run

q1-crafter-mcp

🖥️ Claude Desktop Setup

Add to your Claude Desktop configuration file:

📋 Windows — %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "q1-crafter": {
      "command": "q1-crafter-mcp",
      "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": "your-email@example.com"
      }
    }
  }
}

📋 macOS — ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "q1-crafter": {
      "command": "q1-crafter-mcp",
      "env": {
        "SCOPUS_API_KEY": "your-scopus-key",
        "IEEE_API_KEY": "your-ieee-key",
        "SPRINGER_API_KEY": "your-springer-key"
      }
    }
  }
}

💡 Tip: You don't need all API keys! Free sources (arXiv, CrossRef, OpenAlex, PubMed, etc.) work out of the box. Add paid keys to unlock more databases.

🛠 Available Tools

🔍 Search Tools

Tool	Description
`search_academic`	Search up to 18 databases in parallel with smart routing
`search_by_doi`	Look up any paper by its DOI
`search_citations`	Find all papers that cite a given work
`search_references`	Get the reference list of a paper

📊 Analysis Tools

Tool	Description
`analyze_literature`	Identify research gaps, themes, trends, and top-cited papers
`validate_citations`	Bidirectional check: in-text citations ↔ reference list
`extract_keywords`	TF-IDF keyword extraction with bigram support

📈 Visualization Tools

Tool	Description
`generate_comparison_table`	Paper comparison tables (Markdown, CSV, APA format)
`generate_trend_chart`	Publication trend charts (base64 PNG, dark theme)
`generate_citation_network`	Citation network visualization (Mermaid diagram)

📝 Output Tools

Tool	Description
`write_section`	Academic section scaffolding with IMRaD templates
`format_references_apa7`	APA 7th edition reference list formatter
`build_docx`	Generate formatted `.docx` manuscript
`check_api_status`	Check which API sources are available

🌐 Supported Sources

🆓 Free (No Key)	🔑 Free (Key Required)	🏛️ Institutional	🇹🇷 Turkish
arXiv CrossRef OpenAlex Europe PMC DOAJ BASE	Semantic Scholar PubMed (NCBI) CORE Unpaywall	Scopus (Elsevier) Web of Science IEEE Xplore Springer Nature ScienceDirect Dimensions	TR Dizin DergiPark (OAI-PMH) YÖK Tez Merkezi

🏗 Architecture

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

How It Works

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]

Search — Queries up to 18 databases in parallel, routes by field (medicine → PubMed, CS → Semantic Scholar)
Deduplicate — Removes duplicates via exact DOI + fuzzy title matching (92% threshold)
Analyze — Identifies themes, gaps, trends, and extracts keywords
Visualize — Generates charts, tables, and citation networks
Format — Applies APA 7th edition rules for citations and references
Output — Assembles everything into a formatted .docx manuscript

📖 Usage Example

Just ask Claude naturally:

🗣 "Search for papers about machine learning in drug discovery from 2020-2024, analyze the results, and generate a literature review section with APA 7 citations."

Claude will automatically:

Search across available databases
Deduplicate and rank results
Analyze themes and identify gaps
Generate formatted citations
Write a structured section with proper references

🔑 API Key Setup

Source	How to Get Key	Cost
Semantic Scholar	semanticscholar.org/product/api	Free
PubMed (NCBI)	ncbi.nlm.nih.gov/account	Free
CORE	core.ac.uk/services/api	Free
Scopus	dev.elsevier.com	Institutional
IEEE Xplore	developer.ieee.org	Paid
Springer	dev.springernature.com	Free tier
Dimensions	dimensions.ai	Free for research

🧪 Development

# 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/

📊 Test Coverage

Module	Tests	What's Covered
Models	15	Paper, Author, SearchConfig, serialization
APA Formatter	18	In-text, references, ordering, Turkish chars
Config	10	Source availability, key management
Dedup	9	DOI match, fuzzy title, metadata richness
Analysis	18	Gap analysis, keywords, summarizer, citations
Visualization	17	Charts, tables, citation networks
Output	12	Section writer, DOCX generator
Search Base	7	Client lifecycle, safe_search
Total	120	All passing ✅

📄 License

MIT © ZaEyAsa

Built with ❤️ for researchers who deserve better tools.
_{If this helps your research, give it a ⭐ on GitHub!}

Try in Playground

Server Config

{
  "mcpServers": {
    "q1-crafter": {
      "command": "q1-crafter-mcp",
      "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": "your-email@example.com"
      }
    }
  }
}

Project Info

Created At

3 months ago

Updated At

3 months ago

Author Name

zaeyasa

Star

Language

License

Recommend Servers

View All

Personio Recruiting Ops Plane

@Sam Vangelos

Paid-download MCP for asking Personio Recruiting flow questions inside Claude, Cursor, or another MCP client.

11 hours ago

Github

@modelcontextprotocol

Repository management, file operations, and GitHub API integration

a year ago

EdgeOne Pages MCP

@TencentEdgeOne

An MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

TypeScript

a year ago

Unofficial Mcp Server For Primereact 10.x

@wisdomrock

An unofficial MCP Server for PrimeReact 10.x to fill the gap while we wait for the official one (coming with PrimeReact v11). **What it does:** - Covers 105 PrimeReact v10 components parsed from their TypeScript definitions - Exposes props, types, JSDoc descriptions, and event callbacks - Tools include: `get_component`, `get_component_props`, `search_components`, `suggest_component`, `get_form_components`, `get_data_components`, and more **Why it's useful:** If you use Claude Code, Cursor, or any MCP-compatible AI assistant, you can now get accurate PrimeReact component suggestions and code generation grounded in the actual API — no more hallucinated props.

3 hours ago

Push To Display Mcp Server

@pushtodisplay

3 hours ago

302_sandbox_mcp

@302ai

Create a remote sandbox that can execute code/run commands/upload and download files. 创建远程沙盒，可以执行代码/运行命令/上传下载文件

a year ago

Payai X402 Tools

2 hours ago

Puppeteer

@modelcontextprotocol

Browser automation and web scraping

a year ago

302_browser_use_mcp

@302ai

Automatically create a remote browser to complete your specified tasks, developed based on Browser Use + Sandbox. 自动创建一个远程浏览器，完成你指定的任务，基于Browser Use + Sandbox开发。

a year ago

虎嗅嗅 Ai行业参谋

20 hours ago

Sequential Thinking

@modelcontextprotocol

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.

a year ago

Ukrainian Payment Qr Invoices

@Danylo Negriienko

Create a QR code for Ukrainian domestic payments at a point of sale or online and accept cashless payments to IBAN

3 hours ago

Twosio

@2s-io

Pay-per-call AI agent APIs on Base via x402 — 39 endpoints spanning USPTO patents, US law, academic papers, OFAC sanctions screening, geocoding, weather, AI utilities, image rendering. No signup or API keys — each call settles instantly in USDC.

2 days ago

EverArt

@modelcontextprotocol

AI image generation using various models

a year ago

Globestudio

@alevizio

Globestudio is an open-source, designer-first tool for creating dotted maps and animated 3D globes. Choose any region from a single country to the whole world, customize dot shapes and colors, layer on shader effects, and export to PNG, SVG, or animated WebM. Built on React and Three.js, it runs entirely client-side and can be embedded anywhere with a one-line script tag or iframe.

5 hours ago

GitLab

@modelcontextprotocol

GitLab API, enabling project management

a year ago

Existence Synchronization System Entity

@VeniceEsse

MCP server that fuses 2–5 AI agents into one unified mind. Features 7 tools: esse_quick, esse_fuse, esse_execute, esse_list_agents, esse_list_sessions, esse_memory, esse_defuse. Supports Venice AI, OpenAI, and Anthropic. One AI. Many agents. Fused.

a day ago

Test

@modelcontextprotocol

test

6 months ago

Ux Skill

@Laith0003

A deterministic, offline design-intelligence engine for AI coding tools. Replaces improvised UI generation with structured constraints plus a rule-based anti-AI-slop linter. Ships as a Claude Code plugin, a Python package, an MCP server (18 tools), and a 17-IDE installer.

a day ago

LADU Adu Tools

@sirbots

LADU’s MCP server connects AI assistants directly to LA County ADU data. Ask about any address and get a plain-English buildability verdict, the parcel’s zoning and regulatory overlays (hillside, coastal, fire, flood, historic, fault zones), and the governing city’s ADU rules. Query permit statistics for any of 51 supported LA cities — totals, year-over-year trends, and valuation distributions from 19,000+ cleaned permit records going back to 2018. Compare two cities side by side, estimate project costs by type and finish level, or find permitted ADUs near an address.

a day ago

Qiniu MCP Server

@Qiniu

基于七牛云产品构建的 Model Context Protocol (MCP) Server，支持用户在 AI 大模型客户端的上下文中通过该 MCP Server 来访问七牛云存储资源、利用 Dora 服务进行图片操作等。如果有什么需求欢迎在下方评论，您也可以在 github 仓库中提 issue。

Python

a year ago

Mailtrap Email Sending MCP

@Mailtrap

An MCP server that provides a tool for sending transactional emails via Mailtrap

a year ago

Google Maps

@modelcontextprotocol

Location services, directions, and place details

a year ago

mcp-server-flomo MCP Server

@chatmcp

Write notes to Flomo

JavaScript

a year ago

Upnote Lens Mcp

@elsboo

Let AI read, search, and summarize your UpNote notes — and create new ones — right from your chat.

21 hours ago

Fetch

@test

Web content fetching and conversion for efficient LLM usage

8 months ago

Tickdb Mcp — Real Time Market Data For Ai

@TickDB

TickDB MCP provides AI assistants with unified real-time and historical market data across Forex/FX, US/HK/A-share stocks (NASDAQ, NYSE), crypto, indices, and precious metals (XAU/XAG). 13 tools cover real-time quotes, ticker, order book depth, recent trades, and OHLCV candlestick (K-line) data over 37,527+ symbols. Powered by the TickDB unified market data API.

20 hours ago

Tavily Mcp

@tavily-ai

JavaScript

a year ago

MCP Server for Milvus

@zilliztech

The Milvus MCP server enables AI applications to interact with Milvus vector databases using natural language commands. It allows AI models to perform vector searches, manage collections, and retrieve data without writing custom database queries. This integration facilitates seamless access to vector data, enhancing the capabilities of AI tools like Claude Desktop and Cursor.

a year ago

Serper MCP Server

@garymengcom

A Serper MCP Server

Python

a year ago