MCP Indian Medical Standard (mcp-indian-medical-std)

Quick Installation & Usage

# Install globally (recommended for Windows)
npm install -g mcp-indian-medical-std

# Or use directly with npx (works from anywhere)
npx mcp-indian-medical-std

# Start HTTP server
npx mcp-indian-medical-std --http

# Custom port configuration
npx mcp-indian-medical-std --http --port=3000

MCP Configuration

To use this as an MCP server with Claude Desktop or Cline, add the following configuration:

For Cline (VS Code Extension)

Add to your cline_mcp_settings.json:

{
  "mcpServers": {
    "mcp-indian-medical-std": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-indian-medical-std"]
    }
  }
}

For Claude Desktop

Add to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "mcp-indian-medical-std": {
      "command": "npx",
      "args": ["-y", "mcp-indian-medical-std"]
    }
  }
}

A Model Context Protocol (MCP) server that provides comprehensive medical information by querying multiple authoritative medical APIs including FDA, WHO, PubMed, and RxNorm. Now with real-time Indian medical data integration from ICMR, IMA, AIIMS, and leading Indian medical journals.

✨ What's New - Indian Medical Data Integration

🇮🇳 Real-Time Indian Medical Sources

• ICMR (Indian Council of Medical Research)
• IMA (Indian Medical Association)
• AIIMS (All India Institute of Medical Sciences)
• NMC (National Medical Commission)
• MoHFW (Ministry of Health and Family Welfare)
• AYUSH (Ministry of AYUSH)
• WHO India Office

📰 Indian Medical Journals

• IJMR - Indian Journal of Medical Research
• JIMA - Journal of Indian Medical Association
• IJCP - Indian Journal of Clinical Practice
• NMJI - National Medical Journal of India
• IJMS - Indian Journal of Medical Sciences
• IJCM - Indian Journal of Community Medicine
• IJP - Indian Journal of Pharmacology
• JPGM - Journal of Postgraduate Medicine

🎯 New Features

• ✅ Real-time data fetching (no hardcoded examples)
• ✅ PubMed API integration for Indian research
• ✅ CrossRef API for journal metadata
• ✅ Web scraping with rate limiting
• ✅ Smart caching with configurable TTL
• ✅ JSON storage for persistence
• ✅ CSV export for analysis
• ✅ Data classification (Research, Policy, Advisory, etc.)
• ✅ Academic referencing (titles, authors, DOIs, abstracts)
• ✅ Search & filter capabilities
• ✅ Modular architecture for easy expansion

Features

🔍 Drug Information

• Search Drugs: Search for drug information from FDA databases
• Drug Details by NDC: Get detailed information about drugs using National Drug Code
• RxNorm Drug Search: Search drugs using the RxNorm API
• Drug Interactions: Check for potential drug interactions

📊 Health Data

• WHO Health Indicators: Access global and country-specific health indicators
• Medical Databases: Search across multiple medical databases
• Clinical Guidelines: Search for clinical practice guidelines

📚 Research & Literature

• PubMed Search: Search PubMed for medical research articles
• PubMed Article Details: Get detailed information about specific articles using PMID
• Google Scholar: Search medical literature on Google Scholar
• Medical Journals: Search across major medical journals

🇮🇳 Indian Medical Data (NEW!)

• Fetch Indian Research: Real-time articles from PubMed/CrossRef with Indian context
• Journal Articles: Scrape latest from 8 major Indian medical journals
• Organization Updates: News from ICMR, AIIMS, MoHFW, etc.
• Health Advisories: Real-time alerts from health authorities
• Clinical Guidelines: Indian clinical practice guidelines
• Data Search: Search all stored Indian medical data
• Export: CSV and JSON export for analysis
• Statistics: Track data collection metrics

Installation

Quick Start with npx

You can use this MCP server instantly without installation:

npx mcp-indian-medical-std

Global Installation

npm install -g mcp-indian-medical-std

Then run:

mcp-indian-medical

Development Setup

# Clone repository
git clone <repository-url>
cd medical-mcp-main

# Install dependencies
npm install

# Build
npm run build

# Run
npm start

Usage

Command Line Options

Standard Mode (stdio):

npx mcp-indian-medical-std

HTTP Mode:

npx mcp-indian-medical-std --http

HTTP Mode with Custom Port:

npx mcp-indian-medical-std --http --port=3000

Integration with Claude Desktop

Add the following configuration to your Claude Desktop config file:

Location of config file:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "mcp-indian-medical-std": {
      "command": "npx",
      "args": ["-y", "mcp-indian-medical-std"]
    }
  }
}

After adding the configuration, restart Claude Desktop to load the MCP server.

