GenomeMCP
AI-powered genomic intelligence through the Model Context Protocol
GenomeMCP is a research-grade Model Context Protocol (MCP) server that enables AI agents to query clinical genomics databases, retrieve supporting scientific literature, analyze population genetics, and visualize biological pathways — all in real-time.
🖥️ CLI Tool
GenomeMCP includes a beautiful command-line interface with rich formatting and an interactive TUI mode.
Quick Install
# Recommended (any platform with Python)
pipx install genomemcp
# macOS (Homebrew)
brew install nexisdev/tap/genomemcp
# Windows (Scoop)
scoop bucket add genomemcp https://github.com/nexisdev/scoop-genomemcp
scoop install genomemcp
# From source
git clone https://github.com/nexisdev/GenomeMCP.git
cd GenomeMCP && ./install.sh
Standalone binaries available on GitHub Releases.
CLI Commands
genomemcp search BRCA1 # 🔍 Search ClinVar
genomemcp variant 12345 # 📋 Get variant report
genomemcp gene TP53 # 🧬 Get gene info
genomemcp pathway EGFR --visualize # 🔬 Pathway analysis
genomemcp population 1-55516888-G-GA # 👥 gnomAD frequencies
genomemcp discover "Lynch Syndrome" # 🔗 Discover related genes
genomemcp tui # 🖥️ Interactive mode
Theme Options
genomemcp --theme cyberpunk search BRCA1
genomemcp --theme professional gene TP53
genomemcp --theme minimal pathway EGFR
See CLI Guide for complete documentation.
🎯 Why GenomeMCP?
| Problem | GenomeMCP Solution |
|---|---|
| AI agents lack genomic knowledge | Direct ClinVar, gnomAD, Reactome integration |
| No evidence for clinical claims | Auto-retrieves PubMed abstracts |
| Variant interpretation is complex | Population frequency + pathway context |
| Gene-disease links are opaque | Automatic relationship discovery |
🧬 Features
Core Genomics Tools
search_clinvar(term)— Query ClinVar for genes, variants, or diseasesget_variant_report(id)— Detailed clinical significance reportget_gene_info(symbol)— Gene function, location, and aliases from NCBI Geneget_supporting_literature(id)— PubMed articles linked to a variant
Population Genetics
get_population_stats(variant)— Allele frequency from gnomAD (Genome Aggregation Database)
Pathway Analysis
get_pathway_info(gene)— Reactome biological pathways for a genevisualize_pathway(gene)— Generate Mermaid.js diagrams of gene-pathway relationships
Discovery & Synthesis
find_related_genes(phenotype)— Discover genes associated with a diseaseget_genomic_context(gene, position)— Identify exon vs intron regionsget_discovery_evidence(phenotype)— Aggregate PubMed abstracts for AI reasoning
🚀 Quick Start
MCP Server Installation
# Clone the repository
git clone https://github.com/nexisdev/GenomeMCP.git
cd GenomeMCP
# Install dependencies with uv
uv sync
# Run the MCP server
uv run python src/main.py
CLI Installation
# Using the install script
./install.sh
# Or with pip
pip install genomemcp[cli]
# Or for development
./setup-dev.sh
source .venv/bin/activate
Claude Desktop Integration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"genomemcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/GenomeMCP",
"run",
"python",
"src/main.py"
]
}
}
}
### ☁️ Cloud Deployment (Railway)
You can deploy the GenomeMCP server to the cloud with one click. It will be exposed as an SSE (Server-Sent Events) endpoint, ready for remote agents.
1. Click the **Deploy on Railway** button above.
2. Provide your `SUPABASE_URL` and `SUPABASE_KEY` (optional, for persistence).
3. Connect your agent to the deployment URL (e.g. `https://your-app.up.railway.app/sse`).
---
## 📖 Usage Examples
### Search for a Gene Variant
User: "What variants are associated with BRCA1?" Agent uses: search_clinvar("BRCA1")
### Get Population Frequency
User: "How common is the variant 1-55516888-G-GA?" Agent uses: get_population_stats("1-55516888-G-GA") → Returns gnomAD allele frequency: 0.000123 (0.01%)
### Discover Gene-Disease Relationships
User: "What genes are linked to Lynch Syndrome?" Agent uses: find_related_genes("Lynch Syndrome") → Returns: MSH2 (12 variants), MLH1 (8 variants), PMS2 (5 variants)
### Visualize Pathways
User: "Show me the pathways for TP53" Agent uses: visualize_pathway("TP53") → Returns Mermaid diagram:
```mermaid
graph TD
TP53((TP53))
TP53 --> P_123["Transcriptional Regulation by TP53"]
TP53 --> P_456["Cell Cycle Checkpoints"]
TP53 --> P_789["DNA Damage Response"]
🔬 Data Sources
| Source | Description | API |
|---|---|---|
| ClinVar | Clinical variant interpretations | NCBI E-utilities |
| gnomAD | Population allele frequencies | gnomAD GraphQL |
| Reactome | Biological pathway database | Reactome Content Service |
| PubMed | Scientific literature | NCBI E-utilities |
| NCBI Gene | Gene annotations | NCBI E-utilities |
🏗️ Architecture
GenomeMCP/
├── src/
│ ├── main.py # MCP server & tool definitions
│ ├── clinvar.py # ClinVar & PubMed API client
│ ├── genomics.py # Exon/Intron mapping
│ ├── population.py # gnomAD integration
│ ├── pathways.py # Reactome integration
│ ├── utils.py # Shared utilities
│ └── cli/ # Command-line interface
│ ├── app.py # Typer CLI application
│ ├── formatters/ # Rich output formatters
│ ├── tui/ # Textual interactive UI
│ └── config.py # Theme configuration
├── tests/ # Unit tests
├── docs/ # Documentation
├── install.sh # Quick install script
├── setup-dev.sh # Development setup
└── pyproject.toml # Project configuration
🧪 Testing
# Run all tests
uv run pytest
# Run CLI tests
uv run pytest tests/test_cli.py -v
# Run specific test suite
uv run pytest tests/test_phase4.py tests/test_phase5.py
📚 Documentation
- CLI Guide — Command-line interface documentation
- Tool Reference — Complete API documentation
- Architecture Guide — System design
🤝 Contributing
Contributions are welcome! Please open an issue or submit a pull request.
📄 License
MIT License — see LICENSE for details.
🔗 Keywords
genomics bioinformatics clinvar gnomad mcp model-context-protocol ai-agent claude variant-interpretation population-genetics reactome pathway-analysis pubmed ncbi gene-discovery clinical-genomics precision-medicine llm-tools cli tui terminal
Built for AI agents. Powered by open genomic data.
Metadata
Release files for iflow-mcp_eldergenix-genomemcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_eldergenix_genomemcp-0.1.1.tar.gz | 196.7 kB | Without provenance | Details for iflow_mcp_eldergenix_genomemcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_eldergenix_genomemcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_eldergenix_genomemcp-0.1.1-py3-none-any.whl |
Total release size: 251.1 kB
Release files / iflow_mcp_eldergenix_genomemcp-0.1.1.tar.gz
| Download URL | iflow_mcp_eldergenix_genomemcp-0.1.1.tar.gz |
|---|---|
| Size | 196.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7481d61727c3d260cf1e155bd451698d848e7e1cf389a47bb6f491e2a1a954cd
|
|
BLAKE2b-256 checksum How to use checksums |
6946dad62cb6ef736c60c555ba04a5d4a7e54847525177d1d606fc67ed8acc75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_eldergenix_genomemcp-0.1.1-py3-none-any.whl
| Download URL | iflow_mcp_eldergenix_genomemcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 54.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b2a706e379fa769c7410381441363d57be12412b010af78f8a2f1d3060285db6
|
|
BLAKE2b-256 checksum How to use checksums |
931877fbb7fffd32342595b6debc731b1d581e083cc3a1085e821d134b7c9c5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.2 {"installer":{"name":"uv","version":"0.10.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_eldergenix-genomemcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.