Synergy Age MCP

What longevity-genie/synergy-age-mcp MCP server does

The longevity-genie/synergy-age-mcp MCP server connects MCP-compatible assistants and agents to the SynergyAge database. SynergyAge contains curated, experimentally validated records about genetic interventions that affect lifespan, including single-gene mutants and combinations of genes. Its interaction data covers synergistic, antagonistic, additive, and epistatic relationships.

The dataset includes research involving organisms such as C. elegans, Drosophila melanogaster, and mice. Records can include quantitative lifespan effects and relationships between interventions. This makes the server suitable for querying longevity experiments, comparing intervention combinations, and investigating how genetic changes relate to lifespan outcomes.

How it works

At startup or when data is needed, the longevity-genie/synergy-age-mcp MCP server obtains the current database files from the synergy-age directory in the longevity-genie/bio-mcp-data repository on Hugging Face Hub. The main files are synergy-age.sqlite and synergyage_prompt.txt. Downloaded files are cached locally to reduce repeated network access, and local fallback files can be used for development or offline operation.

The server presents the database through MCP rather than requiring an assistant to manage SQLite files directly. Natural-language requests can be translated by an MCP client into SQL queries, while the server executes those queries in read-only mode. The server also publishes resource://db-prompt for schema documentation and usage guidance, plus resource://schema-summary for a formatted table summary.

It can run over standard input/output, streamable HTTP, or Server-Sent Events. HTTP mode uses port 3002 by default and exposes the MCP endpoint at /mcp; the README also identifies /docs as the documentation location.

Setup and configuration

The package requires Python 3.10 or newer and can be launched with uvx without cloning the repository:

uvx synergy-age-mcp stdio

Use the stdio subcommand for clients that communicate through standard input and output. Other documented launch modes are uvx synergy-age-mcp for the default streamed HTTP behavior, uvx synergy-age-mcp server for HTTP mode, and uvx synergy-age-mcp sse for SSE mode. HTTP mode accepts a --port option, such as --port 8000.

The repository includes configuration examples for MCP clients including Claude Desktop, Cursor, and Windsurf. If uvx encounters cache-related problems, the README suggests running uv cache clean.

Tools and capabilities

The longevity-genie/synergy-age-mcp MCP server provides three database tools:

• synergyage_db_query(sql: str): runs a read-only SQL statement against the SynergyAge SQLite database.
• synergyage_get_schema_info(): returns table, column, and data-description details.
• synergyage_example_queries(): supplies example SQL queries with explanations.

The underlying SynergyAge project also supports text searches involving multiple genes separated by commas or semicolons, grouped result categories for single- and multi-gene mutants, network visualization of model relationships, epistasis analysis, and links to KEGG and model-specific databases. These capabilities describe the broader SynergyAge data system; the MCP interface specifically exposes the listed tools and resources.

Limitations and notes

Queries are read-only, so the server is intended for data retrieval and analysis rather than modifying the database. The data depends on the files available in the Hugging Face source and may require network access when a cached or local copy is unavailable. The README notes that the server does not currently provide a Swagger/OpenAPI interface; MCP Inspector or an MCP client should be used to explore its tools.

SynergyAge focuses on curated experimental research and model-organism lifespan data. Results should therefore be interpreted as database records from aging research, not as clinical recommendations or evidence about human treatment outcomes.