genomoncology/biomcp
BioMCP: Biomedical Model Context Protocol
570 ★111 forksRustUpdated 22h ago
What you need to know
BioMCP is a single CLI binary plus MCP server over one command grammar that reaches ~30 trusted biomedical sources (PubMed, ClinVar, ClinicalTrials.gov, OncoKB, Reactome, etc.), giving researchers, clinicians, and agents one query interface for search, detail, pivots, gene-set enrichment, and local study analytics.
Install
curl -fsSL https://biomcp.org/install.sh | bash uv tool install biomcp-cli (or pip install biomcp-cli) brew tap genomoncology/biomcp && brew install biomcp Docker: docker run --rm ghcr.io/genomoncology/biomcp serve
Usage
- •Register the stdio MCP server: {"mcpServers": {"biomcp": {"command": "biomcp", "args": ["serve"]}}}
- •Claude Code plugin: /plugin marketplace add genomoncology/biomcp then /plugin install biomcp@biomcp; install skills with `biomcp skill install ~/.claude --force`
- •Codex: codex mcp add biomcp -- biomcp serve; remote HTTP: biomcp serve-http --host 127.0.0.1 --port 8080 (clients connect to /mcp)
- •Core grammar: biomcp search all --gene BRAF --disease melanoma, biomcp get gene BRAF pathways hpa, biomcp variant articles "BRAF V600E", biomcp enrich BRAF,KRAS,NRAS
Key features
- ✓Unified command grammar over ~30 sources: search/get/helpers/enrich/batch with sections and progressive disclosure per entity (gene, variant, article, trial, diagnostic, drug, disease, pathway, protein, adverse-event, pgx)
- ✓Literature search fans out across PubTator3 and Europe PMC with PMID/PMCID/DOI dedup and optional Semantic Scholar leg
- ✓Cross-entity pivots (variant→trials, gene→pathways, drug→adverse-events) and article paper-trail (citations/references/recommendations/entities)
- ✓Local study analytics on downloaded cBioPortal-style datasets: study query/cohort/survival/compare/co-occurrence with terminal, SVG, and PNG charts
- ✓g:Profiler gene-set enrichment and batch (up to 10 focused get calls); JSON responses expose _meta.next_commands and section provenance
Best for
Biomedical researchers and clinicians who want one command grammar to query and pivot across major public biomedical databases from a CLI or an AI agent.
Caveats
- ⚠PyPI warning: install biomcp-cli, NOT biomcp (the biomcp PyPI package is unrelated)
- ⚠Most commands work without credentials; optional keys (NCBI_API_KEY, S2_API_KEY, OPENFDA_API_KEY, NCI_API_KEY, ONCOKB_TOKEN, ALPHAGENOME_API_KEY) improve rate limits or unlock sections
- ⚠KEGG distinguishes academic and non-academic use; COSMIC is kept indirect-only due to licensing incompatibility
- ⚠Article references/recommendations can be empty for paywalled papers (publisher elision in Semantic Scholar coverage)
- ⚠Rate limiting is process-local - use one shared serve-http endpoint for many concurrent workers
Platforms: macOS · Linux · Windows · DockerClients: Claude Code · Codex · Claude Desktop
Documentation ↗Reviewed 2026-08-07
Topics
aibioinformaticsclinical-trialsgenomicsllmmcpmcp-servermedicalmodel-context-protocolpubmedpubmed-central
- Stars
- 570★
- Forks
- 111
- Language
- Rust
- License
- MIT
- Created
- 2025-04-01
- Last push
- 2026-08-06