Pedigree MCP Server

家谱MCP服务器

An MCP (Model Context Protocol) server for generating family pedigree tree diagrams as PNG images using standard genetic notation per Bennett 2008/2022 NSGC guidelines.

BRCA1 hereditary breast/ovarian cancer family history demonstrating: 3 generations, affected individuals with combined conditions, MZ identical twins, carrier status, deceased indicators, proband + consultand markers, and gene test results (BRCA1+/BRCA1-)

安装

添加到您的MCP客户端配置中（例如，Claude Desktop）：

{
  "mcpServers": {
    "pedigree": {
      "command": "npx",
      "args": ["pedigree-mcp"],
      "env": {}
    }
  }
}

从源代码构建

如果您更喜欢从源代码构建：

git clone https://github.com/zzgael/pedigree-mcp.git
cd pedigree-mcp
npm install
npm run build

然后在MCP客户端配置中使用：

{
  "mcpServers": {
    "pedigree": {
      "command": "node",
      "args": ["/absolute/path/to/pedigree-mcp/dist/index.js"],
      "env": {}
    }
  }
}

特性

Bennett 2008标准合规性

此实施遵循 NSGC标准化人类谱系命名法:

// Genetic tests (pattern: {gene}_gene_test) brca1_gene_test?: { type: "-"|"S"|"T", result: "-"|"P"|"N" }; brca2_gene_test?: { type: "-"|"S"|"T", result: "-"|"P"|"N" }; // ... any gene test }

## 例子

**📸 [查看全部21个场景示例→](EXAMPLES.md)**

查看展示Bennett 2008/2022合规性的标准化谱系场景的完整图库，包括性别多样性、双胞胎、血缘关系、ART指标和复杂的多代家庭。

### 基本三代谱系

[ {"name": "MGF", "sex": "M", "top_level": true}, {"name": "MGM", "sex": "F", "top_level": true, "conditions": [{"name": "Breast cancer", "age": 55}]}, {"name": "Mother", "sex": "F", "mother": "MGM", "father": "MGF", "conditions": [{"name": "Breast cancer", "age": 42}]}, {"name": "Father", "sex": "M", "top_level": true}, {"name": "Proband", "display_name": "Sarah", "sex": "F", "mother": "Mother", "father": "Father", "proband": true, "age": 25, "brca1_gene_test": {"type": "T", "result": "P"}} ]

### 神经系统疾病谱系

[ {"name": "GF", "sex": "M", "top_level": true, "status": 1, "conditions": [{"name": "Huntington's disease", "age": 52}]}, {"name": "GM", "sex": "F", "top_level": true}, {"name": "Father", "sex": "M", "mother": "GM", "father": "GF", "conditions": [{"name": "Huntington's disease", "age": 48}]}, {"name": "Mother", "sex": "F", "top_level": true}, {"name": "Proband", "sex": "M", "mother": "Mother", "father": "Father", "proband": true, "age": 25, "carrier": true} ]

### 双胞胎示例

[ {"name": "Dad", "sex": "M", "top_level": true}, {"name": "Mom", "sex": "F", "top_level": true}, {"name": "Twin1", "sex": "M", "mother": "Mom", "father": "Dad", "mztwin": "mz1"}, {"name": "Twin2", "sex": "M", "mother": "Mom", "father": "Dad", "mztwin": "mz1"}, {"name": "DZTwin1", "sex": "M", "mother": "Mom", "father": "Dad", "dztwin": "dz1"}, {"name": "DZTwin2", "sex": "F", "mother": "Mom", "father": "Dad", "dztwin": "dz1"} ]

### 具有贝内特特色的复杂家庭

[ {"name": "GF", "sex": "M", "top_level": true, "status": 1}, {"name": "GM", "sex": "F", "top_level": true, "carrier": true}, {"name": "Father", "sex": "M", "mother": "GM", "father": "GF", "divorced": true}, {"name": "Mother", "sex": "F", "top_level": true}, {"name": "Child1", "sex": "F", "mother": "Mother", "father": "Father", "proband": true, "noparents": true}, {"name": "Loss", "sex": "U", "mother": "Mother", "father": "Father", "terminated": true} ]

## 发展

Install dependencies

npm install

Run in development mode (watch)

npm run dev

Run all tests

npm test

Build for production

npm run build

Type check

npx tsc --noEmit

## 测试

- **总共159次测试** 涵盖：
  - 验证（父母推荐信、性别限制）
  - SVG渲染（所有符号类型、指示器）
  - 条件标记和多条件饼图
  - 基因检测格式
  - 双渲染（MZ带条形，DZ不带条形）
  - 血缘关系检测
  - Bennett 2008合规性（携带者、怀孕、终止妊娠、离婚）
  - 边缘病例（家族深厚、世代广泛、同父异母兄弟姐妹）

## 参考文献

- [Bennett等人，2008年-标准化人类谱系命名法](https://pubmed.ncbi.nlm.nih.gov/18792771/)
- [Bennett等人，2022年-性别和性别包容性更新](https://pubmed.ncbi.nlm.nih.gov/36106433/)
- [爱荷华州人类遗传学-如何绘制家谱](https://humangenetics.medicine.uiowa.edu/resources/how-draw-pedigree)

## 许可证

MIT许可证-请参阅 [许可证](LICENSE)