印度药品 (MCP 服务器)

<div align="center">

</div>

一个全面的 API 服务器，用于药品信息查找、替代建议和成分分析。该服务器提供多个端点，用于搜索、过滤和分析药品数据，并具有模糊匹配和价格比较等高级功能。

📖 目录

• 简介
• 功能
• 技术栈
• 安装
• 使用
• API 参考
  • 搜索端点
  • 过滤端点
  • 分析端点
  • 实用工具端点
• 数据结构
• 性能优化
• 贡献
• 许可证

📋 简介

MedicineDB API 服务器是一个高性能工具，旨在提供对药品信息的全面访问。它提供广泛的功能，从基本的药品查找，到高级的成分分析和替代药品建议。该服务器旨在高效处理大型数据集，同时提供准确和相关的结果。

✨ 功能

• 高级搜索功能

  • 药品的精确和模糊名称匹配
  • 基于成分/配料的搜索
  • 具有分页功能的多条件过滤
  • 制造商和价格范围过滤

• 分析工具

  • 成分字符串解析器和分析器
  • 数据库的统计分析
  • 成分分类

• 医疗决策支持

  • 替代药品建议
  • 类似药品之间的价格比较
  • 处方要求过滤

• 性能优化

  • 多个索引，用于快速查找
  • 高效的相似性计算
  • 预先计算的提取成分

🛠️ 技术栈

<div align="center">

技术	用途
	核心编程语言
	服务器框架
	数据存储格式

</div>

库:

• difflib: 用于模糊字符串匹配和药品名称相似性
• re: 用于解析成分字符串和提取成分
• collections: 用于优化数据结构 (defaultdict, Counter)
• math: 用于价格分段和分页计算
• typing: 用于类型提示
• dataclasses: 用于结构化数据

🚀 安装

1. 克隆存储库:

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

2. 安装依赖:

pip install -r requirements.txt

3. 准备您的药品数据库:

# 确保您的 JSON 数据文件位于正确的路径
# 默认路径: /Users/siddharthbajpai/Downloads/MCP_SERVER/medicines.json
# 如果需要，更新代码中的 DATA_PATH

4. 运行服务器:

python medicines_server.py

📘 使用

该服务器通过 MCP (模型上下文协议) 架构公开多个 API 端点。您可以使用任何 MCP 客户端与服务器交互。

基本示例:

from mcp.client import MCPClient

# 连接到服务器
client = MCPClient("medicines-db")

# 搜索药品
result = client.search_medicines("paracetamol", max_results=5)
print(result)

# 获取特定药品的替代品
alternatives = client.suggest_alternatives("Dolo 650")
print(alternatives)

📚 API 参考

该服务器通过 MCP 框架提供 15 个 API 端点:

搜索端点

1. get_medicine_by_name

GET /get_medicine_by_name

通过药品的精确名称检索药品记录，并可选择更便宜的替代品。

参数:

• name (字符串, 必需): 药品的精确名称字段
• include_alternatives (布尔值, 可选, 默认=true): 是否在结果中包含更便宜的替代品

响应:

{
  "medicine": {
    "Name": "Dolo 650",
    "Manufacturer": "Micro Labs Ltd",
    "Composition": "Paracetamol (650mg)",
    "MRP": "30.29",
    "Prescription": "No",
    "Price_INR": "₹30.29",
    "Price_Category": "Low",
    "Active_Ingredients": ["Paracetamol"],
    "Ingredient_Count": 1,
    "Is_Combination": false,
    "Requires_Prescription": false,
    "Prescription_Type": "Over-the-Counter"
  },
  "cheaper_alternatives": [
    {
      "medicine": {...},
      "price_savings": "₹10.30",
      "savings_percentage": "34.0%",
      "similarity_score": "1.00"
    }
  ]
}

2. search_medicines

GET /search_medicines

跨所有药品字段进行全文搜索。

参数:

• query (字符串, 必需): 要搜索的子字符串 (不区分大小写)
• max_results (整数, 可选, 默认=10): 要返回的最大匹配记录数

响应:

[
  {
    "Name": "Dolo 650",
    "Manufacturer": "Micro Labs Ltd",
    "Composition": "Paracetamol (650mg)",
    "MRP": "30.29",
    "Price_INR": "₹30.29",
    ...
  },
  ...
]

3. fuzzy_search_by_name

GET /fuzzy_search_by_name

使用模糊匹配搜索名称与提供的部分名称相似的药品。

参数:

• partial_name (字符串, 必需): 要搜索的部分或拼写错误的药品名称
• similarity_threshold (数字, 可选, 默认=0.6): 包含在结果中的最小相似度分数 (0.0-1.0)
• max_results (整数, 可选, 默认=10): 要返回的最大匹配记录数

