医院管理系统服务器

一个全面的医院管理系统服务器,支持预约管理、医生管理、患者服务和WhatsApp集成,适用于医院运营管理。

  • by MagedDevOps
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 MagedDevOps/mcp-server

使用说明

AlSalam医院MCP服务器

一个全面的模型上下文协议(MCP)服务器,用于支持HTTP/SSE传输的医院管理操作。

概述

AlSalam医院MCP服务器为管理医院运营提供了强大的API,包括预约、医生管理、患者服务和WhatsApp集成。它使用Node.js、Express.js和MCP框架构建,支持通过服务器发送事件(SSE)进行实时通信。

特性

医院管理

  • 所有医院:检索所有支持语言的医院
  • 获取_专科_医院:为特定医院获取医学专科
  • 医生_医院_专科:按医院和专科查找医生
  • get_branches:召集所有医院分支机构

搜索与发现

  • 搜索_个人_类别:增强搜索功能,支持多语言
  • 选择doctor_from_list:从搜索结果中选择特定医生
  • get_doctor_slots_by_专业:使用专业ID获取可用插槽

预约管理

  • get_doctor_available_days:获得医生的可用预约天数
  • get_doctor_available_slots:获取特定日期的时间段
  • 提交预约:预订新约会
  • 确认_取消_预约:确认或取消现有约会
  • 格式_地点_日期:API提交的格式日期

患者管理

  • 检查_患者_ whatsapp _状态:检查WhatsApp注册状态
  • generate_otp:生成OTP以进行患者验证
  • 验证otp:验证OTP以进行身份验证

沟通

  • send_whatsapp_消息:向患者发送WhatsApp消息

附加功能

  • 多语言支持(阿拉伯语和英语)
  • 具有回退机制的智能搜索策略
  • 全面的错误处理和超时管理
  • 实时可用性检查
  • 自动电话号码格式化
  • CORS支持浏览器兼容性

端点

  • SSE连接: GET /mcp -建立服务器发送事件连接
  • 信息: POST /messages -从客户端接收JSON-RPC请求
  • 健康检查: GET /health -返回服务器状态和可用工具

配置

环境变量

  • PORT:服务器端口(默认值:3000)
  • REQUEST_TIMEOUT:API请求超时(默认值:50000ms)

外部API

  • API AlSalam医院: https://salemuatapi.alsalamhosp.com:446
  • Facebook WhatsApp API: https://graph.facebook.com/v21.0

安装

# Install dependencies
npm install

# Start the server
npm start

# Or run in development mode
node server.js

用法

服务器提供20+MCP工具,用于医院综合管理。使用任何兼容MCP的客户端进行连接:

  1. 通过以下方式建立SSE连接 /mcp 端点
  2. 通过发送JSON-RPC请求 /messages 端点
  3. 使用注册的工具进行医院操作

工具使用示例

// Search for a doctor
{
  "method": "tools/call",
  "params": {
    "name": "search_individual_category",
    "arguments": {
      "term": "دكتور أحمد",
      "lang": "A"
    }
  }
}

// Book an appointment
{
  "method": "tools/call",
  "params": {
    "name": "submit_appointment",
    "arguments": {
      "servType": "Consultation",
      "branchId": "1",
      "specId": "2",
      "docId": "123",
      "schedSerial": "456",
      "shiftId": "1",
      "dateDone": "15/12/2024 10:30:00",
      "expectedEndDate": "15/12/2024 11:00:00",
      "patTel": "96569020323",
      "telephoneCountryCode": "+965",
      "patName": "Ahmed Mohammed"
    }
  }
}

部署

此服务器配置为部署在:

  • 维塞尔 -无服务器部署 vercel.json
  • 铁路 -容器部署 railway.json
  • 渲染 -云平台 render.yaml
  • AWS应用程序运行程序 -集装箱服务 apprunner.yaml

Docker支持

# Build Docker image
docker build -t alsalam-hospital-mcp .

# Run container
docker run -p 3000:3000 alsalam-hospital-mcp

API 文档

有关API的详细文档,包括所有参数、响应格式和错误代码,请参阅综合技术文档。

安全考虑

  • 所有输入都使用Zod模式进行验证
  • 请求超时可防止挂起连接
  • CORS已配置为web浏览器访问
  • WhatsApp API凭据应存储在生产环境变量中

演出

  • SSE连接得到妥善管理和清理
  • 高效的搜索策略减少了API调用
  • 请求超时可防止挂起连接
  • 用于清洁资源管理的优雅停机流程

支持

有关此MCP服务器的技术支持或问题,请联系开发团队。