q1-crafter-mcp
MCP ServerFree<p align="center"> <img src="https://img.shields.io/badge/MCP-Server-blueviolet?style=for-the-badge&logo=anthropic" alt="MCP Server" /> <img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python" /> <img src="https://img.shields.io/b
Capabilities6 decomposed
multi-source academic search
Medium confidenceThis capability enables querying across 18 academic databases simultaneously, utilizing a smart field-based routing mechanism that directs queries to the most relevant sources based on the subject area. It employs a modular architecture where each database has its own API client, allowing for efficient parallel processing and aggregation of results. The system is designed to handle various data formats and ensures a seamless user experience by abstracting the complexity of multiple API interactions.
Utilizes a smart routing mechanism to direct queries to the most relevant academic databases based on subject area, enhancing search efficiency.
More comprehensive than single-source tools like Google Scholar due to simultaneous querying of multiple databases.
intelligent deduplication
Medium confidenceThis capability implements a two-phase deduplication process that first checks for exact matches using DOI and then applies a fuzzy matching algorithm based on title similarity with a 92% Levenshtein threshold. This ensures that duplicate entries are effectively filtered out, providing cleaner and more relevant search results. The architecture leverages Pydantic models for data validation and consistency throughout the deduplication process.
Combines exact DOI matching with fuzzy title matching to ensure high accuracy in deduplication, which is often not available in simpler tools.
More robust than basic deduplication tools that rely solely on exact matches, reducing the risk of overlooking duplicates.
literature analysis and gap detection
Medium confidenceThis capability analyzes the retrieved literature to identify research gaps, extract keywords using TF-IDF, and validate citations. It employs natural language processing techniques to assess the content of papers and generate insights about trends and themes. The architecture is designed to allow easy integration of various analysis tools, making it flexible for future enhancements.
Utilizes TF-IDF for keyword extraction and combines it with gap analysis to provide comprehensive insights into the literature landscape.
Offers deeper analytical capabilities compared to basic keyword extractors by also identifying research gaps.
visualization of publication trends
Medium confidenceThis capability generates visual representations of publication trends, source distribution, and citation networks using libraries like Mermaid for diagram generation. It processes the analyzed data to create charts and graphs that help researchers visualize complex relationships and trends in their literature. The design allows for easy customization of visual outputs to meet specific user needs.
Integrates with Mermaid for dynamic diagram generation, allowing for flexible and interactive visualizations of complex data.
More versatile than static charting libraries, enabling real-time updates and interactivity in visual outputs.
apa 7 citation formatting
Medium confidenceThis capability formats citations and references according to APA 7th edition standards, handling complex rules for different author counts and DOI formatting. It uses a set of predefined templates and rules encoded in Pydantic models to ensure compliance with citation standards. The architecture allows for easy updates to citation rules as standards evolve.
Handles complex citation rules for varying author counts and ensures compliance with APA 7 standards, which is often a challenge for other tools.
More comprehensive than generic citation tools that may not handle specific formatting nuances required by academic standards.
docx manuscript generation
Medium confidenceThis capability assembles all components of a research manuscript, including title pages, sections, and references, into a formatted .docx file. It leverages the Python-docx library to create structured documents that adhere to academic standards. The architecture is modular, allowing for easy updates and customization of document templates based on user preferences.
Utilizes Python-docx to create fully structured and formatted manuscripts, which is often not available in simpler document generation tools.
More comprehensive than basic document generators that lack the ability to format according to specific academic standards.
Capabilities are decomposed by AI analysis. Each maps to specific user intents and improves with match feedback.
Related Artifactssharing capabilities
Artifacts that share capabilities with q1-crafter-mcp, ranked by overlap. Discovered automatically through the match graph.
Sourcely
Academic Citation Finding Tool with AI
Elicit
AI agent for automated systematic literature reviews.
local-deep-research
Local Deep Research achieves ~95% on SimpleQA benchmark (tested with Qwen 3.6). Supports local and cloud LLMs (Ollama, Google, Anthropic, ...). Searches 10+ sources - arXiv, PubMed, web, and your private documents. Everything Local & Encrypted.
scholarmcp
MCP server: scholarmcp
paper-search-mcp-openai-v2
Find and download academic papers from leading sources like arXiv, PubMed, bioRxiv, medRxiv, Google Scholar, Semantic Scholar, CrossRef, and IACR. Get standardized results and fetch full-text PDFs when available. Accelerate literature reviews with deep search and effortless retrieval.
Turf Network
Get real-time market data across global equities and crypto to accelerate investment research. Search academic literature and scan the live web for up-to-date sources and citations. Tap curated learning resources and niche datasets, including DevOps/web-dev guides, SAT prep, and updates on the SLC P
Best For
- ✓researchers needing comprehensive literature reviews
- ✓scholars compiling literature reviews
- ✓research teams conducting systematic reviews
- ✓data scientists and researchers needing visual insights
- ✓students and researchers preparing manuscripts
- ✓academics preparing submissions to journals
Known Limitations
- ⚠Dependent on the availability of external APIs; if an API is down, results may be incomplete.
- ⚠Fuzzy matching may occasionally miss duplicates with minor title variations.
- ⚠Analysis quality depends on the quality of the input data; poor quality papers may skew results.
- ⚠Visualizations may require additional formatting for publication-ready quality.
- ⚠Limited to APA 7; does not support other citation styles without modification.
- ⚠Formatting may require manual adjustments for specific journal requirements.
Requirements
Input / Output
UnfragileRank
UnfragileRank is computed from adoption signals, documentation quality, ecosystem connectivity, match graph feedback, and freshness. No artifact can pay for a higher rank.
Repository Details
About
<p align="center"> <img src="https://img.shields.io/badge/MCP-Server-blueviolet?style=for-the-badge&logo=anthropic" alt="MCP Server" /> <img src="https://img.shields.io/badge/Python-3.10+-3776AB?style=for-the-badge&logo=python&logoColor=white" alt="Python" /> <img src="https://img.shields.io/badge/APA_7-Compliant-success?style=for-the-badge" alt="APA 7" /> <img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License" /> </p> <h1 align="center">🎓 Q1 Crafter MCP</h1> <p align="center"> <strong>Academic Research MCP Server for Claude Desktop</strong><br/> Automates the full research cycle — from source discovery across 18 databases<br/> to Q1-quality, APA 7-formatted <code>.docx</code> output. </p> <p align="center"> <a href="#-features">Features</a> • <a href="#-quick-start">Quick Start</a> • <a href="#%EF%B8%8F-claude-desktop-setup">Claude Desktop</a> • <a href="#-available-tools">Tools</a> • <a href="#-supported-sources">Sources</a> • <a href="#-contributing">Contributing</a> </p> --- ## ✨ 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 ```bash pip install q1-crafter-mcp ``` ### Configuration ```bash # 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 ```bash q1-crafter-mcp ``` --- ## 🖥️ Claude Desktop Setup Add to your Claude Desktop configuration file: <details> <summary><strong>📋 Windows</strong> — <code>%APPDATA%\Claude\claude_desktop_config.json</code></summary> ```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" } } } } ``` </details> <details> <summary><strong>📋 macOS</strong> — <code>~/Library/Application Support/Claude/claude_desktop_config.json</code></summary> ```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" } } } } ``` </details> > **💡 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 <table> <tr> <th>🆓 Free (No Key)</th> <th>🔑 Free (Key Required)</th> <th>🏛️ Institutional</th> <th>🇹🇷 Turkish</th> </tr> <tr> <td> - arXiv - CrossRef - OpenAlex - Europe PMC - DOAJ - BASE </td> <td> - Semantic Scholar - PubMed (NCBI) - CORE - Unpaywall </td> <td> - Scopus (Elsevier) - Web of Science - IEEE Xplore - Springer Nature - ScienceDirect - Dimensions </td> <td> - TR Dizin - DergiPark (OAI-PMH) - YÖK Tez Merkezi </td> </tr> </table> --- ## 🏗 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 ```mermaid 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. **Search** — Queries up to 18 databases in parallel, routes by field (medicine → PubMed, CS → Semantic Scholar) 2. **Deduplicate** — Removes duplicates via exact DOI + fuzzy title matching (92% threshold) 3. **Analyze** — Identifies themes, gaps, trends, and extracts keywords 4. **Visualize** — Generates charts, tables, and citation networks 5. **Format** — Applies APA 7th edition rules for citations and references 6. **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: 1. Search across available databases 2. Deduplicate and rank results 3. Analyze themes and identify gaps 4. Generate formatted citations 5. Write a structured section with proper references --- ## 🔑 API Key Setup | Source | How to Get Key | Cost | |--------|---------------|------| | Semantic Scholar | [semanticscholar.org/product/api](https://www.semanticscholar.org/product/api) | Free | | PubMed (NCBI) | [ncbi.nlm.nih.gov/account](https://www.ncbi.nlm.nih.gov/account/) | Free | | CORE | [core.ac.uk/services/api](https://core.ac.uk/services/api) | Free | | Scopus | [dev.elsevier.com](https://dev.elsevier.com/) | Institutional | | IEEE Xplore | [developer.ieee.org](https://developer.ieee.org/) | Paid | | Springer | [dev.springernature.com](https://dev.springernature.com/) | Free tier | | Dimensions | [dimensions.ai](https://www.dimensions.ai/scientometric-research/) | Free for research | --- ## 🧪 Development ```bash # 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](https://github.com/ZaEyAsa) --- <p align="center"> <strong>Built with ❤️ for researchers who deserve better tools.</strong><br/> <sub>If this helps your research, give it a ⭐ on GitHub!</sub> </p>
Categories
Alternatives to q1-crafter-mcp
Search the Supabase docs for up-to-date guidance and troubleshoot errors quickly. Manage organizations, projects, databases, and Edge Functions, including migrations, SQL, logs, advisors, keys, and type generation, in one flow. Create and manage development branches to iterate safely, confirm costs
Compare →AI-optimized web search and content extraction via Tavily MCP.
Compare →Scrape websites and extract structured data via Firecrawl MCP.
Compare →Are you the builder of q1-crafter-mcp?
Claim this artifact to get a verified badge, access match analytics, see which intents users search for, and manage your listing.
Get the weekly brief
New tools, rising stars, and what's actually worth your time. No spam.
Data Sources
Looking for something else?
Search →