MCP 服务器

Folklore Variant Evidence

Resolve one supported GRCh38 germline variant and return structured, source-backed ACMG/AMP evidence with provenance and explicit limitations. The public server is read-only and intended for professional review.

README

Folklore

Folklore is a public, read-only MCP server from Helena Bioinformatics. Its current Variant Evidence capability resolves one supported GRCh38 germline variant and returns structured evidence for ACMG/AMP classification.

The service accepts genomic, coding, and protein HGVS expressions. It normalizes the query to GRCh38 and returns the resolved variant, gene and consequence, automated classification, applied evidence codes, ClinVar assertions, population frequency, in-silico and splice predictions, source versions, provenance, limitations, and a link to the public Folklore Variant Details record.

Connect

Endpoint: https://api.helena.bio/folklore/v1/mcp
Transport: Streamable HTTP
Authentication: None
Tool: search_variant_evidence

Example client configuration:

{
  "mcpServers": {
    "folklore": {
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

Registry build

The Dockerfile in this repository is a small distribution bridge used by registries that build and inspect MCP servers from source. It runs a pinned version of mcp-proxy and connects its standard-input transport to the public Folklore Streamable HTTP endpoint.

The bridge contains no Folklore backend implementation, private data, secrets, or patient information. Clients that support Streamable HTTP should use the public endpoint above directly.

Query

Send one supported germline variant. For example:

ENST00000226413.5:c.317A>G

The same variant may be submitted as a supported genomic or protein HGVS expression.

Response

The tool returns structured, source-backed data suitable for machine use and a rendered Variant Details view for compatible chat clients. Results may include:

input resolution status and warnings;
GRCh38 genomic, coding, and protein HGVS;
gene, transcript, consequence, exon, and identifiers;
automated ACMG/AMP classification and evidence codes;
ClinVar significance, review status, and associated conditions;
gnomAD population frequency;
in-silico, splice, conservation, and gene-constraint evidence;
classifier and source-data versions;
provenance, limitations, and a public Folklore record URL.

Scope and safety

Folklore provides computational decision support, not a diagnosis. Results must be reviewed by a qualified genetics professional in the relevant clinical context.

The public service accepts one variant query at a time. It does not accept patient records, expose private Helena Bioinformatics systems, or publish backend source code or implementation details.