Content
<div class="title-block" style="text-align: center;" align="center">
<b>Nexonco</b> by <a href="https://www.nexgene.ai">Nexgene Research</a> is an <a href="https://github.com/modelcontextprotocol">MCP</a> 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.
</div>
<br>
<div class="title-block" style="text-align: center;" align="center">
[](https://pypi.org/project/nexonco-mcp)
[](https://github.com/aidecentralized/nanda-servers/tree/main/nexonco-mcp)
[](https://github.com/Nexgene-Research/nexonco-mcp/blob/main/LICENSE)
</div>
## Demo
https://github.com/user-attachments/assets/02129685-5ba5-4b90-89e7-9d4a39986210
Watch full video here: [](https://youtu.be/1Mq8Hcb9V7o?si=jCbhqNabupaRiQWq)
## Setup
### Prerequisites
- [uv](https://github.com/astral-sh/uv#installation) 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
- [Model Context Protocol](https://github.com/modelcontextprotocol/python-sdk)
- [NANDA: The Internet of AI Agents](https://nanda.media.mit.edu/)
- [CIViC - Clinical Interpretation of Variants in Cancer](https://civicdb.org)
## License
This project is licensed under the MIT License - see the <a href="https://github.com/Nexgene-Research/nexonco-mcp/blob/main/LICENSE">LICENSE</a> 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), [Nexgene AI](https://www.nexgene.ai)
- Kutsal Ozkurt (@Goodsea), [Nexgene AI](https://www.nexgene.ai)
