monarch-mcp

nickzren/monarch-mcp

3.1

If you are the rightful owner of monarch-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Monarch MCP Server is a Model Context Protocol server that provides access to the Monarch Initiative API, offering a suite of tools for biomedical research and analysis.

Monarch MCP Server

A Model Context Protocol (MCP) server that exposes the Monarch Initiative API as a set of tools.

Features

Core Capabilities

  • Entity Search: Query genes, diseases, phenotypes across 33 integrated biomedical resources
  • Phenotype Matching: Find similar diseases using semantic similarity algorithms
  • Cross-Species Analysis: Explore gene-phenotype-disease relationships across human and model organisms
  • Association Discovery: Navigate connections between genes, diseases, phenotypes, chemicals, and variants
  • Clinical Diagnostics: Support rare disease diagnosis through phenotype profile matching
  • Ontology Mapping: Translate between different biomedical nomenclatures (OMIM, MONDO, HP, etc.)
  • Chemical/Drug Data: Access drug-disease relationships and treatment information

Data Sources

The Monarch Knowledge Graph integrates 33 biomedical resources:

  • Clinical/Genetics: OMIM, Orphanet, ClinVar, HGNC, HPO (Human Phenotype Ontology)
  • Model Organisms: Alliance of Genome Resources (MGI, ZFIN, WormBase, FlyBase, Xenbase, RGD), dictyBase, PomBase, SGD
  • Ontologies: MONDO (diseases), Gene Ontology, Uberon (anatomy), CHEBI (chemicals), PHENIO (cross-species phenotypes)
  • Pathways & Interactions: Reactome, STRING, BioGRID
  • Expression: Bgee (gene expression across species)
  • Proteins: UniProt
  • Literature: PubMed annotations
  • Reference: Ensembl, NCBI Gene

Prerequisites

  • Python 3.12+ with pip

Quick Start

1. Install UV

UV is a fast Python package and project manager.

pip install uv

2. Install MCPM (MCP Manager)

MCPM is a package manager for MCP servers that simplifies installation and configuration.

pip install mcpm

3. Setup the MCP Server

cd monarch-mcp
uv sync

4. Add the Server to Claude Desktop

# Make sure you're in the project directory
cd monarch-mcp

# Set Claude as the target client
mcpm target set @claude-desktop

# Add the Monarch MCP server
mcpm import stdio monarch \
  --command "$(uv run which python)" \
  --args "-m monarch_mcp.server"

Then restart Claude Desktop.

Usage

Running the Server
uv run python -m monarch_mcp.server
AI Agent Example
# Create .env file with your OpenAI API key
echo "OPENAI_API_KEY=your_key_here" > .env

# Run the example agent
uv run python examples/react_agent.py
Development
# Run tests
uv run pytest tests/ -v