Analiza archivos de ADN sin procesar de forma local para generar informes sobre haplogrupos, rasgos, datos de salud de ClinVar y farmacogenómica.
También conocido como codebase/gnomancer
- Stars
- 5
- Herramientas
- —
- Descargas, 30 días
- 1013
- Última versión
- 0.5.2
- Último commit
- 10 nov 2026
- Licencia
- MIT
¿Qué es gnomancer MCP?
gnomancer es un MCP server. Analiza archivos de ADN sin procesar de forma local para generar informes sobre haplogrupos, rasgos, datos de salud de ClinVar y farmacogenómica.
Resumen generado a partir del README del proyecto
Acerca del MCP server de gnomancer
gnomancer permite analizar localmente archivos de ADN sin procesar de servicios como AncestryDNA, 23andMe o MyHeritage. Transforma los datos de genotipo brutos en informes legibles que cubren haplogrupos, rasgos físicos e información de salud sin subir nunca tus archivos genéticos a la nube. El procesamiento ocurre íntegramente en tu propia máquina, garantizando la privacidad de tus datos sensibles.
Los desarrolladores pueden conectar este MCP server a clientes de IA como Claude Desktop, Cursor o LM Studio usando el comando uvx. Una vez conectado, un asistente de IA puede consultar los resultados de los informes o buscar genotipos específicos en sitios individuales. El servidor proporciona herramientas especializadas para escaneos de salud ClinVar y farmacogenómica PharmCAT, que solo se consultan cuando se solicitan. Esta configuración te permite usar modelos locales para mantener todos los conocimientos genéticos en tu hardware o usar asistentes en la nube para generar resúmenes narrativos a partir de tus resultados estructurados.
Qué puedes hacer con él
- 1Consultar rasgos genéticos específicosPide a tu asistente de IA que te explique qué dice tu informe de ADN sobre tu capacidad para procesar la cafeína.
- 2Analizar relaciones familiaresProporciona múltiples archivos de ADN para determinar segmentos compartidos y posibles relaciones biológicas entre miembros de la familia.
- 3Monitorear actualizaciones de datos de saludComprueba automáticamente si hay nuevas clasificaciones de ClinVar para ver si alguna variante identificada previamente ha sido reclasificada.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar gnomancer MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar gnomancer MCP en Claude Code
$ claude mcp add gnomancer -- uvx gnomancerInstalar gnomancer MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Instalar gnomancer MCP en VS Code
.vscode/mcp.json
{
"servers": {
"gnomancer": {
"type": "stdio",
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Instalar gnomancer MCP en VS Code CLI
$ code --add-mcp '{"name":"gnomancer","type":"stdio","command":"uvx","args":["gnomancer"]}'Instalar gnomancer MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Instalar gnomancer MCP en Codex
$ codex mcp add gnomancer -- uvx gnomancerInstalar gnomancer MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.gnomancer] command = "uvx" args = ["gnomancer"]
Instalar gnomancer MCP en Gemini CLI
$ gemini mcp add -s user gnomancer uvx -- gnomancerInstalar gnomancer MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblecodebase/gnomancer is public and reachablegithub.com/codebase/gnomancer ↗Aprobado
- El paquete indica este repositorio como su origengnomancer names codebase/gnomancer as sourcepypi.org/project/gnomancer/ ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for gnomancerpypi.org/project/gnomancer/ ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-10github.com/codebase/gnomancer ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from gnomancerAprobado
- No hay avisos críticos en el paquete ni en sus dependencias46 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre gnomancer MCP
¿Cómo agrego gnomancer MCP a Claude Code?
Ejecuta claude mcp add gnomancer -- uvx gnomancer en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego gnomancer MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Se suben mis datos de ADN a la nube?
No, todo se ejecuta localmente en tu ordenador y tu archivo de genotipo nunca sale de tu máquina.
¿Qué servicios de ADN son compatibles?
Es compatible con archivos sin procesar de AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA, LivingDNA o archivos VCF.