Skip to main content
Glama
Sign In
CIViC MCP Server

CIViC MCP Server

by griffithlab
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

CIViC MCP Server

MCP-supported Chatbot for CIViC users: https://civicdb.org/mcp-chat

If you use the CIViC MCP Server in published work, please cite: CIViC MCP: integrating large language models with the Clinical Interpretations of Variants in Cancer

This is a Cloudflare Workers-based Model Context Protocol (MCP) server that provides tools for querying the CIViC (Clinical Interpretation of Variants in Cancer) API.

The CIViC database is a crowd-sourced repository of clinical interpretations of cancer variants. This MCP server enables structured queries and data analysis of cancer genomics information through natural language interactions with AI assistants.

Python 3.11.7

pip install -r requirements.txt

Directly Querying the MCP Server

The MCP Server can be called directly from the command line with the optional arguments disease and therapy to get CIViC evidence items:

python MCP_query_evidence.py --mp "EGFR" --disease "Lung Non-small Cell Carcinoma" --therapy "Erlotinib"

Related MCP server: CIViC MCP Server

Locally Hosting The CIViC MCP Server

We provide an example of doing this with GPT4o-mini. A personal API key is required, update the variable OPENAI_API_KEY in local_hosting/message_MCP_CIViC.py

python local_hosting/message_MCP_CIViC.py --msg "What is the clinical significance of EGFR variants in CIViC?"

Adding as a Claude Connector

Connector V2 URL: https://civic-mcp-server-v2.larscivic.workers.dev/mcp

Select sign-in not required

Usage

The server provides two main tools:

  1. get_variant_evidence: Return up to 50 evidence items for a CIViC molecular profile

  2. get_variant_assertions: Return CIViC assertions for a molecular profile

Evaluation Scripts

All evaluation files are located in eval_QA_experiment. The file agent_mode_run_results.csv contains the agent mode prompts and responses; the associated chat URLs were created but may no longer be available. QA_triplet_dataset.csv contains the 100 unique (Molecular Profile, Disease, Therapy) triplets along with their expected answers.

License

MIT License with Academic Citation Requirement - see LICENSE.md

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Nexonco

      Nexgene-Research
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables access to clinical evidence from the CIViC database, allowing users to search across variants, diseases, drugs, and phenotypes to support precision oncology research.
      63
      MIT

    • CIViC MCP Server

      QuentinCody
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables structured queries and data analysis of cancer genomics information by interfacing with the Clinical Interpretation of Variants in Cancer (CIViC) API. It converts GraphQL responses into queryable SQLite tables for efficient clinical interpretation and natural language interaction.
      Apache 2.0

    • clingen-link

      berntpopp
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying ClinGen curated evidence for gene-disease validity, dosage, actionability, and variant pathogenicity via MCP tools.
      MIT