Agentcare (FHIR EMR)

🚀 Agent Care MCP Server

Agent Care MCP Server is a Model Control Platform (MCP) for managing artificial intelligence agents. It supports integration with AI agent frameworks such as Claude Desktop and Goose, and provides access to patient data from healthcare providers like Cerner and Epic.

🚀 Quick Start

📦 Installation

Clone the repository

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

Configure environment variables

Cerner configuration

{
  "OAUTH_CLIENT_ID": "portal",
  "OAUTH_CLIENT_SECRET": "portal",
  "OAUTH_TOKEN_HOST": "https://fhir-ehr.cerner.com",
  "OAUTH_TOKEN_PATH": "/interconnect-fhir-oauth/oauth2/token",
  "OAUTH_AUTHORIZE_PATH": "/interconnect-fhir-oauth/oauth2/authorize",
  "OAUTH_AUTHORIZATION_METHOD": "body",
  "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 user/Observation.read user/MedicationRequest.read user/Condition.read user/AllergyIntolerance.read user/Procedure.read user/CarePlan.read user/CareTeam.read user/Encounter.read user/Immunization.read",
  "OAUTH_CALLBACK_PORT": "3456",
  "FHIR_BASE_URL": "https://fhir-ehr.cerner.com/r4/ec2458f71b"
}

Epic configuration

{
  "OAUTH_CLIENT_ID": "FHIRTWO",
  "OAUTH_CLIENT_SECRET": "EpicFhir11!",
  "OAUTH_TOKEN_HOST": "https://fhir.epic.com",
  "OAUTH_TOKEN_PATH": "/interconnect-fhir-oauth/oauth2/token",
  "OAUTH_AUTHORIZE_PATH": "/interconnect-fhir-oauth/oauth2/authorize",
  "OAUTH_AUTHORIZATION_METHOD": "body",
  "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 user/Observation.read user/MedicationRequest.read user/Condition.read user/AllergyIntolerance.read user/Procedure.read user/CarePlan.read user/CareTeam.read user/Encounter.read user/Immunization.read",
  "OAUTH_CALLBACK_PORT": "3456",
  "FHIR_BASE_URL": "https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4"
}

Start the MCP server

npm run build

💻 Usage Examples

Use Claude Desktop

Configure claude_desktop_config.json

{
  "agent": {
    "type": "mcp",
    "host": "localhost",
    "port": 3000
  },
  "mcpConfig": {
    "OAUTH_CLIENT_ID": "portal",
    "OAUTH_CLIENT_SECRET": "portal"
  }
}

Start Claude Desktop

claudie desktop start

Use the Goose framework

Configure goose.json

{
  "agents": [
    {
      "name": "mcp-agent",
      "type": "mcp",
      "host": "localhost",
      "port": 3000
    }
  ]
}

Troubleshooting

Kill the occupied port

sudo lsof -i :3000
sudo kill -9 {PID}

Test user login

• Cerner: Username: portal, Password: portal
• Epic: Username: FHIRTWO, Password: EpicFhir11!

Image example