mutation-clinical-trial-matching-mcp
The Mutation Clinical Trial Matching MCP is a server application designed to integrate Claude Desktop with clinicaltrials.gov. It enables users to query genetic mutations and receive summarized information about relevant clinical trials. Developed using modern AI coding methodologies, it offers organized results through a modular approach.
Mutation Clinical Trial Matching MCP
A Model Context Protocol server integrating Claude Desktop with clinicaltrials.gov API for genetic mutation queries. Features include retrieving and summarizing clinical trials based on mutations in natural language queries. Developed using the Agentic Coding approach.
Project Structure
- Requirements: Search and summarize clinical trials; integrate with Claude Desktop.
- Flow Design: Queries Claude Desktop, MCP server tool calls clinicaltrials.gov.
- Utilities: API calls and working with Claude.
- Node Design: Implements PocketFlow Node pattern.
Components
- MCP Server: Main server using official Python SDK.
- Query Module: Handles API calls with error handling and validation.
- Summarizer: Processes data into organized markdown summaries.
Usage
- Install dependencies with
uv pip install -r requirements.txt
. - Configure Claude Desktop.
- Start Claude Desktop and ask mutation-related queries.
Dependencies
Requires Python 3.7+, PocketFlow, MCP SDK, Requests, and Python-dotenv.
Installation Instructions
- Clone repository, install
uv
, set up virtual environment, and update configuration paths.
Future Improvements
Refer to future_work.md for planned enhancements.
Troubleshooting
If connection issues occur, check logs or restart Claude.