Skip to main content
Glama

EVEE MCP 서버

EVEE (Evo Variant Effect Explorer) API를 위한 MCP 서버 — Evo 2 유전체 파운데이션 모델 임베딩을 기반으로 한 해석 가능한 변이 효과 예측을 제공합니다.

EVEE는 420만 개의 ClinVar 변이에 대해 사전 계산된 병원성 예측, 파괴 프로필 및 AI가 생성한 기계론적 해석을 제공합니다. 전체 논문은 Pearce et al. (2026)을 참조하십시오.

도구

도구

설명

search_variants

유전자 기호, rsID 또는 ClinVar 변이 ID에 대한 자동 완성 스타일 조회(최대 6개 일치 항목); 후보 변이 ID를 찾는 데 유용하며, 유전자 전체 순위를 매기는 용도는 아님

get_variant

임상 요약, EVEE 파생 효과 출력, 데이터베이스 비교 점수(존재 시), AI 생성 기계론적 해석(저장되지 않은 경우 요청 시 자동 생성 트리거)

wait_for_variant_analysis

EVEE의 요청 시 해석 생성이 완료되거나 시간 초과될 때까지 폴링

compare_variants

나란히 비교 요약(한 번의 호출로 최대 10개 변이) — 임상 라벨, 병원성, 상위 1개 파괴, HGVS, 딥 링크

get_variant_disruptions

규모별로 순위가 매겨진 상위 생물학적 주석 파괴(선택적으로 카테고리별 범위 지정 가능) — 변이가 병원성 또는 양성으로 예측되는 이유를 설명

get_variant_annotations

전체 주석 프로브 값(13개 카테고리에 걸친 325개 주석, 선택적으로 카테고리별 필터링 가능)

주석 카테고리

amino_acid, atacseq, ccre, chipseq, chromhmm, elm, fstack, protein_feature, interpro, genomic_feature, ptm, region, secondary_structure

Related MCP server: gnomAD MCP Server

기술

Claude Code 기술은 .claude/skills/evee/SKILL.md에 있습니다. 이를 로드하는 에이전트는 도구를 효과적으로 사용하는 방법(워크플로우 단계, 변이 클래스별 신뢰성 주의 사항, 주의점(0 기반 좌표, indel VCF 앵커링, 대소문자 구분 등))에 대한 약 120줄의 지침을 받습니다.

사용법

Python 3.10+ 및 uv가 필요합니다.

git clone git@github.com:goodfire-ai/evee-mcp.git
cd evee-mcp
uv sync

Claude Code

저장소는 .mcp.json을 제공합니다. 디렉토리를 열면 권한 프롬프트가 트리거됩니다:

claude

Claude Desktop

claude_desktop_config.json에 추가하십시오:

{
  "mcpServers": {
    "evee": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/evee-mcp", "python3", "server.py"]
    }
  }
}

예시

FBN1 변이 rs1597537935는 병원성이 있나요? 있다면 그 이유는 무엇인가요?

에이전트가 검색을 수행하고, AI가 생성한 기계론적 해석이 포함된 임상 요약을 가져오며, 상위 파괴 증거를 추출합니다.

Available Tools

6 tools
compare_variantsA

Compare multiple variants side-by-side.

Fetches clinical label, pathogenicity score, gene, HGVS protein, consequence, and the top-1 disruption for each. Use when the user asks to contrast, rank, or compare 2+ variants, instead of looping get_variant.

Args: variant_ids: List of variant IDs in chr:pos:ref:alt format (max 10).

Inputs: variant_ids (required).

get_variantA

Get comprehensive information about a specific genetic variant.

Returns clinical significance, model-derived scores from EVEE's heads (aligned to AlphaMissense, CADD, REVEL, SIFT, etc.), reference predictor scores from external databases when present, gene constraint (LOEUF), HGVS notation, disease associations, protein domains, and the AI-generated mechanistic interpretation.

If the stored interpretation isn't ready, this tool hits EVEE's on-demand /analysis endpoint once: if generation has already completed, the fresh interpretation is returned inline; otherwise the response carries an interpretation = {status: queued/processing, detail: ...} entry and you should call wait_for_variant_analysis to poll until it finishes.

Args: variant_id: Variant identifier in chr:pos:ref:alt format (e.g. "chr17:43092918:G:A" for BRCA1 ClinVar ID 41812). NOTE: EVEE uses 0-based positions; ClinVar/VCF/HGVS are 1-based. Subtract 1 from ClinVar pos for SNVs; for indels the offset varies — prefer search_variants.

Inputs: variant_id (required).

get_variant_annotationsA

Get detailed annotation probe values for a variant.

