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

export

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.

MIT License

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

  • Obada Qasem (@obadaqasem)
  • Kutsal Ozkurt (@Goodsea)

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.9.tar.gz (15.4 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.9-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for nexonco_mcp-0.1.9.tar.gz
Algorithm Hash digest
SHA256 d4129d4052a34e0384be63ecaaaa2215dd92de53836d99a522be2e80b1ade698
MD5 733d8e5fcef975565355ca2b135a9db4
BLAKE2b-256 6315eb4f7f7a3bbfd8a0dee8a3a3345ff3b2a7ee517215954192e20caf850582

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for nexonco_mcp-0.1.9-py3-none-any.whl
Algorithm Hash digest
SHA256 545cf5ce5c0113739ec458fc89309fa225b32e4a71ecdfe2b842e9e607133e30
MD5 9ae4a0c4b7e526d7e5e7e2f02d8009f1
BLAKE2b-256 a4569243bf378fe14e9ee25b9f77dd6c9c3e207263626f6a9e5b311066aa7145

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