健康保险协议服务器

一个用于管理健康保险相关功能的模型上下文协议(MCP)服务器,包括理赔详情、计划福利和医疗服务提供者信息。

  • by bijub3705
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 bijub3705/health-assistant-mcp-server

使用说明

健康助手MCP服务器

用于健康保险相关功能的模型上下文协议(MCP)服务器,包括索赔详细信息、计划福利和医疗保健提供者信息。

特性

  1. 索赔管理

    • 按索赔编号检索索赔状态和详细信息
  2. 计划福利

    • 查看特定健康保险计划的承保详情
    • 了解服务限制和共付额信息
  3. 提供商搜索

    • 按姓名和地点查找医疗服务提供者
    • 查看供应商专业、联系信息和可用性

入门指南

先决条件

  • Python 3.11+
  • pip(Python包管理器)

安装

  1. 克隆存储库:

    git clone <repository-url>
    cd health-assistant-mcp-server
    
  2. 创建并激活虚拟环境(推荐):

    python -m venv .venv
    .venv\Scripts\activate  # On Windows
    # Or on Unix/macOS:
    # source .venv/bin/activate
    
  3. 安装所需的依赖项:

    pip install -r requirements.txt
    

依赖项

  • fastmcp==2.13.0.2
  • mcp==1.20.0
  • 媒染剂==2.12.3

运行服务器

使用以下命令启动MCP服务器:

uvicorn main:app --reload --host 0.0.0.0 --port 8000

服务器将于启动 http://localhost:8000 默认情况下。

发展

对于自动重新加载的开发:

uvicorn main:app --reload

API文档

服务器运行后,您可以访问以下端点:

1.获取索赔详细信息

工具名称: get_claim_details

检索特定保险索赔的详细信息。

参数:

  • claim_number (string,必填):索赔的唯一标识符

示例响应:

{
  "claim_number": "CLM123456",
  "status": "APPROVED",
  "date_of_service": "2023-10-15",
  "provider_name": "Dr. Sarah Johnson",
  "total_amount": 1200.0,
  "amount_covered": 1000.0,
  "patient_responsibility": 200.0,
  "service_description": "Annual physical examination"
}

2.获得计划福利

工具名称: get_plan_benefits

检索特定健康保险计划的福利和保险范围详细信息。

参数:

  • plan_id (string,必填):保险计划的唯一标识符

示例响应:

[
  {
    "service": "Primary Care Visit",
    "coverage": "$30 copay",
    "limitations": "Up to 4 visits per year"
  },
  {
    "service": "Specialist Visit",
    "coverage": "$50 copay",
    "limitations": "Requires referral"
  }
]

3.获取医疗服务提供者详细信息

工具名称: get_health_provider_details

按姓名和/或位置搜索医疗服务提供者。

参数:

  • provider_name (string,可选):提供者的全名或部分名称
  • zip_code (字符串,可选):要搜索的邮政编码

示例响应:

[
  {
    "name": "Dr. Sarah Johnson",
    "specialty": "Family Medicine",
    "address": "123 Health St, Suite 100",
    "city": "New York",
    "state": "NY",
    "zip_code": "10001",
    "phone": "(212) 555-0101",
    "accepting_new_patients": true,
    "languages": ["English", "Spanish"]
  }
]

模拟数据

服务器附带了用于演示目的的预填充模拟数据。以下数据可用:

  • 声称: CLM123456、CLM789012
  • 计划: 计划001,计划002
  • 供应商: Sarah Johnson博士、Michael Chen博士、Emily Wilson博士

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。