📖 Documentation

• Quick Start Guide - Get started with Indian medical data integration
• Indian Medical Integration - Comprehensive documentation of new features
• Tool Reference - Complete list of all MCP tools

Available Tools

Core Medical Tools

1. search_drugs

Search for drugs in the FDA database.

Parameters:

• query (string): Search term for drugs
• limit (number): Number of results (default: 5, max: 50)

Example:

Search for "aspirin"

2. get_drug_by_ndc

Get detailed drug information using National Drug Code.

Parameters:

• ndc (string): National Drug Code

Example:

Get drug details for NDC "0378-1805-05"

3. search_rxnorm_drugs

Search for drugs using RxNorm API.

Parameters:

• query (string): Drug name or term

Example:

Search RxNorm for "metformin"

4. check_drug_interactions

Check for potential drug interactions.

Parameters:

• drug1 (string): First drug name
• drug2 (string): Second drug name

Example:

Check interactions between warfarin and aspirin

5. get_health_indicators

Get WHO health indicators for a country or globally.

Parameters:

• indicator_name (string): Health indicator to search for
• country (string, optional): Country code (default: "IND" for India)

Example:

Get health indicators for India

6. search_pubmed

Search PubMed for medical research articles.

Parameters:

• query (string): Search query
• max_results (number, optional): Maximum results to return (default: 10)
• include_india_context (boolean): Add India context (default: true)

Example:

Search PubMed for "diabetes treatment"

7. get_pubmed_article

Get detailed information about a PubMed article.

Parameters:

• pmid (string): PubMed ID

Example:

Get article details for PMID "12345678"

8. search_google_scholar

Search Google Scholar for medical literature.

Parameters:

• query (string): Search query
• include_india_filter (boolean): Add India context (default: true)

Example:

Search Google Scholar for "COVID-19 vaccines"

9. search_clinical_guidelines

Search for clinical practice guidelines.

Parameters:

• query (string): Search query
• organization (string, optional): Filter by organization
• include_india_context (boolean): Add India context (default: true)

Example:

Search for diabetes management guidelines in India

10. search_medical_databases

Search across multiple medical databases.

Parameters:

• query (string): Search query
• include_india_context (boolean): Add India context (default: true)

Example:

Search medical databases for malaria treatment

11. search_medical_journals

Search major medical journals.

Parameters:

• query (string): Search query
• include_india_context (boolean): Add India context (default: true)

Example:

Search medical journals for tuberculosis research

🇮🇳 Indian Medical Data Tools (NEW!)

12. fetch_indian_research_articles

Fetch real-time Indian medical research articles from PubMed and CrossRef.

Parameters:

• query (string, optional): Search query
• source ("PubMed" | "CrossRef" | "Both"): Data source (default: "Both")
• limit (number): Number of articles (default: 20, max: 50)
• forceRefresh (boolean): Skip cache (default: false)
• saveToStorage (boolean): Save to JSON (default: true)

Example:

Fetch Indian research articles about diabetes

13. fetch_indian_journal_articles

Scrape recent articles from Indian medical journals.

Parameters:

• journal (string): "IJMR" | "JIMA" | "IJCP" | "NMJI" | "IJMS" | "IJCM" | "IJP" | "JPGM" | "All"
• forceRefresh (boolean): Skip cache (default: false)
• saveToStorage (boolean): Save to JSON (default: true)

Example:

Fetch articles from Indian Journal of Medical Research

14. fetch_organization_updates

Fetch latest news from Indian medical organizations.

Parameters:

• organization (string): "ICMR" | "IMA" | "AIIMS" | "NMC" | "MoHFW" | "AYUSH" | "WHO_India" | "All"
• forceRefresh (boolean): Skip cache (default: false)
• saveToStorage (boolean): Save to JSON (default: true)

Example:

Fetch updates from ICMR

15. fetch_health_advisories

Fetch real-time health advisories from Indian authorities.

Parameters:

• organization (string, optional): "ICMR" | "MoHFW" | "WHO_India" | "All"
• forceRefresh (boolean): Skip cache (default: false)
• saveToStorage (boolean): Save to JSON (default: true)

Example:

Fetch health advisories from all Indian health authorities

16. fetch_clinical_guidelines_india

Fetch clinical guidelines from Indian medical authorities.

Parameters:

• organization (string, optional): "ICMR" | "MoHFW" | "NMC" | "All"
• specialty (string, optional): Medical specialty filter
• forceRefresh (boolean): Skip cache (default: false)
• saveToStorage (boolean): Save to JSON (default: true)

Example:

Fetch clinical guidelines from ICMR for cardiology

17. search_stored_medical_data

