JSPM

mcp-indian-medical-std

1.0.2
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 7
  • Score
    100M100P100Q33328F
  • License ISC

A globally accessible Model Context Protocol (MCP) server providing comprehensive medical information from FDA, WHO, PubMed, and RxNorm APIs. Optimized for Indian medical context. Use with npx mcp_ind_std anywhere.

Package Exports

  • mcp-indian-medical-std
  • mcp-indian-medical-std/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (mcp-indian-medical-std) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

npm version License: ISC

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

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
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. 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