로컬에서 원시 DNA 파일을 분석하여 하플로그룹, 형질, ClinVar 건강 데이터 및 약물 유전체학 보고서를 제공합니다.
다른 이름 codebase/gnomancer
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- 1,013
- 최신 버전
- 0.5.2
- 마지막 커밋
- 2026년 11월 10일
- 라이선스
- MIT
gnomancer MCP란?
gnomancer은(는) MCP server입니다. 로컬에서 원시 DNA 파일을 분석하여 하플로그룹, 형질, ClinVar 건강 데이터 및 약물 유전체학 보고서를 제공합니다.
프로젝트 README에서 생성된 요약
gnomancer MCP server 정보
gnomancer를 사용하면 AncestryDNA, 23andMe, MyHeritage와 같은 서비스의 원시 DNA 파일을 로컬에서 분석할 수 있습니다. 유전 파일을 클라우드에 업로드하지 않고도 원시 유전형 데이터를 하플로그룹, 신체적 형질, 건강 정보 등을 포함한 읽기 쉬운 보고서로 변환합니다. 모든 프로세싱은 사용자 기기에서 완전히 이루어지므로 민감한 데이터의 프라이버시를 보장합니다.
개발자는 uvx 명령어를 사용하여 이 MCP server를 Claude Desktop, Cursor 또는 LM Studio와 같은 AI 클라이언트와 연결할 수 있습니다. 연결되면 AI 어시스턴트가 보고서 결과를 조회하거나 개별 사이트의 특정 유전형을 검색할 수 있습니다. 이 서버는 ClinVar 건강 스캔 및 PharmCAT 약물 유전체학을 위한 특화된 도구를 제공하며, 이는 요청 시에만 가져옵니다. 이 설정을 통해 로컬 모델을 사용하여 모든 유전적 통찰력을 하드웨어에 유지하거나, 클라우드 어시스턴트를 사용하여 구조화된 결과로부터 서술형 요약을 생성할 수 있습니다.
활용 사례
- 1특정 유전 형질 조회AI 어시스턴트에게 DNA 보고서에 나타난 카페인 대사 능력에 대해 설명해 달라고 요청합니다.
- 2가족 관계 분석여러 개의 DNA 파일을 제공하여 가족 구성원 간의 공유 세그먼트와 예상되는 생물학적 관계를 확인합니다.
- 3건강 데이터 업데이트 모니터링새로운 ClinVar 분류를 자동으로 확인하여 이전에 식별된 변이가 재분류되었는지 점검합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
gnomancer MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 gnomancer MCP 설치
$ claude mcp add gnomancer -- uvx gnomancerCursor에 gnomancer MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}VS Code에 gnomancer MCP 설치
.vscode/mcp.json
{
"servers": {
"gnomancer": {
"type": "stdio",
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}VS Code CLI에 gnomancer MCP 설치
$ code --add-mcp '{"name":"gnomancer","type":"stdio","command":"uvx","args":["gnomancer"]}'Claude Desktop에 gnomancer MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}Codex에 gnomancer MCP 설치
$ codex mcp add gnomancer -- uvx gnomancerCodex config.toml에 gnomancer MCP 설치
~/.codex/config.toml
[mcp_servers.gnomancer] command = "uvx" args = ["gnomancer"]
Gemini CLI에 gnomancer MCP 설치
$ gemini mcp add -s user gnomancer uvx -- gnomancerGemini settings.json에 gnomancer MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"gnomancer": {
"command": "uvx",
"args": [
"gnomancer"
]
}
}
}자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능codebase/gnomancer is public and reachablegithub.com/codebase/gnomancer ↗통과
- 패키지가 이 저장소를 소스로 명시gnomancer names codebase/gnomancer as sourcepypi.org/project/gnomancer/ ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for gnomancerpypi.org/project/gnomancer/ ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-10github.com/codebase/gnomancer ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from gnomancer통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음46 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Take 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
gnomancer MCP 질문
gnomancer MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add gnomancer -- uvx gnomancer를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
gnomancer MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
DNA 데이터가 클라우드에 업로드되나요?
아니요, 모든 작업은 컴퓨터 로컬에서 실행되며 유전형 파일은 기기를 절대 벗어나지 않습니다.
어떤 DNA 서비스를 지원하나요?
AncestryDNA, 23andMe, MyHeritage, FamilyTreeDNA, LivingDNA의 원시 파일 또는 VCF 파일을 지원합니다.