Pedigree

Generates Bennett-compliant pedigree diagrams as PNG/SVG from structured data.

typescript

9

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can generate standardized pedigree diagrams as PNG or SVG images by using the Pedigree MCP Server. It implements Bennett 2008/2022 compliant pedigree notation to visualize family histories with genetic and relationship indicators, making it easy to produce publication-ready figures from structured data.

How to use

To create a pedigree diagram you configure an MCP client to connect to the Pedigree MCP Server. You provide an array of individuals with fields for name, sex, relations, and optional indicators like carrier status, pregnancy, or genetic test results. The server renders a diagram in PNG or SVG based on your preferred output format, size, and which attributes you want displayed.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You may also use a package manager that supports running MCP servers via npx.

# Option A: Run directly with npx (no build required)
npx pedigree-mcp

# Option B: Build from source and run locally
# (clone, install, build, then run the built index)

Configuration and usage notes

The Pedigree MCP Server supports two run modes shown in examples. In the first mode you run the server via an inline tool invocation, which is convenient for quick testing. In the second mode you build the server from source and run the built JavaScript entry point directly, which is useful for development and customization.

Development

If you prefer building from source, follow these steps to prepare and run a local development copy.

# Install dependencies
npm install

# Build for production or development
npm run build

# Start using the built entry point
node /absolute/path/to/pedigree-mcp/dist/index.js

Examples

You can provide an array of individuals with the fields shown in the data format to generate various pedigree scenarios, such as multi-generational families, twins, carriers, and pregnancy indicators. The server renders a PNG or SVG image from this data.

Notes on data model

The data format follows Bennett 2008 standards for symbolic representation and free-text conditions. You specify each person’s identity, relationships, clinical indicators, and optional genetic test results. The server maps these fields to the corresponding pedigree symbols and annotations in the output.

Troubleshooting

If you encounter rendering issues, verify that every person’s parent references point to valid names in your dataset, and confirm that the gender values are valid. Ensure the output format you request (png or svg) is supported by your MCP client.

Available tools

get_pedigree_documentation

Returns comprehensive documentation about the pedigree data format.

generate_pedigree

Generates a family pedigree tree in PNG or SVG format with configurable size, background, labels, and symbol set.

build_from_source

Provides a workflow to clone the repository, install dependencies, build, and run the server locally.