Health Assistant MCP Server

健康助手MCP服务器

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

特性

1. 索赔管理

- 按索赔编号检索索赔状态和详细信息

1. 计划福利

- 查看特定健康保险计划的承保详情 - 了解服务限制和共付额信息

1. 提供商搜索

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

入门指南

先决条件

• Python 3.11+
• pip（Python包管理器）

安装

1. 克隆存储库：

   git clone 
   cd health-assistant-mcp-server

1. 创建并激活虚拟环境（推荐）：

   python -m venv .venv
   .venv\Scripts\activate  # On Windows
   # Or on Unix/macOS:
   # source .venv/bin/activate

1. 安装所需的依赖项：

   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许可证获得许可-请参阅 许可证 文件以获取详细信息。