An MCP-orchestrated research workspace for manuscript and library-wiki workflows
Project description
Medical Paper Assistant
๐ฌ An MCP-Orchestrated Research Workspace for Medical Paper Writing and LLM Wiki Workflows
3 MCP Servers ยท 165+ Tools ยท 26 Skills ยท 15 Prompts Workflows โ monorepo authoring surface plus packaged VSIX surface in one VS Code ecosystem
๐ ็น้ซไธญๆ็ ๐ค Auto-Paper: Fully Autonomous Paper Writing Guide โ 11-Phase Pipeline, 78 Quality Hooks, Structured Review Loop
๐ฆ What's in the Box
This repository is the full authoring and integration workspace behind MedPaper Assistant. It combines the core MCP runtime, the packaged VSIX extension, bundled guides, and pinned integration submodules in one place.
| Component | Type | Tools | Description |
|---|---|---|---|
| mdpaper | Core MCP Server | 115 (full) / 22 (compact default) | Dual workflow server for manuscript and library-wiki paths, plus 3 MCP prompts and 3 MCP resources |
| pubmed-search | MCP Server (submodule) | 37 | PubMed/Europe PMC/CORE search, PICO, citation metrics, session mgmt |
| CGU | MCP Server (submodule) | 13 | Creative generation: brainstorm, deep think, spark collision |
| VS Code Extension | Extension | 11 cmds + 10 chat | MCP auto-registration, compact-first packaged surface, workspace setup, LLM wiki guide, Foam graph views, @mdpaper chat participant |
| Dashboard | Next.js Web App | โ | Project management UI, diagram editor |
| Foam | VS Code Extension | โ | [[wikilink]] citation linking, hover preview, graph view |
| Skills | Agent Workflows | 26 | Guided multi-tool workflows (literature review, draft writing...) |
| Prompts | Prompt Files | 15 | /mdpaper.search, /mdpaper.draft, etc. |
External MCP Servers (optional, installed via uvx):
- drawio โ CONSORT/PRISMA flowchart generation
- zotero-keeper โ Import references from Zotero library
Counts in these tables are release-gated via tool-surface-authority.json and vscode-extension/bundle-manifest.json.
Choose Your Install Surface
| Surface | Best for | What you get |
|---|---|---|
| Full repository | Maintainers, power users, and workflow authors | Core mdpaper runtime, pinned MCP integrations/submodules, 26 skills, 15 prompt workflows, repo scripts, tests, and authoring docs |
| VSIX extension | End users who want the packaged experience | @mdpaper, 11 palette commands, compact-first mdpaper runtime (22 tools by default / 115 optional), 14 bundled skills, 13 bundled prompt workflows, 9 bundled agents, and bundled LLM wiki docs |
The repository is the broader engineering surface. The VSIX is the curated end-user surface.
VSX note: The MedPaper VS Code extension installs Python MCP tools persistently per machine via uv tool install, attempts uv tool upgrade on later activations, and skips duplicate PubMed Search / Zotero Keeper registration when another installed VS Code extension already provides those MCP servers. CI smoke now covers ubuntu-latest, windows-latest, macos-13, and macos-14, including official MCP client checks plus VSX validation smoke.
How the Pieces Fit Together
๐ฏ Why This Tool?
Traditional paper writing tools require you to know exactly what you want before you start. But research is rarely that linear.
Medical Paper Assistant is not just a writing assistant. It is a research workspace orchestrator:
- ๐ Explore First, Decide Later โ Browse literature freely, save interesting papers, then decide your research direction
- ๐ฌ Conversational Workflow โ Chat naturally with AI to refine your ideas, not fight with forms
- ๐งญ Guided Process โ Step-by-step prompts guide you from concept to publication-ready manuscript
- ๐ All-in-One โ Search, write, cite, analyze, export โ all integrated inside VS Code
| Traditional Tools | Medical Paper Assistant |
|---|---|
| Fixed templates, rigid workflow | Flexible, exploratory approach |
| Separate apps for search/write/cite | One orchestrated workspace: 165+ tools and packaged workflows in VS Code |
| Manual reference management | Auto-save with verified PubMed data |
| Export then format | Direct Word export with journal styles |
| Learn complex UI | Natural language conversation |
๐ Quick Start
Prerequisites
| Requirement | Version | Check |
|---|---|---|
| Python | 3.12+ | python3 --version |
| Git | Any recent | git --version |
| VS Code | Latest | Help โ About |
| GitHub Copilot | Extension | Extensions panel |
Install
# Clone with submodules
git clone --recursive https://github.com/u9401066/med-paper-assistant.git
cd med-paper-assistant
# Run setup script
./scripts/setup.sh # Linux/macOS
.\scripts\setup.ps1 # Windows PowerShell
The script will:
- โ
Create Python virtual environment (
.venv/) - โ Initialize pinned Git submodules from this repository
- โ
Install all dependencies (via
uv) - โ
Create
.vscode/mcp.jsonconfiguration formdpaper,pubmed-search,cgu,zotero-keeper,asset-aware, anddrawio - โ Verify MedPaper and CGU startup paths
Important installation notes:
- The setup script uses pinned submodule commits for reproducible installs. It does not auto-track the latest upstream submodule HEAD.
- If you intentionally want newer submodule code, run
git submodule update --remote --mergeyourself and test before committing. drawiousesnpx -y @drawio/mcp, so Node.js/npm must be available on the machine.zotero-keeperandpubmed-searchare launched viauvxin the repo workflow. In the VSX workflow they may be provided either by MedPaper itself or by separate installed VS Code extensions.
Verify: In Copilot Chat, type /mcp โ you should see mdpaper listed ๐
Optional Integrations
# Foam for reference linking (highly recommended)
code --install-extension foam.foam-vscode
# Draw.io for diagram generation
./scripts/setup-integrations.sh && ./scripts/start-drawio.sh
Windows PowerShell:
.\scripts\setup-integrations.ps1
.\scripts\start-drawio.ps1
๐ฌ MCP Prompts โ Just Type and Go
In Copilot Chat, type these prompts to trigger guided workflows:
| Prompt | Description |
|---|---|
/mdpaper.search |
๐ Start here! Explore literature, save papers |
/mdpaper.concept |
๐ Develop research concept with novelty validation |
/mdpaper.draft |
โ๏ธ Write manuscript with auto-citations |
/mdpaper.analysis |
๐ Analyze CSV data, generate figures & Table 1 |
/mdpaper.format |
๐ Export to Word with journal formatting |
/mdpaper.clarify |
๐ Refine specific sections through conversation |
/mdpaper.project |
๐ Create or switch research projects |
/mdpaper.strategy |
โ๏ธ Configure search strategy (dates, filters) |
/mdpaper.help |
โ Show all available commands |
Two Workflow Paths
Library Wiki Path
- Create a project with
workflow_mode="library-wiki" - Move through
search/save_reference_mcpโwrite_library_note/move_library_noteโshow_reading_queues/build_library_dashboard - Use
materialize_agent_wiki, Foam graph views, anddocs/how-to/llm-wiki.mdfor cross-note synthesis and traversal
Manuscript Path
- Create a project with
workflow_mode="manuscript" - Move through
/mdpaper.searchโ/mdpaper.conceptโ/mdpaper.draftโ/mdpaper.format - Only this path enforces concept validation, review loops, and export gates
๐ก Recommended usage: converge your literature and concepts in Library Wiki Path first, then switch to Manuscript Path for formal drafting.
Foam + Copilot Knowledge Base
MedPaper already uses Foam as the browse-and-graph layer while Copilot drives ingestion, identity resolution, knowledge-map generation, synthesis pages, block-anchor embeds, and managed graph slices.
The current Foam/Copilot layer now includes orphan / placeholder repair loops, template-driven capture into inbox/, review/, and daily/, richer foam-query dashboards, publish-safe wikilink reference packs under notes/publish/, and project-specific graph_views_json slices.
Docs and tutorials:
- Using the MedPaper LLM Wiki
- Foam Dependency Reference
- Graph-view example for ICU sedation / delirium review
๐ง Skill System + Project Memory
Our core differentiator: We don't just provide tools โ we provide guided workflows that know how to combine tools effectively, AND project memory that remembers your research journey across sessions.
What is a Skill?
Tool = Single capability (search, save, analyze...)
Skill = Complete knowledge (how to combine tools to accomplish tasks)
Representative skill families across the 26 skills:
| Category | Skills | Triggers |
|---|---|---|
| ๐ฌ Research | literature-review, concept-development, concept-validation, parallel-search |
"ๆพ่ซๆ", "search", "concept", "validate" |
| โ๏ธ Writing | draft-writing, reference-management, word-export |
"ๅฏซ่็จฟ", "draft", "citation", "export" |
| ๐ Management | project-management, memory-updater, memory-checkpoint |
"ๆฐๅฐๆก", "ๅๆ", "ๅญๆช" |
| ๐ ๏ธ Development | git-precommit, code-refactor, test-generator, code-reviewer |
"commit", "refactor", "test" |
Project Memory
Each project maintains its own .memory/ folder so the AI can continue previous research coherently. The directory layout now splits by workflow mode:
Manuscript Path
projects/{slug}/
โโโ .memory/
โ โโโ activeContext.md โ Agent's working memory
โ โโโ progress.md โ Research milestones
โโโ concept.md โ Research concept (with ๐ protected sections)
โโโ references/ โ Foam-compatible literature library
โโโ drafts/ โ Markdown drafts with [[citations]]
โโโ data/ โ CSV data files
โโโ results/ โ Figures, .docx exports
Library Wiki Path
projects/{slug}/
โโโ .memory/
โ โโโ activeContext.md โ Current library/wiki focus and triage state
โ โโโ progress.md โ ingest / organize / synthesize milestones
โโโ concept.md โ library workspace seed
โโโ references/ โ materialized reference notes
โโโ inbox/ โ raw notes and capture queue
โโโ concepts/ โ atomic concept pages and backlinks
โโโ review/ โ graph repair worklists and review notes
โโโ daily/ โ templated daily capture pages
โโโ projects/ โ synthesis pages / workstreams
โจ Key Features
Literature & References
- PubMed + Europe PMC + CORE search (37 search tools)
- PICO parsing for clinical questions
- MCP-to-MCP verified data โ PMID sent directly, no agent hallucination
- Layered trust: ๐ VERIFIED (PubMed) ยท ๐ค AGENT (AI notes) ยท โ๏ธ USER (your notes)
- Foam wikilinks:
[[author2024_12345678]]with hover preview & backlinks - Library Wiki Path โ
inbox/,concepts/, andprojects/note flow with reading queues and cross-note dashboards - LLM wiki materialization โ auto-generated
notes/index.md,notes/library/overview.md, context hubs, and draft / figure / table graph notes
Writing & Editing
- AI draft generation per section (Introduction, Methods, Results, Discussion)
- Citation-Aware Editing โ
patch_draftvalidates all[[wikilinks]]before saving - Auto-fix citation format โ
[[12345678]]โ[[author2024_12345678]] - Novelty validation โ 3-round independent scoring (threshold: 75/100)
- Anti-AI writing rules โ Evidence funnel structure, no clichรฉs
Data Analysis
- CSV dataset analysis with descriptive statistics
- Statistical tests (t-test, ANOVA, chiยฒ, correlation, Mann-Whitney, Fisher's)
- Table 1 generator โ Baseline characteristics with automatic variable detection
- Publication-ready figures (matplotlib/seaborn)
Export & Submission
- Word export with journal template support
- Cover letter + highlights generation
- Manuscript consistency checker
- Reviewer response generator (point-by-point format)
- Submission checklist (word count, figure format, etc.)
Infrastructure
- DDD Architecture (Domain-Driven Design) with clean layer separation
- 16 pre-commit hooks (ruff, mypy, bandit, pytest, prettier, doc-update...)
- Workspace State recovery for cross-session continuity
- uv for all Python package management
- MCP SDK features in active use โ tools, elicitation, and progress notifications for long-running audit/review operations
- Managed Foam graph views โ named Default, Evidence, Writing, Assets, and Review graph slices
๐๏ธ Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ค User Layer โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโ โ
โ โ VS Code โ โ Foam Extension โ โDashboard โ โ
โ โ Editor โ โ [[wikilinks]] autocomplete โ โ(Next.js) โ โ
โ โ โ โ hover preview ยท backlinks โ โ โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ค Copilot Agent (Orchestrator) โ
โ 26 Skills + 15 Prompt Workflows + Agent Customization โ
โ /mdpaper.search โ /mdpaper.concept โ /mdpaper.draft โ export โ
โโโโโโโโโฌโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโ
โ โ โ โ
โผ โผ โผ โผ
โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ
โ ๐ mdpaper โ โ๐ pubmed- โ โ๐ก cgu โ โ๐ External โ
โ 115/22 tools โ โ search โ โ 13 tools โ โ MCPs (uvx) โ
โ โ โ 37 tools โ โ โ โ โ
โ โข projects โ โ โข PubMed โ โ โข brainstorm โ โ ๐จ drawio โ
โ โข references โ โ โข Europe PMC โ โ โข deep_think โ โ โข diagrams โ
โ โข drafts โ โ โข CORE โ โ โข spark โ โ โ
โ โข validation โ โ โข PICO โ โ โข methods โ โ ๐ zotero โ
โ โข analysis โ โ โข Gene/Chem โ โ โ โ โข import refs โ
โ โข export โ โ โข Session โ โ โ โ โ
โโโโโโโโโฌโโโโโโโโ โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐พ Local Storage โ
โ projects/{slug}/ โ
โ โโโ concept.md โ Research concept with ๐ protected sections โ
โ โโโ references/{pmid}/ โ Foam-compatible .md + metadata.json โ
โ โโโ drafts/ โ Markdown drafts with [[citations]] โ
โ โโโ data/ โ CSV data files โ
โ โโโ results/ โ Figures, .docx exports โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
MCP-to-MCP Direct Communication
When saving references, data flows directly between MCP servers โ the Agent only passes a PMID, never full metadata:
Agent: "save PMID:24891204"
โ
โผ
mdpaper.save_reference_mcp(pmid="24891204")
โ Direct HTTP call (not through Agent)
โผ
pubmed-search: GET /api/cached_article/24891204
โ Returns verified PubMed data
โผ
Saved with layered trust:
๐ VERIFIED: PubMed data (immutable)
๐ค AGENT: AI notes (marked source)
โ๏ธ USER: Your notes (editable)
๐ ๏ธ mdpaper MCP Tools
115 tools (full surface) / 22 tools (compact default), plus 3 MCP prompts and 3 MCP resources for official MCP clients.
These counts are runtime-validated via tool-surface-authority.json and scripts/check_tool_surface_authority.py, and the validate/release gates fail if the docs drift from that authority.
Compact mode keeps the main facade entrypoints (project/workspace/review/pipeline/export) and hides most granular public verbs; set MEDPAPER_TOOL_SURFACE=full to expose the complete surface.
๐ Project Management
Projects, exploration mode, workspace state recovery, diagram management.
| Key Tools | Description |
|---|---|
create_project / switch_project / delete_project |
Project lifecycle |
start_exploration / convert_exploration_to_project |
Explore-first workflow |
get_workspace_state / sync_workspace_state |
Cross-session recovery |
save_diagram / list_diagrams |
Draw.io integration |
setup_project_interactive |
Interactive paper type configuration |
update_authors |
Manage structured author metadata |
๐ Reference Management
Save, search, format, and manage references with Foam integration.
| Key Tools | Description |
|---|---|
save_reference_mcp |
Recommended โ Save by PMID via MCP-to-MCP (verified data) |
list_saved_references / search_local_references |
Browse & search library |
format_references / set_citation_style |
Vancouver / APA / Nature |
sync_references |
Sync [[wikilinks]] to numbered references |
โ๏ธ Draft & Editing
Write, edit, cite โ with built-in validation.
| Key Tools | Description |
|---|---|
draft_section / write_draft |
Create and write sections |
list_drafts / read_draft / delete_draft |
Draft lifecycle |
get_available_citations |
List all valid [[citation_key]] before editing |
patch_draft |
Citation-aware partial edit with wikilink validation |
insert_citation / suggest_citations |
Smart citation insertion |
scan_draft_citations / sync_references |
Citation management |
count_words |
Section and manuscript word-count checks |
โ Validation
| Tool | Description |
|---|---|
validate_concept |
Full novelty scoring against the active concept |
validate_wikilinks |
Auto-fix [[12345678]] โ [[author2024_12345678]] |
compare_with_literature |
Compare the current idea against saved references |
๐ Data Analysis
| Tool | Description |
|---|---|
analyze_dataset |
Descriptive statistics for CSV |
run_statistical_test |
t-test, ANOVA, chiยฒ, correlation, etc. |
generate_table_one |
Baseline characteristics with auto variable detection |
create_plot |
Publication-ready figures |
insert_figure |
Insert figure into draft with archive validation |
insert_table |
Insert table into draft with archive validation |
list_assets |
List figures and tables in project results |
๐ Review & Audit
| Category | Key Tools |
|---|---|
| Pipeline Gates | validate_phase_gate, pipeline_heartbeat, validate_project_structure |
| Review Loop | start_review_round, submit_review_round, request_section_rewrite |
| Pipeline Control | pause_pipeline, resume_pipeline, approve_section |
| Audit & Hooks | run_quality_audit, run_writing_hooks, record_hook_event |
| Self-Evolution | run_meta_learning, verify_evolution, apply_pending_evolutions |
| Domain Constraints | check_domain_constraints, evolve_constraint |
| Data & Health | validate_data_artifacts, diagnose_tool_health, check_formatting |
๐ Export & Submission
| Category | Key Tools |
|---|---|
| Word Export | export_word, list_templates, start_document_session, verify_document |
| Pandoc Export | export_docx, export_pdf, preview_citations, build_bibliography |
| Submission | generate_cover_letter, generate_highlights |
๐งฉ MCP Prompts & Resources
| Capability | Names / URIs | Purpose |
|---|---|---|
| Prompts | project_bootstrap, draft_section_plan, word_export_checklist |
Materialize guided prompt workflows through the official MCP prompt API |
| Resources | medpaper://workspace/state, medpaper://workspace/projects, medpaper://templates/catalog |
Surface live workspace state, project lists, and template metadata via MCP resources |
๐ pubmed-search MCP Tools (37 tools)
| Category | Key Tools |
|---|---|
| Search | unified_search, generate_search_queries, parse_pico |
| Databases | PubMed, Europe PMC (fulltext + text mining), CORE (200M+ open access) |
| Gene/Chem | search_gene, get_gene_details, search_compound, search_clinvar |
| Exploration | find_related_articles, find_citing_articles, get_article_references |
| Export | prepare_export (RIS/BibTeX/CSV), get_citation_metrics (iCite RCR) |
| Session | get_session_pmids, list_search_history (survives AI memory limits) |
๐ก CGU Creative Tools (13 tools)
| Category | Key Tools |
|---|---|
| Ideation | generate_ideas, spark_collision, spark_collision_deep |
| Analysis | deep_think, multi_agent_brainstorm |
| Methods | list_methods, select_method, apply_method |
CGU runtime notes:
- In the repository workflow, CGU is started from the pinned submodule with
uv run --directory integrations/cgu python -m cgu.server. - In the VSX workflow, MedPaper registers CGU when bundled code or the workspace submodule is available; otherwise CGU is simply skipped.
- CGU itself supports Python
>=3.11, but this repository currently requires Python>=3.12, so cross-platform repo setup should be treated as Python 3.12 baseline on macOS, Linux, and Windows. - The default repo MCP example uses
CGU_THINKING_ENGINE=simple, which is the low-friction mode. Advanced LLM-backed modes still depend on CGU-side model/provider configuration.
๐ Foam Integration
| Feature | How to Use | Benefit |
|---|---|---|
| Wikilinks | [[greer2017_27345583]] |
Link drafts, concept pages, and synthesis notes |
| Hover Preview | Mouse over any [[link]] |
See abstract without opening file |
| Backlinks Panel | Open reference file | See which drafts or wiki notes cite this paper |
| Graph View | Ctrl+Shift+P โ MedPaper: Show Foam Graph: ... |
Jump directly to Default / Evidence / Writing / Assets / Review |
| Materialized Views | notes/index.md, notes/library/overview.md |
Review live counts, context hubs, and asset/draft graph nodes |
| Project Isolation | Auto-switches on switch_project |
Only see current project's references |
LLM Wiki Enhancements
notes/index.mdemits live Foam query counts- registered figures and tables materialize as first-class graph notes
- draft sections plus journal/author/topic/context hubs carry graph-friendly frontmatter
- the library dashboard now exposes
overview,queues,concepts,links, andsynthesiscross-note views
Citation Autocomplete
Type [[ in any draft to trigger the autocomplete menu:
According to previous studies [[ โ Type [[ here
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ greer2017_27345583 โ
โ smith2020_12345678 โ
โ chen2019_87654321 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Search by author ([[greer), year ([[2017), PMID ([[27345583), or keyword ([[sedation).
๐ Reference File Structure
References are stored with Foam-optimized, layered-trust structure:
references/{pmid}/
โโโ {citation_key}.md โ YAML frontmatter + abstract (human-readable)
โโโ metadata.json โ Full metadata (programmatic access)
---
# ๐ VERIFIED (from PubMed, immutable)
title: "Complications of airway management"
author:
- { family: Pacheco-Lopez, given: Paulette C }
year: 2014
journal: Respiratory Care
pmid: "24891204"
_source:
mcp: pubmed-search
verified: true
# ๐ค AGENT (AI-generated, marked)
_agent:
notes: "Key review on airway complications"
relevance: high
# Foam
aliases: [pachecolopez2014, "PMID:24891204"]
tags: [reference, airway, review]
---
๐ Project Structure
med-paper-assistant/
โโโ src/med_paper_assistant/ # Core MCP server (DDD architecture)
โ โโโ domain/ # Business logic, entities, value objects
โ โโโ application/ # Use cases, services
โ โโโ infrastructure/ # DAL, external services
โ โโโ interfaces/mcp/ # MCP server, 115 full / 22 compact tools + 3 prompts + 3 resources
โ
โโโ integrations/ # Bundled MCP servers
โ โโโ pubmed-search-mcp/ # PubMed/PMC/CORE search (37 tools)
โ โโโ cgu/ # Creative generation (13 tools)
โ
โโโ vscode-extension/ # Packaged VSIX surface
โ โโโ src/ # Extension source
โ โโโ bundled/tool/ # Mirrored Python runtime for marketplace installs
โ โโโ skills/ # Bundled skill definitions
โ โโโ docs/ # Bundled Foam / LLM wiki docs
โ โโโ prompts/ # Quick-action prompts
โ
โโโ dashboard/ # Next.js project management UI
โ โโโ src/
โ
โโโ projects/ # Research projects (isolated workspaces)
โ โโโ {slug}/
โ โโโ .memory/ # Cross-session AI memory
โ โโโ concept.md # Research concept or library workspace seed
โ โโโ references/ # Local reference library
โ โโโ drafts/ # Markdown drafts (manuscript path)
โ โโโ inbox/ # Raw notes (library-wiki path)
โ โโโ concepts/ # Atomic concept pages (library-wiki path)
โ โโโ projects/ # Synthesis pages / workstreams (library-wiki path)
โ โโโ results/ # Figures, exports
โ
โโโ .claude/skills/ # 26 Agent skill definitions
โโโ .github/prompts/ # 15 Prompt workflow files
โโโ templates/ # Journal Word templates
โโโ memory-bank/ # Global project memory
โโโ tests/ # pytest test suite
๐บ๏ธ Roadmap
| Status | Feature | Description |
|---|---|---|
| โ | 3 MCP Servers | mdpaper (115 full / 22 compact) + pubmed-search (37) + CGU (13) |
| โ | Foam Integration | Wikilinks, hover preview, backlinks, named graph views, project isolation |
| โ | Project Memory | .memory/ for cross-session AI context |
| โ | Table 1 Generator | Auto-generate baseline characteristics |
| โ | Novelty Validation | 3-round scoring with 75/100 threshold |
| โ | Citation-Aware Editing | patch_draft with wikilink validation |
| โ | MCP-to-MCP Trust | Verified PubMed data via direct HTTP |
| โ | Pre-commit Hooks | 16 hooks (ruff, mypy, bandit, pytest, prettier...) |
| ๐ | Richer VSX UX | TreeView, CodeLens, Diagnostics, and deeper in-editor surfaces (Direction C) |
| ๐ | Pandoc Export | Word + LaTeX dual export with CSL citations |
| ๐ | Systematic Review | PRISMA flow, Risk of Bias, meta-analysis |
| ๐ | AI Writing Intelligence | Citation intelligence, coherence engine |
| ๐ | REST API Mode | Expose tools as REST API |
Architecture Direction: Direction C โ Full VSX + Foam + Pandoc
Legend: โ Complete | ๐ In Progress | ๐ Planned
๐ค Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
- ๐ Report bugs โ Open an issue
- ๐ก Suggest features โ Share your ideas
- ๐ง Submit code โ Fork โ Branch โ PR
๏ฟฝ Citation
If you use Medical Paper Assistant in your research, please cite our paper:
@article{medpaper2025,
title = {MedPaper Assistant: A Self-Evolving, MCP-Based Framework for
AI-Assisted Medical Paper Writing with Closed-Loop Quality Assurance},
author = {[Authors]},
year = {2025},
note = {Submitted to medRxiv},
url = {https://github.com/u9401066/med-paper-assistant}
}
Note: This paper was produced entirely by the MedPaper Assistant's autonomous pipeline as a self-referential demonstration. The manuscript, audit trail, and all quality metrics are available in
projects/self-evolving-ai-paper-writing-framework/. The preprint is being submitted to medRxiv โ this section will be updated with the DOI once available.
๏ฟฝ๐ License
Apache License 2.0 โ See LICENSE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file med_paper_assistant-0.7.5.tar.gz.
File metadata
- Download URL: med_paper_assistant-0.7.5.tar.gz
- Upload date:
- Size: 43.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2a66b9ed9cc404edac292e658a6dbecda49009c9fe9ec2e633bda9fceba0b1b0
|
|
| MD5 |
eb6f887bbd1dc7f0b9bbf99b4b6c86b2
|
|
| BLAKE2b-256 |
92564d065fb0bf863099589aa549dc65b742a21a56fa53c83e37ecc7e11c6e56
|
Provenance
The following attestation bundles were made for med_paper_assistant-0.7.5.tar.gz:
Publisher:
release.yml on u9401066/med-paper-assistant
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
med_paper_assistant-0.7.5.tar.gz -
Subject digest:
2a66b9ed9cc404edac292e658a6dbecda49009c9fe9ec2e633bda9fceba0b1b0 - Sigstore transparency entry: 1361534489
- Sigstore integration time:
-
Permalink:
u9401066/med-paper-assistant@a7d933021d3879bfb3019515673eaf31cadfbce0 -
Branch / Tag:
refs/tags/v0.7.5 - Owner: https://github.com/u9401066
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a7d933021d3879bfb3019515673eaf31cadfbce0 -
Trigger Event:
push
-
Statement type:
File details
Details for the file med_paper_assistant-0.7.5-py3-none-any.whl.
File metadata
- Download URL: med_paper_assistant-0.7.5-py3-none-any.whl
- Upload date:
- Size: 518.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1f407a0e4146e6ecc3850b0e3894d93da0ec093c1e20d89677e1f8f937c22d6b
|
|
| MD5 |
da8d0754cbc7f3e324901de23ebefec0
|
|
| BLAKE2b-256 |
76dc136da0f9e4dc74dd7cfae006ee2dcc2a872a66e88e9023687951ab70e07c
|
Provenance
The following attestation bundles were made for med_paper_assistant-0.7.5-py3-none-any.whl:
Publisher:
release.yml on u9401066/med-paper-assistant
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
med_paper_assistant-0.7.5-py3-none-any.whl -
Subject digest:
1f407a0e4146e6ecc3850b0e3894d93da0ec093c1e20d89677e1f8f937c22d6b - Sigstore transparency entry: 1361534493
- Sigstore integration time:
-
Permalink:
u9401066/med-paper-assistant@a7d933021d3879bfb3019515673eaf31cadfbce0 -
Branch / Tag:
refs/tags/v0.7.5 - Owner: https://github.com/u9401066
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@a7d933021d3879bfb3019515673eaf31cadfbce0 -
Trigger Event:
push
-
Statement type: