Clinicaltrials MCP Server

🚀 Clinical Trials MCP Server Guide

This guide provides a comprehensive overview of the Clinical Trials MCP Server, including installation, usage, and configuration details.

🚀 Quick Start

📦 Installation Requirements

• Python Version: 3.10+
• Dependencies:
  • pip install FastMCP pytrials pandas

📁 Project Structure

• clinical_trials_server.py: The main implementation of the MCP server, using the FastMCP framework.
• clinical_trials.py: Contains helper functions for interacting with the ClinicalTrials.gov API.

✨ Features

🌟 Core Features

• Clinical Trial Search

  • Search the ClinicalTrials.gov database by keywords or conditions and return basic information about matching trials:
    • Trial Title
    • NCT Number
    • Study Disease
    • Brief Summary

• Detailed Trial Information Query

  • Enter an NCT number to obtain more detailed trial information:

  • Full Title
  • Study Disease
  • Trial Phase
  • Intervention Measures
  • Results Analysis
  

📊 Data Processing Features

• CSV Data Import

  • Support loading local CSV files and viewing file contents.

• CSV File Listing

  • List all saved CSV files in the current directory.

🔌 MCP Resource Interfaces

📍 Resource Path Explanation

• clinicaltrials://corona_fields: Get data on fields related to the novel coronavirus.
• clinicaltrials://full_studies: Get complete clinical trial research data.
• clinicaltrials://csv/{filename}: Load CSV data by specifying a file name.
• clinicaltrials://available_files: List all available CSV files.
• clinicaltrials://study/{nct_id}: Query a specific study by NCT number.
• clinicaltrials://condition/{condition}: Filter relevant studies by disease name.

⚙️ Configuration Examples

🍎 Claude Desktop Configuration (Mac OS)

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "ClinicalTrials": {
      "command": "python",
      "args": ["-m", "ClinicalTrials-mcp-server"]
    }
  }
}

🪟 Windows Configuration Example

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "ClinicalTrials": {
      "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
      "args": [
        "-m",
        "ClinicalTrials-mcp-server"
      ]
    }
  }
}

🐧 Cline Configuration Example

Add the following to config.json:

{
  "mcpServers": {
    "ClinicalTrials": {
      "command": "bash",
      "args": [
        "-c",
        "source /home/YOUR/PATH/ClinicalTrials-MCP-Server/.venv/bin/activate && python /home/YOUR/PATH/ClinicalTrials-MCP-Server/clinical_trials_server.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

💻 Usage Examples

📋 Basic Usage

Search for Clinical Trials

Ask Claude:

Can you help me find the latest clinical trials on diabetes?

The following information will be returned:

• Title: The full trial name
• NCT Number: The unique identifier
• Study Disease: The specific condition targeted by the trial
• Summary: A brief overview of the study

Get Detailed Information

Enter a specific NCT number, for example:

Tell me more about NCT04567890.

The following will be returned:

• Full Title: A Study to Evaluate the Efficacy of a New Diabetes Treatment Drug
• Study Disease: Type 2 Diabetes
• Trial Phase: Phase III Clinical Trial
• Intervention Measures: A new oral hypoglycemic drug vs. placebo
• Results Analysis: Completed. The results show significantly better efficacy than the control group.

⚠️ Important Note

• Data Source: All information is sourced from the public ClinicalTrials.gov database.
• Update Frequency: It is recommended to refresh regularly to obtain the latest research progress.
• Privacy Protection: Ensure compliance with relevant laws, regulations, and user privacy policies.

ℹ️ Additional Information

🛠️ Technical Support

If you encounter any issues, please visit the project homepage or contact the maintenance team:

GitHub Link: https://github.com/clinical-trials-mcp-server
Contact Email: support@clinicaltrials.com

📋 Version Information

• Current Version: v1.0.0
• Change Log:
  • New Feature: Support for CSV file import and management.
  • Performance Optimization: Improved search speed and result accuracy.

Thank you for using the Clinical Trials MCP Server. If you need further assistance, please contact the technical support team at any time.