Search through all stored Indian medical data.

Parameters:

• query (string): Search query
• category (array, optional): Filter by ["Research", "Policy Update", "Health Advisory", etc.]
• source (array, optional): Filter by source organization/journal
• dateFrom (string, optional): Start date (YYYY-MM-DD)
• dateTo (string, optional): End date (YYYY-MM-DD)

Example:

Search stored data for "malaria treatment" from ICMR since 2024

18. export_medical_data

Export stored data to CSV or JSON.

Parameters:

• dataType (string): "articles" | "advisories" | "guidelines" | "all"
• format (string): "csv" | "json"
• fileName (string, optional): Custom filename

Example:

Export articles to CSV

19. get_data_statistics

Get statistics about stored Indian medical data.

Example:

Show data statistics

20. clear_cache

Clear cached data to force fresh retrieval.

Parameters:

• source (string, optional): Specific source to clear

Example:

Clear cache for PubMed

🗂️ Data Storage

All Indian medical data is stored in JSON format:

./data/
├── indian_medical_articles.json      # Research articles
├── health_advisories.json            # Health advisories
├── clinical_guidelines.json          # Clinical guidelines  
├── policy_updates.json               # Policy updates
├── organization_news.json            # Organization news
└── exports/
    ├── exported_articles.csv         # CSV exports
    └── exported_data.json            # JSON exports

📊 Data Sources

Real-Time APIs (No Hardcoded Data)

• PubMed E-utilities API: Indian medical research
• CrossRef API: Journal metadata and DOIs
• Web Scraping: Organization websites (with rate limiting)

Data Classification

All data is automatically classified as:

• Research: Academic articles and studies
• Policy Update: Government policy changes
• Health Advisory: Health alerts and warnings
• Clinical Study: Clinical trial results
• Guideline: Clinical practice guidelines
• News: Organization announcements

🚀 Quick Examples

Example 1: Literature Review

1. Use fetch_indian_research_articles with query "diabetes India"
2. Use search_stored_medical_data to filter results
3. Use export_medical_data to export to CSV
4. Open in Excel or analysis tool

Example 2: Health Monitoring

1. Use fetch_health_advisories for all organizations
2. Use fetch_organization_updates from MoHFW
3. Use search_stored_medical_data with category "Health Advisory"
4. Export for team review

Example 3: Clinical Guidelines

1. Use fetch_clinical_guidelines_india from ICMR
2. Use search_stored_medical_data for specific condition
3. Export guidelines to CSV
4. Share with clinical team

**Example:**

Search guidelines for "hypertension management"

### 10. search_medical_databases
Search across multiple medical databases.

**Parameters:**
- `query` (string): Search query
- `databases` (array, optional): Specific databases to search

**Example:**

Search medical databases for "cancer treatment"

### 11. search_medical_journals
Search across major medical journals.

**Parameters:**
- `query` (string): Search query
- `journals` (array, optional): Specific journals to search

**Example:**

Search medical journals for "immunotherapy"

## Development

### Prerequisites

- Node.js 16 or higher
- npm or yarn

### Setup

1. Clone the repository:
```bash
git clone https://github.com/yourusername/indian_medical_mcp.git
cd indian_medical_mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Run in development mode:

npm run dev

Available Scripts

• npm run build - Build the TypeScript project
• npm start - Start the MCP server
• npm run start:http - Start in HTTP mode
• npm run start:http:port - Start in HTTP mode with custom port
• npm run dev - Build and start in development mode
• npm run dev:http - Build and start in HTTP development mode

Project Structure

indian_medical_mcp/
├── src/
│   ├── index.ts        # Main server implementation
│   ├── utils.ts        # Utility functions and API calls
│   ├── types.ts        # TypeScript type definitions
│   └── constants.ts    # Constants and configurations
├── build/              # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

API Data Sources

This MCP server integrates with:

• FDA: U.S. Food and Drug Administration databases
• WHO: World Health Organization health indicators
• PubMed: National Library of Medicine literature database
• RxNorm: Normalized naming system for medications
• Google Scholar: Academic search engine
• Clinical Guidelines: Various clinical practice guideline databases

Security

For security concerns, please review our SECURITY.md file.

License

This project is licensed under the ISC License - see the LICENSE.md file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues, questions, or contributions, please visit the GitHub repository.

Changelog

Version 1.0.0

• Initial release
• Support for FDA, WHO, PubMed, and RxNorm APIs
• Drug search and interaction checking
• Health indicators and clinical guidelines
• Medical literature search capabilities
• Optimized for Indian medical context

Acknowledgments

Built using the Model Context Protocol SDK by Anthropic.

Made with ❤️ for the medical community