Back to MCP directory
publicPublicdnsLocal runtime

MCP Duty Pharma

MCP Duty Pharma是一个帮助用户查找法定夜间、周末及节假日营业药房的工具,通过Python实现地理位置查询与排序功能。

article

README

🚀 MCP 值班药房工具

MCP 值班药房工具可帮助您在夜间、周末和节假日期间,快速定位依法要求保持开放的药房。无论是急诊情况,还是深夜突发需求,使用该工具,您都能迅速知晓前往何处获取所需药品。

🚀 快速开始

克隆仓库:

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

📦 安装指南

系统要求

  • Python 3.10+

依赖项

安装所有必需的依赖项:

# 使用 uv
uv sync

必需包

  • fastmcp:用于构建 Model Context Protocol 服务器框架。
  • geopy:这是一个用于访问和对地址进行地理编码/反向地理编码的 Python 库。
  • httpx:提供简单直观 API 来进行 HTTP 请求的 Python HTTP 客户端。

所有依赖项均在 pyproject.toml 中指定。

安装配置

您可以在 Claude Desktop 或其他地方安装此 MCP 服务器。要使用此服务器,请将以下配置添加到设置文件中:

  • JSON 格式
{
  "MCP 值班药房": {
    "command": "uv",
    "args": ["tool", "run", "mcp_duty_pharma"]
  }
}
  • YAML 格式
mcpServers:
  - name: MCP 值班药房
    command: uv
    args:
      - tool
      - run
      - mcp_duty_pharma

✨ 主要特性

此 MCP 服务器为大型语言模型(LLMs)提供了以下工具:

get_nearby_duty_pharmacies

  • 获取今天值班的十个最近药房,按距离给定地址排序。

🔒 安全特性

  • 速率限制:每个地理编码调用均设置了速率限制(例如,1 秒延迟),以避免过多请求导致超出使用限制。
  • 错误处理:捕获 geopy 异常(超时、服务错误)并返回安全的 [] 结果,而不是崩溃。

📚 开发文档

如果您希望扩展或修改此服务器:

  • 查看 duty-pharma.py 了解每个工具的实现方式以及如何集成 duty-pharma。
  • 查看 geopy 的官方文档以获取高级用法,例如边界框、语言设置或高级数据提取。
  • 查看区域政府 API 以获取更多数据源。
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client