Agentcare MCP

🚀 Agent Care MCP Server Guide

This guide details how to set up and run the Model Context Protocol (MCP) server of Agent Care. Agent Care is an AI agent framework for the healthcare domain, supporting integration with FHIR APIs of vendors such as Cerner and Epic.

📦 Installation

Clone the Project

git clone {agentcare-mcp-github路径}
cd agentcare-mcp
npm install
npm run build

Start the MCP Server (Locally)

To start the MCP server, follow these steps:

1. Clone the Agent Care MCP repository.
2. Install the dependencies.
3. Build the project.
4. Start the service.

Configure Environment Variables

Depending on the vendor you choose (Cerner or Epic), refer to the following environment variable configuration examples:

Cerner Configuration Example

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 Configuration Example

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

💻 Usage Examples

Configure Claude Desktop

To configure Agent Care on Claude Desktop, follow these steps:

1. Open the settings interface of Claude Desktop.
2. Add environment variables pointing to your MCP server configuration file.
3. Start Claude Desktop and test the connection.

Use Inspector

To use Inspector, execute the following commands:

npm install -g @cerner/inspector-cli
inspector init

Troubleshooting

If you encounter issues, refer to the following common problems:

• Ensure that all environment variables are correctly set.
• Check the network connection to ensure access to the target FHIR service.
• View the log files for more error information.

Integrate with Goose

To integrate with the Goose framework, follow these steps:

1. Clone the Goose repository.
2. Install the dependencies.
3. Configure the MCP server address.
4. Start the service.

📚 Summary

This guide introduces how to set up and run the MCP server of Agent Care and provides detailed steps for integration with Claude Desktop and the Goose framework. For further assistance, refer to the official documentation or contact the support team.