响应:

[
  {
    "similarity_score": "0.92",
    "medicine": {
      "Name": "Dolo 650",
      ...
    }
  },
  ...
]

4. search_by_composition

GET /search_by_composition

搜索包含特定活性成分的药品。

参数:

• ingredient (字符串, 必需): 要搜索的活性成分的名称
• max_results (整数, 可选, 默认=10): 要返回的最大匹配记录数

响应:

[
  {
    "Name": "Dolo 650",
    "Composition": "Paracetamol (650mg)",
    ...
  },
  ...
]

过滤端点

5. filter_by_price_range

GET /filter_by_price_range

按价格范围过滤药品。

参数:

• min_price (数字, 可选, 默认=0): 印度卢比的最低价格
• max_price (数字, 可选, 默认=null): 印度卢比的最高价格
• max_results (整数, 可选, 默认=20): 要返回的最大匹配记录数

响应:

[
  {
    "Name": "Crocin Pain Relief",
    "MRP": "49.43",
    "Price_INR": "₹49.43",
    ...
  },
  ...
]

6. filter_by_manufacturer

GET /filter_by_manufacturer

按制造商过滤药品。

参数:

• manufacturer (字符串, 必需): 完整的或部分制造商名称
• max_results (整数, 可选, 默认=20): 要返回的最大匹配记录数

响应:

[
  {
    "Name": "Dolo 650",
    "Manufacturer": "Micro Labs Ltd",
    ...
  },
  ...
]

7. filter_by_prescription_requirement

GET /filter_by_prescription_requirement

按处方要求过滤药品。

参数:

• prescription_required (布尔值, 必需): 处方药为 True，非处方药为 False
• max_results (整数, 可选, 默认=20): 要返回的最大匹配记录数

响应:

[
  {
    "Name": "Dolo 650",
    "Prescription": "No",
    "Requires_Prescription": false,
    "Prescription_Type": "Over-the-Counter",
    ...
  },
  ...
]

8. paginated_search

GET /paginated_search

具有分页和多重过滤的高级搜索。

参数:

• query (字符串, 可选, 默认=""): 常规搜索词 (搜索所有字段)
• page (整数, 可选, 默认=1): 页码 (从 1 开始)
• page_size (整数, 可选, 默认=10): 每页的结果数
• manufacturer (字符串, 可选, 默认=""): 按制造商过滤 (完整或部分)
• min_price (数字, 可选, 默认=0): 最小价格过滤器
• max_price (数字, 可选, 默认=null): 最大价格过滤器
• prescription_required (布尔值或 null, 可选, 默认=null): 按处方要求过滤 (null 表示任何)
• ingredient (字符串, 可选, 默认=""): 按活性成分过滤

响应:

{
  "meta": {
    "total_results": 150,
    "page": 1,
    "page_size": 10,
    "total_pages": 15
  },
  "results": [
    {
      "Name": "Dolo 650",
      ...
    },
    ...
  ]
}

分析端点

9. find_similar_medicines

GET /find_similar_medicines

查找与指定药品具有相似成分的药品。

参数:

• medicine_name (字符串, 必需): 参考药品的名称
• max_results (整数, 可选, 默认=5): 要返回的最大相似药品数

响应:

{
  "reference_medicine": {
    "Name": "Dolo 650",
    ...
  },
  "similar_medicines": [
    {
      "similarity_score": "1.00",
      "medicine": {
        "Name": "Crocin Pain Relief",
        ...
      }
    },
    ...
  ]
}

10. analyze_composition

GET /analyze_composition

分析药品成分字符串以提取和构建成分。

参数:

• composition (字符串, 必需): 成分字符串 (例如 "Ambroxol (30mg/5ml) + Levosalbutamol (1mg/5ml)")

响应:

{
  "raw_composition": "Ambroxol (30mg/5ml) + Levosalbutamol (1mg/5ml)",
  "ingredients": [
    {
      "raw_text": "Ambroxol (30mg/5ml)",
      "name": "Ambroxol",
      "dosage": "30mg/5ml",
      "dosage_value": "30",
      "dosage_unit": "mg"
    },
    {
      "raw_text": "Levosalbutamol (1mg/5ml)",
      "name": "Levosalbutamol",
      "dosage": "1mg/5ml",
      "dosage_value": "1",
      "dosage_unit": "mg"
    }
  ],
  "medicines_with_this_composition": [
    {
      "Name": "Ascoril LS Syrup",
      ...
    },
    ...
  ]
}

11. count_medicines_by_composition

GET /count_medicines_by_composition

