Pubmed Medical Literature Research

🚀 Medical Literature Research Tool

This tool enables users to search for medical literature by topics and researchers' names, retrieve comprehensive publication information, generate formatted citations, and analyze researchers' publication statistics.

🚀 Quick Start

This tool simplifies the process of searching and analyzing medical literature. Follow the steps below to get started.

✨ Features

• Search for medical literature using topics and researchers' names.
• Retrieve comprehensive publication information with structured metadata.
• Generate formatted citation information.
• Analyze researchers' publication statistics and patterns.
• Equipped with an advanced error handling mechanism, including a retry function.
• Provide detailed performance metrics.

📦 Installation

1. Clone this repository:

   git clone <repository-url>
   cd medical-literature-tool
   

2. Install dependencies:

   pip install -r requirements.txt
   

3. If configuration is required, create a .env file in the project root directory.

💻 Usage Examples

Basic Usage

1. Start the server:

   mcp run pubmed_server.py
   

   For development mode:

   mcp dev pubmed_server.py
   

2. Or add the server to your MCP client configuration.

📚 Documentation

API Tools

1. find_articles

Search for medical literature that matches the specified topics and researchers.

Parameters:

• topics (List[str]): Medical terms or keywords to search in titles and abstracts.
• researchers (List[str]): Names of researchers/authors.
• result_limit (int): Maximum number of results to return (default: 15).

Returns:

• A dictionary containing search results, metadata, and performance metrics.

2. get_publication_details

Retrieve detailed information about a specific publication, including a formatted citation.

Parameters:

• article_id (str): PubMed ID of the article to retrieve.

Returns:

• A dictionary containing detailed article metadata and citation.

3. get_article_statistics

Analyze the publication patterns of a specific researcher.

Parameters:

• researcher (str): Name of the researcher/author to analyze.

Returns:

• A dictionary containing publication statistics (including total count, top journals, and publication years).

🔧 Technical Details

The server is implemented with a robust architecture:

• Object - Oriented Design: Organize code through classes.
• Advanced Error Handling: Request retry mechanism to ensure API reliability.
• Performance Monitoring: Record the time and metrics of search operations.
• Enhanced Data Structures: Nested JSON responses containing rich metadata.
• Logging System: Rotating logs with detailed error tracking.
• Modular Components: Separate concerns between query building, API requests, and data parsing.