Folklore Clinical Variant Interpretation MCP

io.github.helena-bioinformatics由 GitHub 账号 helena-bioinformatics 发布v2.0.0更新于 Nov 6, 2026

Germline ACMG/AMP classification, genes, disease associations, literature and API-key case analysis.

发布方自己的服务:[PREPROD] Clinical.ly Research Suite

已验证Streamable HTTP可网页运行知识与记忆数据与分析AI 与机器学习

概览

AI 生成的概览

面向临床基因组的托管 MCP 服务器:ACMG/AMP 胚系变异分类、基因与疾病关联以及文献检索。

可以做什么
  • 解析并按 ACMG/AMP 对单个 GRCh38 胚系 SNV 或小型 indel 分类,返回判定标准、ClinVar 声明与人群频率
  • 检索变异相关文献、获取 PMID 记录,并按问题、PMID、DOI、基因、表型、HPO 或 OMIM 检索遗传学文献库
  • 解析人类基因符号与标识符,并按固定快照分段读取基因档案
  • 按基因符号、HGNC、MONDO 或疾病名称查询 ClinGen 基因-疾病有效性
  • 为已解析基因获取独立的实时文献抓取结果
  • 使用 API 密钥运行病例分析流程并读取结果清单
适用场景
适合在科研或变异复核中需要解读胚系变异、核对 ClinGen 基因-疾病有效性或查找遗传学文献与出版记录的场合。公开科学工具可匿名使用,病例流程需要账户密钥。
运行要求
远程 Streamable HTTP 端点,无需本地服务器。公开工具可匿名调用;病例、来源与结果工具需要在 Authorization Bearer 头中提供 Folklore API 密钥,密钥在 Folklore 账户中创建。处理受该账户的订阅限额与额度约束。共用出口的客户端共享同一速率预算。
安装前请注意
API 密钥属于凭据,应存放在客户端密钥库中,不要写入提示词、工具参数或 URL。密钥本身不提供已付费算力;病例分析会消耗订阅限额与额度,应设置明确的费用上限。提交病例与下载结果会在账户上写入和读取数据。变异查询与标识符会发送到托管服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Folklore Clinical Variant Interpretation MCP,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.helena-bioinformatics%2Ffolklore/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "folklore-clinical-variant-interpretation": {
      "type": "http",
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

README

Folklore Clinical Variant Interpretation MCP

One hosted MCP server for public scientific queries and authenticated case workflows.

Endpoint: https://api.helena.bio/folklore/v1/mcp

Version 2.0.0

[License] [DOI] [OpenSSF Scorecard] [AllMCPs Verified]

Connect your MCP client directly to this Streamable HTTP endpoint. No local Folklore server is required. Anonymous callers receive 11 public tools. Send your Folklore API key in the Authorization Bearer header to access 18 additional case, source and result tools at the same endpoint. Invalid supplied credentials fail authentication; they do not select the anonymous catalog.

Create a key in your Folklore account for the selected account and sources. Keep it in your client's secret store, never in prompts, tool arguments or URLs. The selected account's native subscription capabilities, usage limits and eligible credits govern processing. A key does not grant funded compute.

See case workflows, the 18 authenticated tool schemas and the public task recipes.

Classify a variant

Connect your MCP client to:

text
https://api.helena.bio/folklore/v1/mcp

Access is anonymous. Call classify_germline_variant:

json
{"name":"classify_germline_variant","arguments":{"assembly":"GRCh38","query":"NM_007294.4:c.68_69del"}}

Input: one public GRCh38 nuclear germline SNV or simple indel smaller than 50 bp. Accepted notation includes supported HGVS, SPDI, rsID and genomic coordinates. Preserve transcript versions and reference alleles.

A resolved identity with successful interpretation includes automated ACMG/AMP classification, reported criteria, annotations, source evidence and provenance. Submitted ClinVar assertions retain their own source attribution alongside the Folklore classification. A VUS is a classification outcome.

StatusNext step
resolvedRead interpretation status, then classification and evidence.
ambiguousPresent candidates for an explicit allele choice.
not_foundReport the source-scoped miss.
invalid_requestSupply a corrected supported expression.
unsupportedSelect a workflow for the requested variant type or assembly.
resolution_unavailableInspect the typed error and retry policy.

Interpretation status is success or unavailable. Transport, JSON-RPC, MCP and adapter errors have separate fields. See typed outcomes.

Scientific tools

ToolOperation
classify_germline_variantResolve, classify and assess one supported germline variant.
search_variant_literatureRetrieve publications linked to a resolved variant.
get_publication_detailsRetrieve the bibliographic record and abstract for a PMID.
search_literature_corpusSearch publications by scientific question or public identifier.
get_gene_disease_associationsRetrieve ClinGen assertions for an exact gene symbol or HGNC identifier.
search_disease_genesRetrieve ClinGen assertions by MONDO identifier or disease-name substring.
resolve_geneResolve a human gene symbol, alias or stable identifier.
get_gene_profileRead the selected HGNC gene at its returned snapshot.
get_gene_sectionContinue one profile section using its cursor.
search_gene_literatureRetrieve a separate live publication capture for the selected gene.

ClinGen results preserve assertion-level disease identity, inheritance, validity assessment, panel, date and source links. Profile sections retain provider, assembly, release, units and pagination. Gene literature has its own capture identity. Follow gene-disease and gene-profile contracts for exact inputs.

support_helena provides links to the separate Helena Good service when the user asks about supporting Helena. An optional MCP App renders variant results.

Connect an agent or application

The hosted server uses stateless Streamable HTTP and MCP 2026-07-28. Requests carry matching protocol metadata and routing headers. Supported methods include server/discover, tools/list, tools/call, prompts/list, prompts/get, resources/list and resources/read.

The compatibility guide records protocol/client observations. All clients sharing egress use the same rate budget.

Agent Skill and workflow prompts

Install the portable Agent Skill using the installation guide. It routes pathogenicity, VUS, ClinVar, population-frequency, gene-disease and literature tasks to the hosted tools. The skill source includes OpenAI interface metadata.

Workflow prompts compose tool operations for classification, VUS assessment, ACMG/AMP explanation, identity verification and variant-literature comparison. Each accepts one public variant expression.

Run the adapter

The Apache-2.0 adapter implements MCP transport, public API clients and validated response projection. Folklore's scientific authorities produce normalization, annotation, evidence aggregation and classification.

bash
python3.12 -m venv .venv. .venv/bin/activatepip install -e '.[dev]'FOLKLORE_MCP_ENABLED=true \FOLKLORE_LITERATURE_ENABLED=true \FOLKLORE_GENE_DISEASE_ENABLED=true \FOLKLORE_PUBLIC_GENE_ENABLED=true \folklore-mcp

Capabilities are enabled through the flags above. Gene literature requires both public-gene and literature capabilities. The default upstream is https://api.helena.bio; local contract tests support localhost and 127.0.0.1. The standalone HTTP image uses Dockerfile.adapter; Dockerfile provides the pinned stdio bridge.

Verify and measure

bash
pytestruff check .ruff format --check .python3 ops/reconcile_discovery.py

The read-only reconciler compares runtime, Server Card and Official Registry state, with separate aggregator observations. python3 ops/public_smoke.py checks discovery, prompts and resources.

Public measurement sources: variant interpretation, 100-case agent discovery, 60-query search discovery and genomic discovery cohort.

Registry and citation

The immutable MCP adapter 1.6.0 archive is 10.5281/zenodo.23817704, from signed tag folklore-mcp-v1.6.0 at 55a332c6dd6bd4650e921c12ac145b8e0f90476a. The Biorouter-tag archive is 10.5281/zenodo.23818207.

License

Apache License 2.0. See LICENSE and NOTICE.

Automated variant classifications support qualified professional review and are not patient diagnoses or treatment recommendations.

来源:README.md,提交 d5cdae4

工具

11

classify_germline_variant

Classify or interpret a germline variant under ACMG/AMP

Classify one GRCh38 germline nuclear SNV or simple indel smaller than 50 bp under ACMG/AMP. Accepts genomic, coding or protein HGVS, coordinates, SPDI, rsID or a returned canonical key. Returns normalized identity, automated classification, applied criteria, ClinVar assertions, population frequencies, annotations and source provenance when available. Ambiguous input returns candidates for selection.

输入参数query必填assembly

search_variant_literature

Find literature for a germline variant

Resolve one GRCh38 germline variant and retrieve publications from the PubMed-derived genetics corpus. Exact variant mentions rank ahead of broader gene associations. Returns match types, source links, corpus provenance and retrieval time.

输入参数limitquery必填assemblyquestion

get_publication_details

Get details for a PubMed publication

Retrieve one PMID from the PubMed-derived genetics corpus, including title, abstract, authors, journal, publication types, MeSH terms, gene and variant mentions, retraction status and PubMed/PMC links.

输入参数pmid必填

search_literature_corpus

Search the Folklore Literature Corpus

Search the genetics Literature Corpus by question, PMID, DOI, PMCID, gene, variant, phenotype, HPO or OMIM concept. Known publication identifiers provide exact anchors. Returns ranked publications, match types, scores and source links.

输入参数sortlimitquery必填cursor

support_helena

Support Helena's free scientific infrastructure

Retrieve Helena Good campaign, rules, manifest and MCP connection URLs.

无需输入参数。

get_gene_disease_associations

Find diseases associated with a gene

Find diseases associated with an exact gene symbol or HGNC identifier. Returns ClinGen gene-disease validity assertions, relation-specific inheritance, source reports and snapshot provenance, including conflicting and limited assertions.

输入参数gene必填limitoffset

search_disease_genes

Find genes associated with a disease

Find genes associated with an exact MONDO identifier or disease-name search. Returns ClinGen validity assertions with inheritance, source reports and snapshot provenance. Name searches can return multiple disease identities.

输入参数limitoffsetdisease必填

resolve_gene

Resolve a gene symbol, alias or stable identifier

Resolve a human gene symbol, previous symbol, alias, HGNC, Ensembl or NCBI Gene identifier. Returns exact, alias, ambiguous, not_found or withdrawn status with candidates and identity_snapshot_id. Use a selected HGNC gene_id and snapshot_id with get_gene_profile. Gene-plus-HGVS and variant expressions use classify_germline_variant.

输入参数query必填

get_gene_profile

Read the complete gene profile

Read the selected gene_id and immutable snapshot_id from resolve_gene. Returns overview, disease validity, dosage, mechanisms, transcripts, native assemblies, constraint, ClinVar summaries and consequences, expression, GWAS, phenotypes and protein/pathways with source assertions, coverage, count units and null values. get_gene_section supplies further pages. Live search_gene_literature is separate from the snapshot literature section.

输入参数gene_id必填snapshot_id必填

get_gene_section

Read a page of gene records

Read a gene-profile section using gene_id, snapshot_id and its returned opaque cursor. Returns source records, assembly/release, coverage, totals, count units and provenance. snapshot_unavailable requires a fresh resolution/profile request.

输入参数limitcursorgene_id必填section必填snapshot_id必填

search_gene_literature

Find live literature for a resolved public gene

Retrieve a live publication capture for a resolved gene_id and snapshot_id. Returns source links, match labels, capture time/hash, degradation and gene/snapshot/sort-bound cursors. This capture is separate from the immutable reference snapshot and contains no abstracts.

输入参数sortlimitcursorgene_id必填snapshot_id必填

版本历史

4
  1. v2.0.0最新Nov 6, 2026
  2. v1.7.0Nov 1, 2026
  3. v1.6.0Oct 30, 2026
  4. v1.5.0Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Clinical 集成