Skip to main content
Glama

OakVar MCP Server

A Model Context Protocol (MCP) server that exposes OakVar's genomic variant analysis capabilities to AI assistants.

Supported MCP Clients: Claude Desktop, ChatGPT Desktop, and other MCP-compatible clients.

Quick Start

# 1. Install OakVar and the MCP server
pip install oakvar oakvar-mcp

# 2. Setup OakVar (first time only)
ov system setup

# 3. Configure your MCP client (see SETUP.md)

šŸ“– Full setup instructions: See SETUP.md

Related MCP server: GTEx MCP Server

What is This?

This MCP server lets you control OakVar through AI assistants like Claude or ChatGPT. Instead of running command-line tools, you can simply ask:

  • "What OakVar modules are installed?"

  • "Install the ClinVar annotator"

  • "Run OakVar on my VCF file with gnomAD annotation"

  • "Show me pathogenic variants from the results"

Features

Category

Capabilities

Pipeline

Run annotations, generate reports (VCF, Excel, CSV)

Modules

Install, update, list, search 200+ annotator modules

Data

Query result databases, filter variants, export data

Development

Create module templates, pack for distribution

Architecture

ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”     MCP Protocol     ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
│   Claude /      │◄────────────────────►│  OakVar MCP      │
│   ChatGPT       │    (stdin/stdout)    │     Server       │
ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜                      ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜
                                                  │
                                                  │ Python API
                                                  ā–¼
                                         ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
                                         │     OakVar       │
                                         │ Variant Analysis │
                                         ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜

Installation

Note: OakVar and this MCP server must be installed in the same Python environment. If you use a virtual environment, configure your MCP client to use the full path to that environment's oakvar-mcp executable.

From Source

git clone https://github.com/zaroganos/oakvar-mcp.git
cd oakvar-mcp
pip install -e .

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "oakvar": {
      "command": "oakvar-mcp"
    }
  }
}

ChatGPT Desktop

Add to chatgpt_mcp_config.json:

{
  "mcpServers": {
    "oakvar": {
      "command": "oakvar-mcp"
    }
  }
}

šŸ“– Config file locations and troubleshooting: See SETUP.md

Available Tools (19)

Tool

Description

oakvar_version

Get OakVar version

oakvar_system_check

Verify installation

oakvar_system_setup

Configure OakVar

oakvar_modules_dir

Get/set modules directory

oakvar_module_list

List modules

oakvar_module_info

Get module details

oakvar_module_install

Install modules

oakvar_module_uninstall

Remove modules

oakvar_module_update

Update modules

oakvar_run

Run annotation pipeline

oakvar_report

Generate reports

oakvar_sqliteinfo

Get database info

oakvar_filtersqlite

Filter databases

oakvar_query

Execute SQL queries

oakvar_new_module

Create module templates

oakvar_new_exampleinput

Create test inputs

oakvar_module_pack

Pack for distribution

oakvar_store_fetch

Refresh store cache

oakvar_store_register

Register modules

Development

# Clone and install in dev mode
git clone https://github.com/zaroganos/oakvar-mcp.git
cd oakvar-mcp
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

Project Structure

oakvar-mcp/
ā”œā”€ā”€ oakvar_mcp/
│   ā”œā”€ā”€ __init__.py
│   ā”œā”€ā”€ __main__.py
│   └── server.py
ā”œā”€ā”€ tests/
│   └── test_server.py
ā”œā”€ā”€ pyproject.toml
ā”œā”€ā”€ README.md
ā”œā”€ā”€ SETUP.md
ā”œā”€ā”€ claude_desktop_config.example.json
└── chatgpt_mcp_config.example.json

License

MIT License

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to query genetic variant data, gene constraints, and population genetics information from the gnomAD (Genome Aggregation Database) through its GraphQL API. Supports searching for genes and variants, retrieving constraint scores, analyzing population frequencies, and accessing genomic coverage data.
    9
    10
  • A
    license
    B
    quality
    D
    maintenance
    Enables AI-powered genomic variant analysis including variant impact prediction, regulatory element discovery, and batch variant scoring. Currently operates in mock mode as a proof-of-concept awaiting the public release of Google DeepMind's AlphaGenome API.
    20
    14
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • MyVariant.info MCP.

  • MCP gateway federating 21 biomedical MCP servers behind one endpoint: gnomAD, ClinVar, HPO, VEP.

  • Canine genomics for agents: breed allele frequencies, AI pathogenicity + OMIA clinical disease layer

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/miliyarsh/oakvar-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server