计算并列出具有特定成分或包含特定成分的所有药品。

参数:

• composition (字符串, 必需): 要搜索的成分
• exact_match (布尔值, 可选, 默认=false): 如果为 True，则仅查找具有精确成分的药品。如果为 False，则查找包含此成分的药品。

响应:

{
  "query": "Paracetamol",
  "exact_match": false,
  "total_medicines_found": 500,
  "total_manufacturers": 25,
  "price_statistics": {
    "min_price": "₹10.50",
    "max_price": "₹150.75",
    "avg_price": "₹45.30",
    "total_medicines_with_price": 490
  },
  "medicines": [...],
  "by_manufacturer": {
    "Cipla": {
      "count": 50,
      "medicines": [...]
    },
    ...
  }
}

12. categorize_medicines

GET /categorize_medicines

按活性成分对药品进行分类，并返回最常见的类别。

参数:

• max_categories (整数, 可选, 默认=10): 要返回的最大类别数

响应:

[
  {
    "category": "Paracetamol",
    "medicine_count": 500,
    "example_medicines": [...]
  },
  {
    "category": "Amoxicillin",
    "medicine_count": 300,
    "example_medicines": [...]
  },
  ...
]

实用工具端点

13. get_medicine_statistics

GET /get_medicine_statistics

获取药品数据库的统计概述。

参数: 无

响应:

{
  "total_medicines": 15000,
  "prescription_count": 7500,
  "otc_count": 7000,
  "unknown_prescription_status": 500,
  "manufacturer_counts": {
    "Sun Pharma": 1200,
    "Cipla": 900,
    ...
  },
  "price_distribution": {
    "min_price": "₹1.50",
    "max_price": "₹2500.00",
    "avg_price": "₹125.45",
    "price_ranges": {
      "₹0 - ₹99.99": 5000,
      "₹100 - ₹199.99": 4000,
      ...
    }
  },
  "common_ingredients": {
    "Paracetamol": 500,
    "Amoxicillin": 300,
    ...
  }
}

14. get_all_manufacturers

GET /get_all_manufacturers

获取数据库中所有制造商的列表。

参数: 无

响应:

[
  {
    "name": "Sun Pharma",
    "medicine_count": 1200
  },
  {
    "name": "Cipla",
    "medicine_count": 900
  },
  ...
]

15. suggest_alternatives

GET /suggest_alternatives

根据成分相似性和价格推荐替代药品。

参数:

• medicine_name (字符串, 必需): 参考药品的名称
• max_suggestions (整数, 可选, 默认=5): 要推荐的最大替代品数量

响应:

{
  "reference_medicine": {
    "Name": "Dolo 650",
    "MRP": "30.29",
    ...
  },
  "alternatives": [
    {
      "medicine": {
        "Name": "Calpol 650",
        "MRP": "26.50",
        ...
      },
      "ingredient_similarity": 1.0,
      "price_difference_percentage": -12.5,
      "price_comparison": "cheaper",
      "absolute_price_difference": 3.79
    },
    ...
  ]
}

📊 数据结构

系统期望一个 JSON 药品对象数组，其结构如下:

[
  {
    "Name": "药品名称",
    "Manufacturer": "公司名称",
    "Composition": "成分1 (10mg) + 成分2 (20mg)",
    "MRP": "123.45",
    "Prescription": "Yes"
  },
  ...
]

系统使用其他计算字段增强此数据:

• Price_INR: 带有货币符号的格式化价格
• Price_Category: 分类为低/中/高/高级
• Active_Ingredients: 提取的成分列表
• Ingredient_Count: 活性成分的数量
• Is_Combination: 药品是否包含多种成分
• Requires_Prescription: 处方要求的布尔值
• Prescription_Type: 人类可读的处方状态

⚡ 性能优化

服务器实现了多项优化:

1. 多个索引，用于快速查找:

   • 名称索引
   • 制造商索引
   • 成分索引
   • 价格索引
   • 处方索引

2. 成分提取在启动时完成一次，以避免重复解析

3. 相似性计算使用高效的算法:

   • 用于字符串相似性的 SequenceMatcher
   • 用于成分相似性的 Jaccard 指数

4. 价格分段，用于更快的范围查询

🤝 贡献

欢迎贡献! 您可以通过以下方式提供帮助:

1. Fork 存储库
2. 创建一个功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

请确保适当地更新测试。

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

---

<div align="center"> <p>由 Siddharth Bajpai 开发</p> <p>如有问题或需要支持，请联系 your-email@example.com</p> <p>有关药品数据，请在 <a href="https://www.linkedin.com/in/siddharth-bajpai-2472b1297/">LinkedIn</a> 上与我联系</p> </div>