AI导哈

退伍军人福利索赔服务

一个提供安全访问VA.gov福利索赔API的MCP服务器，帮助退伍军人检查索赔状态、提交索赔和管理福利。

  • by GSA-TTS
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 GSA-TTS/va-claims-mcp-server-DEMO

使用说明

VA声称MCP服务器

一种MCP（模型上下文协议）服务器，提供对VA.gov福利声明API的安全访问。这使人工智能助理能够帮助退伍军人检查索赔状态、提交索赔和管理他们的退伍军人福利。

特性

  • OAuth 2.0身份验证：通过VA.gov OAuth进行安全访问
  • 索赔状态：检查现有索赔的状态
  • 列出索赔：查看退伍军人的所有索赔
  • 提交索赔：提交残疾赔偿申请（21-526EZ）
  • 有意归档：管理归档意图以保留生效日期
  • 授权委托书：提交和管理POA预约（21-22/21-22a）

可用工具

工具 说明 所需范围
list_claims 列出退伍军人的所有索赔 claim.read
get_claim_status 获取特定索赔的状态 claim.read
submit_disability_claim 提交新的残疾索赔（21-526EZ） claim.write
get_intent_to_file 获取当前提交意图状态 claim.read
submit_intent_to_file 提交新的意向文件（21-0966） claim.write
get_active_poa 获取当前有效的授权书 claim.read
get_poa_status 检查特定POA提交的状态 claim.read
submit_poa 提交授权书表格（21-22/21-22a） 索赔书

设置

先决条件

  1. 在注册API访问 developer.va.gov
  2. 创建应用程序并获取OAuth凭据
  3. 将重定向URI设置为： https://your-server-url/auth/callback

本地开发

  1. 克隆存储库：

    git clone https://github.com/your-org/va-claims-mcp-server.git
cd va-claims-mcp-server

  2. 创建虚拟环境：

    python -m venv .venv
source .venv/bin/activate

  3. 安装依赖项：

    pip install -e .

  4. 复制并配置环境变量：

    cp .env.example .env
# Edit .env with your VA OAuth credentials

  5. 运行开发服务器：

    uvicorn src.va_claims.server:app --host 0.0.0.0 --port 8000 --reload

Cloud.gov部署

  1. 登录Cloud.gov：

    cf login -a api.fr.cloud.gov --sso

  2. 设置环境变量：

    cf set-env va-claims-mcp-server BASE_URL https://va-claims-mcp.app.cloud.gov
cf set-env va-claims-mcp-server VA_CLIENT_ID <your-client-id>
cf set-env va-claims-mcp-server VA_CLIENT_SECRET <your-client-secret>

  3. 部署：

    cf push

环境变量

变量 描述 默认值
VA_CLIENT_ID 来自VA的OAuth客户端ID 必填
VA_CLIENT_SECRET 来自VA的OAuth客户端机密 必填
BASE_URL 服务器的公共URL http://localhost:8000
VA_API_BASE VA声明API基本URL https://sandbox-api.va.gov/services/claims/v2
VA_OAUTH_BASE VA OAuth基本URL https://sandbox-api.va.gov/oauth2

生产配置

对于生产部署，更新环境变量：

cf set-env va-claims-mcp-server VA_API_BASE https://api.va.gov/services/claims/v2
cf set-env va-claims-mcp-server VA_OAUTH_BASE https://api.va.gov/oauth2

API 参考

此服务器实现 VA福利声明API.

索赔状态

索赔可以具有以下状态：

  • 待定
  • 收到索赔
  • 初步审查
  • 证据收集、审查和决定
  • 通知准备
  • 完成
  • 出错
  • 已取消

安全

  • 所有API调用都需要OAuth 2.0身份验证
  • 令牌根据VA的用户信息端点进行验证
  • 退伍军人身份（ICN）从经过身份验证的令牌中提取
  • 凭据应安全存储（环境变量，而不是代码）

许可证

看 许可证 了解详情。

相关 MCP