Skip to main content

An advanced MCP Server for accessing and analyzing clinical evidence data, with flexible search options to support precision medicine and oncology research.

Project description

nexonco-mcp-banner

Nexonco by Nexgene Research is an MCP server for accessing clinical evidence from the CIViC (Clinical Interpretation of Variants in Cancer) database. It enables fast, flexible search across variants, diseases, drugs, and phenotypes to support precision oncology.

PyPI NANDA License

Demo

https://github.com/user-attachments/assets/02129685-5ba5-4b90-89e7-9d4a39986210

Watch full video here: Youtube

Setup

Prerequisites

  • uv or Docker
  • Claude Desktop (for MCP integration)

Setup Guides

For detailed setup instructions, refer to the following documentation:

  • NANDA Host Setup
    See docs/nanda-server-setup.md for backend configuration and local registration of the NANDA Server.

  • Claude Desktop Setup
    See docs/claude-desktop-setup.md for guidance on configuring the local development environment and MCP integration.

These guides include all required steps, environment configurations, and usage notes to get up and running.

Tool List

search_clinical_evidence: A MCP tool for querying clinical evidence data that returns formatted reports.

Input Schema

The tool accepts the following optional parameters:

  • disease_name (str): Filter by disease (e.g., "Lung Non-small Cell Carcinoma").
  • therapy_name (str): Filter by therapy or drug (e.g., "Cetuximab").
  • molecular_profile_name (str): Filter by gene or variant (e.g., "EGFR L858R").
  • phenotype_name (str): Filter by phenotype (e.g., "Chest Pain").
  • evidence_type (str): Filter by evidence type (e.g., "PREDICTIVE", "DIAGNOSTIC").
  • evidence_direction (str): Filter by evidence direction (e.g., "SUPPORTS").
  • filter_strong_evidence (bool): If True, only includes evidence with a rating > 3 (max 5).

Output

The tool returns a formatted string with four sections:

  1. Summary Statistics:
    • Total evidence items
    • Average evidence rating
    • Top 3 diseases, genes, variants, therapies, and phenotypes (with counts)
  2. Top 10 Evidence Entries:
    • Lists the highest-rated evidence items with details like disease, phenotype, gene/variant, therapy, description, type, direction, and rating.
  3. Sources & Citations:
    • Citations and URLs for the sources of the top 10 evidence entries.
  4. Disclaimer:
    • A note stating the tool is for research purposes only, not medical advice.

Sample Usage

  • "Find predictive evidence for colorectal cancer therapies involving KRAS mutations."
  • "Are there studies on Imatinib for leukemia?"
  • "What therapies are linked to pancreatic cancer evidence?"

Acknowledgements

License

This project is licensed under the MIT License - see the LICENSE file for details.

Disclaimer

⚠️ This tool is intended exclusively for research purposes. It is not a substitute for professional medical advice, diagnosis, or treatment.

Contributors

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nexonco_mcp-0.1.17.tar.gz (15.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nexonco_mcp-0.1.17-py3-none-any.whl (15.7 kB view details)

Uploaded Python 3

File details

Details for the file nexonco_mcp-0.1.17.tar.gz.

File metadata

  • Download URL: nexonco_mcp-0.1.17.tar.gz
  • Upload date:
  • Size: 15.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.6.14

File hashes

Hashes for nexonco_mcp-0.1.17.tar.gz
Algorithm Hash digest
SHA256 99809662165352e33f1509b72e88d671d857d1d22e6fbafbfb938d98e4cf5cf6
MD5 e0368adaf8b75c3462d03d17f5153759
BLAKE2b-256 311cb956018d84e5a72d3b9d0e4726a544ed6233bb4a85f00abc6c34ec002c1c

See more details on using hashes here.

File details

Details for the file nexonco_mcp-0.1.17-py3-none-any.whl.

File metadata

File hashes

Hashes for nexonco_mcp-0.1.17-py3-none-any.whl
Algorithm Hash digest
SHA256 bc59ec629b2ec33c31bb8fb4a141914bcf8cc1d547a4b93095c86555b35b0bc8
MD5 939b80ce555b8b4708b9e670426a006f
BLAKE2b-256 40c226f1e030d23ebfcf18ceef6b8dd944234427c8d6b2d8ec5f6ab25fd4aaf2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page