Distributes the oakvar-mcp package for installation via pip, enabling integration of OakVar genomic variant analysis capabilities.
Provides tools for querying and filtering OakVar SQLite result databases, executing SQL queries, and extracting genomic variant data from analysis results.
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
š 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
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
Configuration
Claude Desktop
Add to claude_desktop_config.json:
ChatGPT Desktop
Add to chatgpt_mcp_config.json:
š Config file locations and troubleshooting: See SETUP.md
Available Tools (19)
Tool | Description |
| Get OakVar version |
| Verify installation |
| Configure OakVar |
| Get/set modules directory |
| List modules |
| Get module details |
| Install modules |
| Remove modules |
| Update modules |
| Run annotation pipeline |
| Generate reports |
| Get database info |
| Filter databases |
| Execute SQL queries |
| Create module templates |
| Create test inputs |
| Pack for distribution |
| Refresh store cache |
| Register modules |
Development
Project Structure
License
MIT License