gnomancer — Claude Code MCP server: what it does, how to install
gnomancer — an MCP server for Claude Code parses raw DNA files locally on your machine and answers questions through your AI assistant.
MIT ★ 5 updated 2026-11-10
claude mcp add gnomancer -- uvx gnomancerWhat gnomancer does
The server processes raw genetic data from major testing providers or VCF files into a readable HTML report entirely on your computer. Running it requires Python 3.10+, while mtDNA haplogroup and PharmCAT steps need Java 17+. The first run fetches open-source references and tools once, taking about 250 megabytes.
The assistant accesses report results and queries genotypes at single sites when requested, keeping raw files on disk. Family mode compares multiple files to show shared DNA and line inheritance, and a watch command tracks monthly ClinVar updates. The repository can also be used as a Claude plugin.
What it helps with
- parse raw DNA into a readable report
- determine Y and mtDNA haplogroups locally
- compare relative genomes in family mode
- scan ClinVar variants from raw data
- query genetic reports through an AI assistant
Example prompts for the agent
- What does my report say about caffeine?
- Look up the genotype for this marker in my data
- Compare dad.zip and mom.zip in family mode
How to install gnomancer
Platform CLI
claude mcp add gnomancer -- uvx gnomanceruvx runs the command named after the package; if the README names another one, use uvx --from gnomancer <command>
Platform CLI
codex mcp add gnomancer -- uvx gnomanceruvx runs the command named after the package; if the README names another one, use uvx --from gnomancer <command>
Config file
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from gnomancer <command>
Config file
{
"servers": {
"gnomancer": {
"type": "stdio",
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from gnomancer <command>
Platform CLI
gemini mcp add gnomancer uvx gnomanceruvx runs the command named after the package; if the README names another one, use uvx --from gnomancer <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gnomancer
How to install gnomancer in Claude Code?
Run claude mcp add gnomancer -- uvx gnomancer in your terminal.
What does gnomancer do?
It processes local raw DNA files into lineage and health reports, serving as an MCP backend for AI assistants.
What do I need to run gnomancer?
You need Python 3.10+, Java 17+ for specific lineage tools, and a raw genetic data file from a supported vendor.