MCP server for CharmHealth
概览
An MCP server for CharmHealth EHR that allows LLMs and MCP clients to interact with patient records, encounters, and practice information. This server can access, transmit, and surface protected health information (PHI). Use it only with: - HIPAA-compliant LLM services covered by a signed BAA and configured with no training and zero data retention - HIPAA-compliant MCP clients, or clients operated entirely within your HIPAA compliance program If you are using this with actual patient data (non-sandbox data), do not connect non-HIPAA consumer LLM endpoints or clients. You are responsible for enforcing access controls, audit logging, encryption in transit/at rest, and data retention policies for your deployment.
README
以下为原文 README 节选，完整内容请查看原文。
CharmHealth MCP Server
An MCP server for CharmHealth EHR that allows LLMs and MCP clients to interact with patient records, encounters, and practice information.
Critical HIPAA Notice
[!CAUTION] This server can access, transmit, and surface protected health information (PHI). Use it only with:
- HIPAA-compliant LLM services covered by a signed BAA and configured with no training and zero data retention
- HIPAA-compliant MCP clients, or clients operated entirely within your HIPAA compliance program
If you are using this with actual patient data (non-sandbox data), do not connect non-HIPAA consumer LLM endpoints or clients. You are responsible for enforcing access controls, audit logging, encryption in transit/at rest, and data retention policies for your deployment.
Features
The server provides 16 comprehensive tools for complete EHR functionality:
- Encounter Management: Complete SOAP note workflow and clinical findings
- Patient Search & Records: Advanced patient search with demographics, location, and medical criteria
- Patient Management: Complete demographic and administrative data handling
- Medical History: Comprehensive patient clinical overview and history review
- Drug Management: Unified medications, supplements, and prescribing with safety checks
- Allergy Management: Critical allergy documentation with safety alerts
- Diagnosis Management: Problem list and diagnosis tracking
- Clinical Notes: Quick clinical observations and provider communications
- Recalls & Follow-ups: Preventive care reminders and appointment scheduling
- Vital Signs: Complete vital signs recording and trend monitoring
- File Management: Patient photos, documents, and PHR invitations
- Laboratory Management: Lab results tracking and detailed reporting
- Practice Setup: Facilities, providers, and vital sign templates
- Appointment Management: Complete appointment lifecycle with scheduling and rescheduling
- Task Management: Complete task lifecycle
- Patient Messaging: Secure portal, SMS, and WhatsApp messaging with conversation threads
- Fax: Send faxes and track delivery status
Quick Start
-
Clone and install dependencies:
git clone https://github.com/CharmHealth/charm-mcp-server.git cd charm-mcp-server uv sync -
Configure environment:
cp .env.example .env # Edit .env with your CharmHealth API credentials -
Run the server:
uv run --directory src mcp_server.py -
Configure your HIPAA-compliant MCP client (e.g., an enterprise/HIPAA-compliant deployment of your chosen client) to connect to the server.
Prerequisites
安装
docker run --rm -i -e CHARMHEALTH_BASE_URL=https://sandbox3.charmtracker.com/api/ehr/v1 -e CHARMHEALTH_API_KEY=your_api_key_here -e CHARMHEALTH_REFRESH_TOKEN=your_refresh_token_here -e CHARMHEALTH_CLIENT_ID=your_client_id_here -e CHARMHEALTH_CLIENT_SECRET=your_client_secret_here -e CHARMHEALTH_REDIRECT_URI=your_redirect_uri_here -e CHARMHEALTH_TOKEN_URL=your_token_url_here charm-mcp-server配置
{
"mcpServers": {
"charm-mcp-server-docker": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"CHARMHEALTH_BASE_URL=https://sandbox3.charmtracker.com/api/ehr/v1",
"-e",
"CHARMHEALTH_API_KEY=your_api_key_here",
"-e",
"CHARMHEALTH_REFRESH_TOKEN=your_refresh_token_here",
"-e",
"CHARMHEALTH_CLIENT_ID=your_client_id_here",
"-e",
"CHARMHEALTH_CLIENT_SECRET=your_client_secret_here",
"-e",
"CHARMHEALTH_REDIRECT_URI=your_redirect_uri_here",
"-e",
"CHARMHEALTH_TOKEN_URL=your_token_url_here",
"charm-mcp-server"
]
}
}
}