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) | 索赔书 |
设置
先决条件
- 在注册API访问 developer.va.gov
- 创建应用程序并获取OAuth凭据
- 将重定向URI设置为:
https://your-server-url/auth/callback
本地开发
- 克隆存储库:
git clone https://github.com/your-org/va-claims-mcp-server.git
cd va-claims-mcp-server- 创建虚拟环境:
python -m venv .venv
source .venv/bin/activate- 安装依赖项:
pip install -e .- 复制并配置环境变量:
cp .env.example .env
# Edit .env with your VA OAuth credentials- 运行开发服务器:
uvicorn src.va_claims.server:app --host 0.0.0.0 --port 8000 --reloadCloud.gov部署
- 登录Cloud.gov:
cf login -a api.fr.cloud.gov --sso- 设置环境变量:
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
cf set-env va-claims-mcp-server VA_CLIENT_SECRET - 部署:
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/oauth2API 参考
此服务器实现 VA福利声明API.
索赔状态
索赔可以具有以下状态:
- 待定
- 收到索赔
- 初步审查
- 证据收集、审查和决定
- 通知准备
- 完成
- 出错
- 已取消
安全
- 所有API调用都需要OAuth 2.0身份验证
- 令牌根据VA的用户信息端点进行验证
- 退伍军人身份(ICN)从经过身份验证的令牌中提取
- 凭据应安全存储(环境变量,而不是代码)
许可证
看 许可证 了解详情。