Returns the Evo 2 model's predicted annotation values for both the reference and alternate allele across 325 biological annotations. Each annotation shows ref (reference allele prediction), alt (alternate allele prediction), and delta (alt - ref).

Use this for deep analysis when you need the full picture — e.g., all chromatin marks across tissues, all amino acid probabilities, or every protein feature prediction. For a quick ranked view of what's most disrupted, use get_variant_disruptions instead.

Args: variant_id: Variant identifier in chr:pos:ref:alt format. category: Optional filter. One of: amino_acid, atacseq, ccre, chipseq, chromhmm, elm, fstack, protein_feature, interpro, genomic_feature, ptm, region, secondary_structure. Omit to get ALL annotations.

Inputs: variant_id (required), category.

get_variant_disruptionsA

Get the top biological annotation disruptions for a variant.

Shows which molecular features are most affected by the variant, ranked by magnitude of change. Each disruption shows what the Evo 2 model predicts for the reference vs. alternate allele across 325 biological annotations spanning protein structure, chromatin state, regulatory elements, splice sites, and more.

This is the key tool for understanding WHY a variant is predicted pathogenic or benign — e.g., a splice-site variant might show large disruptions in splice donor/acceptor annotations, while a missense variant might show disruptions in protein domain and secondary structure annotations.

Categories: amino_acid, atacseq, ccre, chipseq, chromhmm, elm, fstack, protein_feature, interpro, genomic_feature, ptm, region, secondary_structure.

Args: variant_id: Variant identifier in chr:pos:ref:alt format. top_n: Number of top disruptions to return (default 15, max 100). category: Optional category filter — restrict ranking to one category (e.g. to see only splice-related disruptions: category='genomic_feature').

Inputs: variant_id (required), top_n, category.

search_variantsA

Autocomplete-style variant lookup (up to 6 matches) in the EVEE database.

The query must be ONE of these exact types — do NOT combine them or add extra words like "pathogenic":

  • A gene name: "BRCA1", "TP53", "FBN1"

  • An rsID: "rs1597537935"

  • A ClinVar variation ID (numeric): "655979"

Returns at most 6 autocomplete-style matches. Pagination/limit params are ignored by the backend.

WARNING: a gene-name query returns an adjacent-position autocomplete slice of variants in that gene — NOT the top-pathogenicity variants of the gene. Do not infer the gene's pathogenic landscape from these 6 rows. To look up a specific variant, query by rsID or ClinVar variation ID.

Use this as the starting point to find variant IDs for the other tools.

Inputs: query (required). Returns: result

wait_for_variant_analysisA

Poll EVEE's on-demand interpretation until it completes or times out.

Use this when get_variant reports interpretation.status as queued or processing. Returns the same curated variant summary as get_variant, plus a wait_status entry with attempts / elapsed_seconds. If the deadline hits before completion, call this tool again to keep polling.

Args: variant_id: Variant identifier in chr:pos:ref:alt format. timeout_seconds: Maximum wall-clock time to wait (clamped to [1, 60]). poll_interval_seconds: Delay between polls (clamped to [0.5, 10]).

Inputs: variant_id (required), timeout_seconds, poll_interval_seconds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: search_variants for lookup, get_variant for comprehensive info, compare_variants for side-by-side comparison, get_variant_annotations for deep probes, get_variant_disruptions for top disruptions, and wait_for_variant_analysis for polling. No overlapping functionality.

    Naming Consistency5/5

    All tool names follow the verb_noun pattern in snake_case consistently (e.g., compare_variants, get_variant_annotations). The naming is predictable and easy to understand.

    Tool Count5/5

    With 6 tools, the server covers the core workflows of variant lookup, detailed retrieval, comparison, annotation analysis, disruption ranking, and async waiting. This is well-scoped for a specialized domain without being too few or too many.

    Completeness4/5

    The tool set covers essential operations: search, retrieve, compare, deep annotations, disruptions, and async polling. A minor gap is the lack of a tool to list all variants for a given gene (search_variants only returns up to 6 autocomplete results), but for targeted variant analysis, the surface is sufficiently complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI-powered genomic variant analysis including variant impact prediction, regulatory element discovery, and batch variant scoring. Currently operates in mock mode as a proof-of-concept awaiting the public release of Google DeepMind's AlphaGenome API.
      24
      40 npm
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides a programmatic interface to the Genome Aggregation Database (gnomAD) API across versions v2.1.1, v3.1.2, and v4.1.0. It enables users to query gene metadata, variant information, population frequencies, and ClinVar data through a unified schema.
      12
      7
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Look up variant allele frequencies by ancestry, gene loss-of-function constraint, gene variant lists, and sequencing coverage over gnomAD — with ClinVar significance joined in — via MCP.
      253 npm
      1
      Apache 2.0