mcp-duty-pharma 0.1.17

MCP Duty Pharma helps you locate pharmacies legally required to stay open during nights, weekends, and holidays

MCP Duty Pharma

MCP Duty Pharma helps you locate pharmacies legally required to stay open during nights, weekends, and holidays. Whether it's an emergency or just a late-night need, this tool ensures you always know where to go.

📋 System Requirements

• Python 3.10+

📦 Dependencies

Install all required dependencies:

# Using uv
uv sync

Required Packages

• fastmcp: Framework for building Model Context Protocol servers
• geoPy: Python library for accessing and geocoding/reverse geocoding locations.
• httpx: HTTP client for Python, which provides a simple and intuitive API for making HTTP requests.

All dependencies are specified in pyproject.toml.

📑 Table of Contents

• System Requirements
• Dependencies
• MCP Tools
• Getting Started
• Installation
• Safety Features
• Development Documentation

🛠️ MCP Tools

This MCP server provides the following tools to Large Language Models (LLMs):

get_nearby_duty_pharmacies

• Get ten closest pharmacies on duty today, sorted by distance to the given address.

🚀 Getting Started

Clone the repository:

git clone https://github.com/lsaavedr/mcp-duty-pharma.git
cd mcp-duty-pharma

📦 Installation

You can install this MCP server in either Claude Desktop or elsewhere. To use this server, add the following configuration to the settings file:

• in json format

{
  "MCP Duty Pharma": {
    "command": "uv",
    "args": ["tool", "run", "mcp_duty_pharma"]
  }
}

• in yaml format

mcpServers:
  - name: MCP Duty Pharma
    command: uv
    args:
      - tool
      - run
      - mcp_duty_pharma

🔒 Safety Features

• Rate Limiting: Each geocoding call is rate-limited (e.g., 1-second delay) to avoid excessive requests that violate usage limits.
• Error Handling: Catches geopy exceptions (timeouts, service errors) and returns safe [] results instead of crashing.

📚 Development Documentation

If you’d like to extend or modify this server:

• Check duty-pharma.py for how each tool is implemented and how duty-pharma is integrated.
• Look at geopy’s official docs for advanced usage like bounding boxes, language settings, or advanced data extraction.
• Look at regional government APIs for more data sources.