INDIAN MEDICINES (MCP SERVER)

by nowitsidb

4 296 downloads Not rated yet
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.

Explore

- 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

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

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:


The server exposes multiple API endpoints through MCP (Model Context Protocol) architecture. You can interact with the server using any MCP client.

Basic example:

python
from mcp.client import MCPClient

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"
        ]
    }
}

<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.