clinicaltrialsgov-mcp-server 1.2.2 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
 
6
6
  <div align="center">
7
7
 
8
- [![Version](https://img.shields.io/badge/Version-1.2.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--06--18-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.18.2-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Status](https://img.shields.io/badge/Status-Stable-brightgreen.svg?style=flat-square)](https://github.com/cyanheads/clinicaltrialsgov-mcp-server/issues) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.2.23-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-92.46%25-brightgreen.svg?style=flat-square)](./vitest.config.ts)
8
+ [![Version](https://img.shields.io/badge/Version-1.3.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![MCP Spec](https://img.shields.io/badge/MCP%20Spec-2025--06--18-8A2BE2.svg?style=flat-square)](https://github.com/modelcontextprotocol/modelcontextprotocol/blob/main/docs/specification/2025-06-18/changelog.mdx) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.18.2-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Status](https://img.shields.io/badge/Status-Stable-brightgreen.svg?style=flat-square)](https://github.com/cyanheads/clinicaltrialsgov-mcp-server/issues) [![TypeScript](https://img.shields.io/badge/TypeScript-^5.9.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.2.23-blueviolet.svg?style=flat-square)](https://bun.sh/) [![Code Coverage](https://img.shields.io/badge/Coverage-92.46%25-brightgreen.svg?style=flat-square)](./vitest.config.ts)
9
9
 
10
10
  </div>
11
11
 
@@ -13,13 +13,14 @@
13
13
 
14
14
  ## 🛠️ Tools Overview
15
15
 
16
- This server provides three powerful tools for accessing and analyzing clinical trial data from ClinicalTrials.gov:
16
+ This server provides four powerful tools for accessing and analyzing clinical trial data from ClinicalTrials.gov:
17
17
 
18
- | Tool Name | Description |
19
- | :------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------- |
20
- | `clinicaltrials_search_studies` | Searches for clinical studies using a combination of query terms and filters. Supports pagination, sorting, and geographic filtering. |
21
- | `clinicaltrials_get_study` | Fetches one or more clinical studies by their NCT IDs. Returns either complete study data or concise summaries for each. |
22
- | `clinicaltrials_analyze_trends` | Performs statistical analysis on studies, aggregating data by status, country, sponsor, or phase. Handles up to 5000 studies per analysis. |
18
+ | Tool Name | Description |
19
+ | :------------------------------ | :------------------------------------------------------------------------------------------------------------------------------------------- |
20
+ | `clinicaltrials_search_studies` | Searches for clinical studies using query terms, filters, pagination, and sorting. Now includes geographic filtering. |
21
+ | `clinicaltrials_get_study` | Fetches one or more clinical studies by their NCT IDs, returning either full data or concise summaries. |
22
+ | `clinicaltrials_analyze_trends` | Performs statistical analysis on up to 5000 studies, with new time-series analysis by year and month. |
23
+ | `clinicaltrials_compare_studies`| Performs a detailed side-by-side comparison of 2-5 clinical studies, highlighting commonalities and differences. |
23
24
 
24
25
  ### `clinicaltrials_search_studies`
25
26
 
@@ -85,6 +86,28 @@ This server provides three powerful tools for accessing and analyzing clinical t
85
86
 
86
87
  📖 **[View detailed examples →](./examples/clinicaltrials_analyze_trends.md)**
87
88
 
89
+ ---
90
+
91
+ ### `clinicaltrials_compare_studies`
92
+
93
+ **Compare and contrast multiple studies** to identify key similarities and differences.
94
+
95
+ **Key Features:**
96
+
97
+ - Side-by-side comparison of 2-5 studies by NCT ID
98
+ - Extracts and contrasts eligibility, design, interventions, outcomes, sponsors, and more
99
+ - Generates a summary of commonalities and differences
100
+ - Handles partial failures gracefully if some studies cannot be fetched
101
+ - Highly configurable to focus on specific fields of interest
102
+
103
+ **Example Use Cases:**
104
+
105
+ - "Compare the study design and eligibility criteria for NCT04516746 and NCT04516759"
106
+ - "What are the main differences in interventions and outcomes between these three leading Alzheimer's trials?"
107
+ - "Show me a side-by-side of sponsor and location data for these competitor studies"
108
+
109
+ 📖 **[View detailed examples →](./examples/clinicaltrials_compare_studies.md)**
110
+
88
111
  ## ✨ Features
89
112
 
90
113
  This server is built on the [`mcp-ts-template`](https://github.com/cyanheads/mcp-ts-template) and inherits its rich feature set: