使用说明
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的客户端进行连接:
- 通过以下方式建立SSE连接
/mcp端点 - 通过发送JSON-RPC请求
/messages端点 - 使用注册的工具进行医院操作
工具使用示例
// 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服务器的技术支持或问题,请联系开发团队。