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

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

-
security - not tested
F
license - not found
-
quality - not tested

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/Zaroganos/oakvar-mcp'

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