article
README
🚀 代理关怀 MCP 服务器指南
本指南详细介绍了如何设置和运行 Agent Care 的 Model Context Protocol (MCP) 服务器。Agent Care 是一个用于医疗保健领域的 AI 代理框架,支持与 Cerner 和 Epic 等厂商的 FHIR API 集成,为医疗保健领域的数据交互和处理提供便利。
🚀 快速开始
项目克隆
将项目克隆到本地,并安装依赖和构建项目,具体命令如下:
git clone {agentcare-mcp-github路径}
cd agentcare-mcp
npm install
npm run build
MCP 服务器启动(本地)
要启动 MCP 服务器,请按照以下步骤操作:
- 克隆 Agent Care MCP 仓库
- 安装依赖项
- 构建项目
- 启动服务
📦 安装指南
环境变量配置
根据您选择的厂商(Cerner 或 Epic),请参考以下环境变量配置示例:
Cerner 配置示例
OAUTH_CLIENT_ID=XXXXXXX
OAUTH_CLIENT_SECRET=XXXXXXX
OAUTH_TOKEN_HOST=https://fhir-ehr.cerner.com/r4/ecn_1234567890
OAUTH_AUTHORIZATION_METHOD=body
OAUTH_TOKEN_PATH=/interconnect-fhir-oauth/oauth2/token
OAUTH_AUTHORIZE_PATH=/interconnect-fhir-oauth/oauth2/authorize
OAUTH_AUDIENCE=https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
OAUTH_CALLBACK_URL=http://localhost:3456/oauth/callback
OAUTH_SCOPES=user/Patient.read%20user/Observation.read%20user/MedicationRequest.read%20user/Condition.read%20user/AllergyIntolerance.read%20user/Procedure.read%20user/CarePlan.read%20user/CareTeam.read%20user/Encounter.read%20user/Immunization.read
OAUTH_CALLBACK_PORT=3456
FHIR_BASE_URL=https://fhir-ehr.cerner.com/r4/ecn_1234567890
PUBMED_API_KEY=your_pubmed_api_key
CLINICAL_TRIALS_API_KEY=your_trials_api_key
FDA_API_KEY=your_fda_api_key
Epic 配置示例
OAUTH_CLIENT_ID=XXXXXXX
OAUTH_CLIENT_SECRET=
OAUTH_TOKEN_HOST=https://fhir.epic.com
OAUTH_AUTHORIZATION_METHOD=body
OAUTH_TOKEN_PATH=/interconnect-fhir-oauth/oauth2/token
OAUTH_AUTHORIZE_PATH=/interconnect-fhir-oauth/oauth2/authorize
OAUTH_AUDIENCE=https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
OAUTH_CALLBACK_URL=http://localhost:3456/oauth/callback
OAUTH_SCOPES=user/Patient.read%20user/Observation.read%20user/MedicationRequest.read%20user/Condition.read%20user/AllergyIntolerance.read%20user/Procedure.read%20user/CarePlan.read%20user/CareTeam.read%20user/Encounter.read%20user/Immunization.read
OAUTH_CALLBACK_PORT=3456
FHIR_BASE_URL=https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4
PUBMED_API_KEY=your_pubmed_api_key
CLINICAL_TRIALS_API_KEY=your_trials_api_key
FDA_API_KEY=your_fda_api_key
Claude Desktop 配置
要在 Claude Desktop 上配置 Agent Care,请参考以下步骤:
- 打开 Claude Desktop 的设置界面。
- 添加环境变量,指向您的 MCP 服务器配置文件。
- 启动 Claude Desktop 并测试连接。
Inspector 使用指南
要使用 Inspector,请执行以下命令:
npm install -g @cerner/inspector-cli
inspector init
Goose 集成指南
要与 Goose 框架集成,请按照以下步骤操作:
- 克隆 Goose 仓库
- 安装依赖项
- 配置 MCP 服务器地址
- 启动服务
📚 详细文档
故障排除
如果遇到问题,请参考以下常见问题:
- 确保所有环境变量已正确设置。
- 检查网络连接,确保能够访问目标 FHIR 服务。
- 查看日志文件以获取更多错误信息。
总结
本指南介绍了如何设置和运行 Agent Care 的 MCP 服务器,并提供了与 Claude Desktop 和 Goose 框架集成的详细步骤。如需进一步帮助,请参考官方文档或联系支持团队。
微信扫一扫