ScholarFlow MCP
Enables ingestion of Scopus export files into the systematic literature review pipeline, supporting deduplication and reconciliation of search/flow counts for PRISMA and SPAR-4-SLR reporting.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ScholarFlow MCP
Unified Academic Research & Reproducible Systematic Literature Review (SLR) MCP Server + Agent Skill Bundle
Bahasa Indonesia? Read README.id.md.
ScholarFlow MCP bridges the gap between prompt-driven AI research assistants and journal-ready, audit-grade academic reproducibility. Built with the official Python MCP SDK (FastMCP) and bundled with a portable Agent Skill (skills/scholarflow/SKILL.md), it gives AI agents (Antigravity, Claude Desktop/Code, Cursor) 14 deterministic tools that keep your physical PDFs, screening logs, closed-taxonomy coding matrices, blinded human inter-rater reliability worksheets, BibTeX/RIS files, 300 DPI figures, and Word/Markdown manuscripts 100% synchronized.
Why ScholarFlow MCP?
Most AI academic assistants stop at literature search, abstract screening, or free-form prose drafting—leaving researchers vulnerable to count drift, corrupt PDFs, broken Excel dropdowns, leaked coder labels, malformed RIS author lines, and uncited references.
ScholarFlow solves this by enforcing 7 deterministic reproducibility stages alongside standard academic workflows:
Capability | Typical AI Research Skill | ScholarFlow MCP + Skill |
Protocol & Flow Accounting | Narrative PRISMA summary | Exact 5-pathway SPAR-4-SLR (Assembling → Arranging → Assessing) & PRISMA 2020 arithmetic invariants |
Physical PDF Corpus Ops | Text/metadata only | Non-destructive routing ( |
Full-Text Acquisition | Basic API fetch | Hybrid legal OpenAlex OA + |
Closed-Taxonomy Coding | Unstructured notes | ADO–TCM extraction matrix with closed codebooks & Excel-safe cell-range DataValidation (prevents Excel's 255-char corruption bug) + 1-to-1 Markdown reading notes |
Human Inter-Rater Reliability | AI-only dual screening | 100%-blinded standalone Excel export (zero Coder 1 leakage) with cluster-stratified shared overlap + automated % Agreement, Cohen's Kappa ($\kappa$), & PABAK |
Manuscript & Figure Sync | Manual copy-paste | Single Source of Truth: generates 300 DPI PNG charts + synchronized |
Pre-Submission Gate | Qualitative checklist | 4-Way Deterministic Integrity Audit (20+ automated cross-checks across PDFs ↔ Search Log ↔ Matrix/Notes ↔ Manuscript/Bib/RIS/Protocol) |
Related MCP server: reviewfast-mcp
Architecture
flowchart LR
Agent["AI Agent\n(Antigravity / Claude / Cursor)"]
Skill["Agent Skill\nskills/scholarflow/SKILL.md"]
Server["FastMCP Server\nscholarflow-mcp"]
Agent --> Skill --> Server
subgraph Pipeline["8 Modular Reproducible Stages (14 Tools)"]
S0["0. Scaffold\n(EN / ID Presets)"]
S1["1. Multi-DB Dedup\n& 5-Pathway Flow"]
S2["2. Legal OA Fetch\n& Clickable Queue"]
S3["3. Physical Routing\n& 1-to-1 Notes"]
S4["4. Closed-Taxonomy\nADO-TCM Matrix"]
S5["5. Blinded Coder 2\n& Kappa / PABAK"]
S6["6. Verified BibTeX\n& Clean RIS"]
S7["7. 300 DPI Figures\n& DOCX/MD Sync"]
S8["8. 4-Way Integrity\nAudit (20+ Checks)"]
end
Server --> S0 --> S1 --> S2 --> S3 --> S4 --> S5 --> S6 --> S7 --> S8Quick Installation
Option 1: Run Directly via uvx (Recommended — Zero Manual Clone)
uvx --from git+https://github.com/AkmalRamadhan04/scholarflow-mcp scholarflow-mcpOption 2: Install from Source with uv
git clone https://github.com/AkmalRamadhan04/scholarflow-mcp.git
cd scholarflow-mcp
uv sync --extra dev
uv run scholarflow-mcpClient Configuration (MCP + Agent Skill)
Google Antigravity (mcp_config.json)
{
"mcpServers": {
"scholarflow": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/AkmalRamadhan04/scholarflow-mcp",
"scholarflow-mcp"
]
}
}
}To also enable the methodology skill in Antigravity, copy skills/scholarflow/ into ~/.gemini/config/skills/scholarflow/.
Claude Desktop / Claude Code / Cursor
Add the exact same scholarflow server block to:
Claude Desktop:
claude_desktop_config.jsonClaude Code:
claude mcp add scholarflow -- uvx --from git+https://github.com/AkmalRamadhan04/scholarflow-mcp scholarflow-mcpCursor:
.cursor/mcp.json
Complete Tool, Resource & Prompt Reference
14 Deterministic MCP Tools
Stage | Tool Name | Purpose |
0 |
| Scaffold reproducible workspace ( |
1 |
| Parse Scopus, OpenAlex, Crossref, SciELO, GS/PoP CSV, |
1 |
| Enforce exact 5-pathway SPAR-4-SLR / PRISMA 2020 flow arithmetic equations |
2 |
| Legal OA PDF retriever (OpenAlex + |
2 |
| Generate prioritized |
3 |
| Non-destructively route files ( |
4 |
| Configure closed taxonomy ( |
5 |
| Export a 100%-blinded human co-coder workbook (zero Coder 1 leakage) with cluster-stratified shared overlap |
5 |
| Compute |
6 |
| Optional live Crossref/OpenAlex DOI verification + clean |
7 |
| Build 3 publication-ready 300 DPI PNG figures directly from |
7 |
| Single-Source-of-Truth builder compiling synchronized |
8 |
| Execute 20+ deterministic 4-way checks across PDFs, Search Log, Extraction Matrix/Notes, Manuscript, Bib/RIS & Protocol |
8 |
| Instant dashboard of pipeline counts, pending items, last audit status, and next recommended tool |
3 MCP Resources & 3 Guided Prompts
Resources:
scholarflow://guide/spar4slr,scholarflow://guide/integrity-contract,scholarflow://templates/reading-notePrompts:
start_systematic_review,run_screening_and_extraction_cycle,pre_submission_integrity_gate
Development & Verification
# Lint with Ruff
uv run ruff check src tests
# Run full unit & end-to-end 8-stage synthetic pipeline tests
uv run pytest -v
# Build wheel & source distribution
uv buildAll tests run on a 100% synthetic demo dataset (examples/synthetic_demo/) — zero private or unpublished manuscript data is included in this repository.
Documentation
Author & License
Created by Akmal Ramadhan (@AkmalRamadhan04).
Released under the MIT License.
@software{ramadhan2026scholarflow,
author = {Ramadhan, Akmal},
title = {ScholarFlow MCP: Unified Academic Research and Reproducible SLR MCP Server},
year = {2026},
url = {https://github.com/AkmalRamadhan04/scholarflow-mcp},
version = {0.1.0}
}Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Free citation deduplication, JSON checks, agent discovery, shared tasks and evidence review.
Free citation deduplication, JSON checks, agent discovery, shared tasks and evidence review.
Machine-native research commons for agent evidence, discovery, rooms, and bounded research quests.
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
Related MCP Servers
- FlicenseBqualityBmaintenanceEnables deterministic, harness-neutral research workflows by unifying research object identity, evidence receipts, claim-evidence graphs, and append-only decision logs, along with specialized scholarly skills for literature analysis, reproducibility audits, and multi-agent review.181-
- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to run systematic review screening steps such as creating projects, importing records, scoring and ranking them with a zero-shot LLM classifier, presenting records for human decisions, applying a statistical stopping criterion, and exporting results. Human reviewers retain responsibility for inclusion decisions, with probabilities hidden unless requested.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to run reproducible, high-recall literature search across seven source families with RRF fusion, fetch open-access full texts (falling back to abstracts), expand citations, export BibTeX/RIS, and audit reference coverage — all without any LLM API key, leaving query planning and writing to the agent. Multiple agent clients share one accumulating literature pool and background search jobs that keep running after sessions close.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to conduct literature reviews by screening multiple academic databases, performing backward and forward citation snowballing, and resolving or downloading full-text PDFs through subscription and open-access sources.MIT