返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端