INDIAN MEDICINES (MCP SERVER)

by nowitsidb

4 stars
296 downloads
Not rated
GitHub

About

A comprehensive API server for medicine information lookup, alternative suggestions, and composition analysis. This server provides multiple endpoints for searching, filtering, and analyzing medicine data with advanced features like fuzzy matching and price comparison.

Details

Author
nowitsidb
GitHub stars
4
Downloads
296
Categories
Other, API

- Exact and fuzzy name matching for medicines
- Composition/ingredient-based search and analysis
- Multi-criteria filtering with pagination
- Alternative medicine suggestions with price comparison
- Prescription requirement filtering
- Performance optimizations with multiple indexing and precomputed ingredients

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name INDIAN MEDICINES (MCP SERVER)
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies from requirements.txt, prepare a JSON data file of medicines (default path /Users/siddharthbajpai/Downloads/MCP_SERVER/medicines.json), and run python medicines_server.py. Interact with the server using any MCP client, for example via MCPClient("medicines-db") and calling endpoints like search_medicines("paracetamol") or suggest_alternatives("Dolo 650").

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "indian medicines (mcp server)": {
            "INDIAN_MEDICINE_MCP_SERVER": {
                "command": "python",
                "args": [
                    "medicines_server.py"
                ]
            }
        }
    }
}

McpServers

{
    "INDIAN_MEDICINE_MCP_SERVER": {
        "command": "python",
        "args": [
            "medicines_server.py"
        ]
    }
}

INDIAN MEDICINES (MCP SERVER)

<div align="center">

Python
FastMCP
JSON

</div>

A comprehensive API server for medicine information lookup, alternative suggestions, and composition analysis. This server provides multiple endpoints for searching, filtering, and analyzing medicine data with advanced features like fuzzy matching and price comparison.

📖 Table of Contents

- Introduction
- Features
- Tech Stack
- Installation
- Usage
- API Reference
- Search Endpoints
- Filter Endpoints
- Analysis Endpoints
- Utility Endpoints
- Data Structure
- Performance Optimizations
- Contributing
- License

📋 Introduction

MedicineDB API Server is a high-performance tool designed to provide comprehensive access to medicine information. It offers a wide range of functionalities from basic medicine lookups to advanced composition analysis and alternative medicine suggestions. This server is built to handle large datasets efficiently while providing accurate and relevant results.

✨ Features

- Advanced Search Capabilities
- Exact and fuzzy name matching for medicines
- Composition/ingredient-based search
- Multi-criteria filtering with pagination
- Manufacturer and price range filtering

- Analysis Tools
- Composition string parser and analyzer
- Statistical analysis of the database
- Ingredient categorization

- Medical Decision Support
- Alternative medicine suggestions
- Price comparison between similar medicines
- Prescription requirement filtering

- Performance Optimized
- Multiple indexing for fast lookups
- Efficient similarity calculations
- Precomputed extracted ingredients

🛠️ Tech Stack

<div align="center">

| Technology | Purpose |
|------------|---------|
| Python | Core programming language |
| FastMCP | Server framework |
| JSON | Data storage format |

</div>

Libraries:
- difflib: For fuzzy string matching and medicine name similarity
- re: For parsing composition strings and ingredient extraction
- collections: For optimized data structures (defaultdict, Counter)
- math: For price bucketing and pagination calculations
- typing: For type hints
- dataclasses: For structured data

🚀 Installation

1. Clone the repository:

git clone https://github.com/yourusername/medicines-db.git
cd medicines-db

2. Install dependencies:

pip install -r requirements.txt

3. Prepare your medicine database:
```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.