Analisa arquivos de DNA brutos localmente para fornecer relatórios sobre haplogrupos, características, dados de saúde ClinVar e farmacogenômica.
Também conhecido como codebase/gnomancer
- Stars
- 5
- Ferramentas
- —
- Downloads, 30 dias
- 1.013
- Versão mais recente
- 0.5.2
- Último commit
- 10 de nov. de 2026
- Licença
- MIT
O que é o MCP gnomancer?
gnomancer é um MCP server. Analisa arquivos de DNA brutos localmente para fornecer relatórios sobre haplogrupos, características, dados de saúde ClinVar e farmacogenômica.
Resumo gerado a partir do README do projeto
Sobre o MCP server de gnomancer
O gnomancer permite analisar localmente arquivos de DNA brutos de serviços como AncestryDNA, 23andMe ou MyHeritage. Ele transforma dados de genótipo brutos em relatórios legíveis que abrangem haplogrupos, características físicas e informações de saúde, sem nunca fazer o upload dos seus arquivos genéticos para a nuvem. O processamento ocorre inteiramente na sua própria máquina, garantindo a privacidade dos seus dados sensíveis.
Desenvolvedores podem conectar este MCP server a clientes de IA como Claude Desktop, Cursor ou LM Studio usando o comando uvx. Uma vez conectado, um assistente de IA pode consultar os resultados do relatório ou buscar genótipos específicos em locais individuais. O servidor fornece ferramentas especializadas para varreduras de saúde ClinVar e farmacogenômica PharmCAT, que só são buscadas quando solicitadas. Essa configuração permite que você use modelos locais para manter todos os insights genéticos no seu hardware ou use assistentes na nuvem para gerar resumos narrativos a partir de seus resultados estruturados.
O que você pode fazer com ele
- 1Consultar características genéticas específicasPeça ao seu assistente de IA para explicar o que o seu relatório de DNA diz sobre sua capacidade de processar cafeína.
- 2Analisar relacionamentos familiaresForneça múltiplos arquivos de DNA para determinar segmentos compartilhados e prováveis relações biológicas entre membros da família.
- 3Monitorar atualizações de dados de saúdeVerifique automaticamente novas classificações do ClinVar para ver se variantes identificadas anteriormente foram reclassificadas.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP gnomancer
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP gnomancer no Claude Code
$ claude mcp add gnomancer -- uvx gnomancerInstalar o MCP gnomancer no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Instalar o MCP gnomancer no VS Code
.vscode/mcp.json
{
"servers": {
"gnomancer": {
"type": "stdio",
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Instalar o MCP gnomancer no VS Code CLI
$ code --add-mcp '{"name":"gnomancer","type":"stdio","command":"uvx","args":["gnomancer"]}'Instalar o MCP gnomancer no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Instalar o MCP gnomancer no Codex
$ codex mcp add gnomancer -- uvx gnomancerInstalar o MCP gnomancer no Codex config.toml
~/.codex/config.toml
[mcp_servers.gnomancer] command = "uvx" args = ["gnomancer"]
Instalar o MCP gnomancer no Gemini CLI
$ gemini mcp add -s user gnomancer uvx -- gnomancerInstalar o MCP gnomancer no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Verificações automatizadas
Executado em 13 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelcodebase/gnomancer is public and reachablegithub.com/codebase/gnomancer ↗Passou
- O pacote indica este repositório como sua origemgnomancer names codebase/gnomancer as sourcepypi.org/project/gnomancer/ ↗Passou
- Proveniência da build (atestação Sigstore)Sigstore attestation for gnomancerpypi.org/project/gnomancer/ ↗Passou
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-10github.com/codebase/gnomancer ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from gnomancerPassou
- Nenhum aviso crítico no pacote ou em suas dependências46 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no GitHubTake the raw file you already downloaded from AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA or LivingDNA (or a VCF) and turn it into one readable report. Everything runs on your computer. Nothing is uploaded.
Quick start
pipx install gnomancer # Python 3.10+; Java 17+ for the mtDNA haplogroup and PharmCAT steps
gnomancer ~/Downloads/AncestryDNA.zip # first run fetches the open-source tools and references once (~250 MB)
Open AncestryDNA_analysis/REPORT.html. No Python? curl -fsSL https://gnomancer.com/install.sh | bash sets everything up (macOS and Linux; Windows via WSL).

What you get
- Plain language first. An at-a-glance digest, then a narrative your own AI assistant can write from a prompt the run gives you.
- Lineages. Y haplogroup (yhaplo, plus Yleaf on current YFull/FTDNA/ISOGG trees) and mtDNA haplogroup (Haplogrep3), each with population context.
- Traits and ancestry markers. About 110 well-replicated sites: pigmentation, lactose, caffeine, bitter taste, blood group and more.
- Health, carefully. Carrier sites, common risk variants, a ClinVar scan of every typed site with plausibility scoring, and PharmCAT pharmacogenomics. All collapsed by default so nobody sees a result they didn't ask for.
- Family mode.
gnomancer family dad.zip mom.zip me.zipshows shared DNA and the likely relationship for each pair, which lines you share, and which parent each of your alleles came from. - Stays current.
gnomancer watchre-checks ClinVar each month and tells you only what was reclassified at sites you carry. - Honest limits. Every section says what the chip can and cannot tell you.
Use it from your AI assistant
gnomancer is also an MCP server. Connect it and ask "what does my report say about caffeine?"
claude mcp add gnomancer -- uvx gnomancer serve # Claude Code
Any MCP client works the same way: the command is uvx with arguments gnomancer serve. For Claude Desktop, Cursor and LM Studio (for a local model), add it to the client's mcpServers JSON:
{"mcpServers": {"gnomancer": {"command": "uvx", "args": ["gnomancer", "serve"]}}}
For Codex, add it to ~/.codex/config.toml:
[mcp_servers.gnomancer]
command = "uvx"
args = ["gnomancer", "serve"]
Tested with Claude Code and with a generic MCP client; reports from other clients are welcome.
The assistant never gets the raw file. It gets the report's results, and can look up the genotype at a single site when a question needs it; the health tables are separate tools fetched only on request. The repo also works as a Claude plugin (skills/gnomancer/SKILL.md).
Privacy
Your genotype file never leaves your machine. The only network traffic is the one-time download of public tools and references. The optional --ai flag sends the structured results (not the file) to the Anthropic API to write the narrative, and only when you ask. If you connect an AI assistant through the MCP server, it sees what it asks for: the report's results, and the genotype at any single site it looks up. With a cloud assistant those go to its provider; with a local model they stay on your machine.
Not medical advice
A genotyping array reads about 0.02% of the genome at pre-chosen sites, and its calls at rare sites are wrong often enough that a clinical lab found 40% did not confirm. gnomancer tells you what the chip says and how far to trust it. Confirm anything that matters with a clinical-grade test and a clinician or genetic counselor.
More
Discord community · CLI options · vendors and quirks · the marker panel · tools under the hood · development · MCP registry · contributing
MIT licensed. The tools it downloads keep their own licenses; see NOTICE.md for credits.
mcp-name: com.gnomancer/gnomancer
Perguntas sobre o MCP gnomancer
Como adiciono o MCP gnomancer ao Claude Code?
Execute claude mcp add gnomancer -- uvx gnomancer no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP gnomancer ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Meus dados de DNA são enviados para a nuvem?
Não, tudo é executado localmente no seu computador e seu arquivo de genótipo nunca sai da sua máquina.
Quais serviços de DNA são suportados?
Ele suporta arquivos brutos da AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA, LivingDNA ou arquivos VCF.