langcare-mcp-fhir

LangCare MCP FHIR 服务

面向企业级 FHIR 电子病历系统的 MCP 服务。完全使用 Go 编写，具备企业级安全性，并提供 4 种通用 FHIR 操作，适用于任何 FHIR R4 资源类型。支持 EPIC、Cerner、OpenEMR、GCP Healthcare API 以及任何通用 FHIR R4 服务。

附带 40+ 临床技能库——与 Agent 无关的工作流指南，涵盖药物管理、实验室结果解读、临床决策支持、文档编写、人群健康等。还可扩展使用 ✨ 新功能：Claude Managed Agents（基于 Anthropic Managed Agents API 的 9 个可用于生产环境的临床 AI Agent）、MCP Apps（Claude Desktop 中的交互式临床界面）、医疗保健语音 Agent（基于 FHIR 的实时语音 AI），以及适用于原生不支持 MCP 的 Agent 框架的 LangCare CLI。

langcare.ai

安装

通过 npm 安装：

npm install -g @langcare/langcare-mcp-fhir

也可以不安装，直接使用：

npx @langcare/langcare-mcp-fhir -config /path/to/config.yaml

快速配置

LangCare MCP FHIR 可将 Claude 连接到基于 FHIR 的电子病历系统。你需要一个指向后端的 YAML 配置文件。

1. 获取配置模板

选择你的后端：

• EPIC： config.epic.example.yaml
• Cerner： config.cerner.example.yaml
• OpenEMR： config.openemr.example.yaml
• GCP Healthcare API： config.gcp.example.yaml
• 任意 FHIR R4 服务： config.base.example.yaml

2. 配置 Claude Desktop

将以下内容添加到 Claude Desktop 配置文件（~/.config/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "langcare-mcp-fhir": {
      "command": "langcare-mcp-fhir",
      "args": ["-config", "/path/to/your/config.yaml"]
    }
  }
}

在 macOS 上，配置文件通常位于：

~/Library/Application\ Support/Claude/claude_desktop_config.json

3. 重启 Claude Desktop

关闭并重新打开 Claude Desktop。现在即可使用 FHIR 工具。

需要详细的设置帮助？ 请参阅本地测试指南。

架构

此 MCP 服务充当 AI Agent 与 FHIR R4 服务之间的智能代理。它通过模型上下文协议（MCP）提供 4 种通用 FHIR 操作，从而支持适用于任何 FHIR 资源类型的 AI 工作流。

主要设计：

• MCP SDK： 官方 github.com/modelcontextprotocol/go-sdk（由 Anthropic/Google 维护）
• FHIR 客户端： 可与任何 FHIR R4 服务配合使用的通用 HTTP 客户端
• 传输： stdio 和 Streamable HTTP
• 后端： 代理到现有 FHIR 服务（无数据库）
• 语言： 100% 使用 Go，确保高性能和可靠性

4 种通用 MCP 工具

所有工具均适用于任何 FHIR 资源类型（Patient、Observation、Medication 等）：

1. fhir_read

按类型和 ID 读取 FHIR 资源。

{
  "resourceType": "Patient",
  "id": "example-123"
}

2. fhir_search

使用查询参数搜索 FHIR 资源。

{
  "resourceType": "Patient",
  "queryParams": "name=John&birthdate=gt1990-01-01"
}

3. fhir_create

创建新的 FHIR 资源。

{
  "resourceType": "Observation",
  "resource": {
    "resourceType": "Observation",
    "status": "final",
    "code": { ... },
    "subject": { "reference": "Patient/123" }
  }
}

4. fhir_update

更新现有的 FHIR 资源。

{
  "resourceType": "Patient",
  "id": "example-123",
  "resource": {
    "resourceType": "Patient",
    "id": "example-123",
    "name": [{ "family": "Smith" }]
  }
}

安全架构

LangCare MCP FHIR 为符合 HIPAA 要求的医疗数据访问实现了双层安全模型：

┌─────────────┐         ┌──────────────┐         ┌─────────────┐
│   Claude    │ Auth1   │  MCP Server  │ Auth2   │  FHIR API   │
│   Client    │────────▶│   (Go)       │────────▶│   (EMR)     │
└─────────────┘         └──────────────┘         └─────────────┘

Auth1: MCP Client Authentication (Bearer Token/API Key)
Auth2: FHIR Backend Authentication (Bearer/OAuth2/SMART on FHIR)

安全功能

• ✅ HTTP 传输采用 TLS 1.3 加密
• ✅ 日志中的 PHI 脱敏（默认启用）
• ✅ 符合 HIPAA 要求的审计日志
• ✅ 不持久化存储 PHI（无状态代理）
• ✅ 通过环境变量管理机密（绝不写入配置文件）
• ✅ OAuth 2.0 并自动刷新令牌
• ✅ 支持 mTLS 服务间通信
• ✅ 按客户端进行速率限制

支持的身份验证方式

• Bearer Token — 简单的 API 密钥身份验证
• OAuth2 — 完整的 OAuth2 流程，并支持令牌刷新
• SMART on FHIR Backend Services — 使用 private_key_jwt（RS384），适用于 EPIC、OpenEMR 和其他符合 SMART 标准的 EMR
• SMART on FHIR — 支持 EPIC、Cerner、OpenEMR 和其他 EMR 标准
• Basic Auth — 用户名／密码身份验证
• Custom — 可扩展以支持其他身份验证方式

完整的安全文档请参阅 安全指南：

• HIPAA 合规性检查清单
• EPIC／Cerner／GCP 的 OAuth 配置
• Kubernetes 安全清单
• 凭据管理流程
• 审计日志实现

MCP Apps（交互式 UI）

LangCare MCP FHIR 内置了 MCP Apps — 可直接在 Claude Desktop 等支持 MCP 的主机中运行的交互式丰富 UI 视图。与传统的聊天式工具输出不同，MCP Apps 可呈现完整的 React 界面，包含图表、表格和交互控件，同时使用相同的底层 FHIR 工具。

工作原理： 每个应用都是一个单文件 HTML 包（React + TypeScript，使用 Vite 编译），并通过 go:embed 在编译时嵌入 Go 二进制文件。运行时，MCP 服务会将每个应用注册为 MCP 资源（text/html;profile=mcp-app），并注册一个通过 _meta.ui.resourceUri 关联的专用 MCP 工具。当 MCP 主机调用该工具时，会获取资源并渲染 UI。应用通过 app.callServerTool() 调用服务的通用 FHIR 工具（fhir_search、fhir_read 等），无需通过大模型往返获取数据。

相较于纯工具输出的优势：

• 丰富的可视化效果 — SVG 图表、颜色编码卡片、可展开的详情面板
• 交互控件 — 搜索栏、日期范围选择器、点击展开的行
• 确定性数据获取 — 应用直接调用 FHIR 工具，数据检索不涉及大模型
• 零外部依赖 — 所有内容内联到单个 HTML 文件中，并嵌入二进制文件
• 支持离线运行 — 无 CDN、无外部脚本，除 FHIR API 调用外无需网络请求

内置应用

应用	工具	说明
FHIR Explorer	fhir_explorer	交互式 FHIR 资源浏览器。可搜索、读取、创建和更新任意 FHIR R4 资源类型，并查看 JSON 详情。
Patient Chart Review	patient_chart_review	临床仪表板，显示患者人口统计信息、现有病症、药物、生命体征、实验室检查，以及生命体征趋势图表（血压和体重随时间的变化）。

这两个应用都是 MCP Apps 模式的参考实现。有关架构详情以及如何构建新应用，请参阅 apps/README.md。

患者病历审查在 Claude Desktop 中运行

## Agent 使用

AI Agent 使用 LangCare MCP FHIR Server，通过 4 个 FHIR 工具帮助医疗专业人员访问和管理患者健康记录。该服务负责处理 EMR 身份验证，让 Agent 专注于临床工作流，同时严格遵守隐私和准确性标准。

Agent 能力：

• 搜索、读取、创建、更新 - 任何 FHIR R4 资源（Patient、Observation、Medication 等）
• 患者隐私 - 使用部分标识符，在更新前确认身份
• 临床准确性 - 核实数据，使用标准编码（LOINC、SNOMED、RxNorm）
• 专业沟通 - 组织回复，包含背景、发现和后续步骤

常见工作流：

• 患者查询： 按姓名／出生日期搜索 → 核实身份 → 读取完整详情
• 临床审查： 获取化验结果、生命体征、用药信息 → 附上参考范围进行展示
• 文档记录： 提取结构化数据 → 映射到 FHIR 资源 → 确认 → 创建
• 更新： 核实现有资源 → 修改 → 确认更改 → 更新

系统支持：

• 适用于任何 FHIR R4 资源类型（60 多种类型，包括 DocumentReference、Binary、Media）
• 自动进行身份验证并刷新 EPIC、Cerner、OpenEMR、GCP Healthcare API 的令牌
• 符合 HIPAA 要求的 PHI 处理，并提供审计日志
• 用于访问临床数据的全面 OAuth2 作用域

📖 完整指南： Agent 提示词指南 - 系统提示词、工具示例、工作流和错误处理

临床技能库（可选）

40 多个与 Agent 无关的临床工作流指南，教 AI Agent 如何使用 MCP 服务的 4 个 FHIR 工具（fhir_search、fhir_read、fhir_create、fhir_update）执行复杂的医疗任务。

• 可选 - 不使用这些指南，MCP 服务也能正常工作
• 可移植 - 适用于 Claude、ChatGPT、Gemini 或任何 AI Agent
• 基于证据 - 依据 USPSTF、ADA、ACC/AHA、CDC、ACOG、KDIGO 等学会指南构建
• 可直接复制粘贴 - 将技能的 SKILL.md 添加到 Agent 的系统提示词或自定义指令中

技能分类（40 项技能）

类别	技能数	示例
患者数据与摘要	5	人口统计信息、临床摘要（CCD 风格）、问题列表审查、过敏情况审查、保险覆盖范围
用药管理	5	药物核对、药物相互作用（CYP450）、依从性（MPR/PDC）、Beers 标准、阿片类药物风险（ORT/MME）
化验与诊断	5	化验结果解读、危急值（CAP/CLIA）、术前化验、糖尿病检查面板（ADA）、肾功能（KDIGO）
临床决策支持	5	脓毒症（qSOFA/SOFA）、心血管风险（ASCVD/HEART）、VTE（Wells/Caprini）、跌倒风险（Morse）、肺炎（CURB-65）
护理协调	5	出院计划（LACE）、转诊、护理缺口（USPSTF）、护理过渡（I-PASS）、随访任务
文档记录	5	SOAP 病历、病史与体格检查、病程记录、出院小结、操作记录
人群健康	5	患者群组概览、质量指标（HEDIS）、慢性病登记册、免疫接种状态（CDC）、预防性护理依从情况
专科	5	产前护理（ACOG）、儿科生长发育（WHO/CDC）、心理健康（PHQ-9/GAD-7）、肿瘤学（TNM/RECIST）、慢性疼痛

完整目录及链接： skills/README.md

如何使用技能

1. 浏览 skills/core/ 目录并选择一项技能
2. 复制技能的 SKILL.md 内容到 AI Agent 的系统提示词或自定义指令中
3. 每项技能 references/ 子目录中的参考文件包含详细的临床知识（评分标准、编码表、阈值），可按需添加，以提高临床准确性

# Example: Add medication-reconciliation skill to your agent
skills/core/medication-management/medication-reconciliation/
├── SKILL.md              # Copy this into agent instructions
└── references/
    ├── reconciliation-process.md   # Joint Commission standards
    └── high-risk-medications.md    # ISMP high-alert drug list

集成指南： Claude | ChatGPT | Gemini

欢迎社区贡献 - 请参阅 CONTRIBUTING.md 了解指南。

开发与测试

从源代码构建

make build

在本地运行（stdio 模式）

make run
# or
./bin/langcare-mcp-fhir -config configs/config.local.yaml

在 HTTP 模式下运行（Streamable HTTP）

make run-http
# or
./bin/langcare-mcp-fhir -http -port 8080 -config configs/config.yaml

使用 Streamable HTTP 传输在 /mcp 上启动服务，并在 /health 上提供健康检查。

运行测试

make test

检查代码

make lint

部署到 Fly.io（远程 Streamable HTTP）

将其部署为远程 MCP 服务，使用 Streamable HTTP 传输，可供任何地点的 MCP 兼容 AI Agent 访问。

# Install Fly CLI
brew install flyctl
fly auth login

# Create app
fly apps create --name langcare-mcp-dev

# Set CONFIG_FILE in fly/fly.dev.toml [env] block for your provider (EPIC or GCP)
# Then set secrets (EPIC example):
fly secrets set \
  EPIC_BASE_URL="https://fhir.epic.com/interconnect-fhir-oauth/api/FHIR/R4" \
  EPIC_CLIENT_ID="your-client-id" \
  EPIC_TOKEN_URL="https://fhir.epic.com/interconnect-fhir-oauth/oauth2/token" \
  EPIC_PRIVATE_KEY_B64="$(base64 < keys/epic/private-key.pem)" \
  MCP_AUTH_TOKENS="your-token" \
  --app langcare-mcp-dev

# Deploy
fly deploy -c fly/fly.dev.toml --app langcare-mcp-dev

# Verify
curl https://langcare-mcp-dev.fly.dev/health

将任意 MCP 客户端连接到：

URL:   https://langcare-mcp-dev.fly.dev/mcp
Auth:  Authorization: Bearer your-token

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "langcare-fhir": {
      "url": "https://langcare-mcp-dev.fly.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

支持 EPIC 和 GCP Healthcare API 提供方。有关提供方设置、密钥和完整部署指南，请参阅 fly/README.md。

使用 EPIC 在本地测试

有关设置 EPIC 凭据并在本地测试的分步说明：

📖 本地测试指南

本指南涵盖：

• 生成 RSA 密钥和 JWKS
• 配置 EPIC 凭据
• 在本地运行服务
• 使用 Claude Desktop 测试
• 排查常见问题

快速凭据测试：

# Test your EPIC credentials before running the server
go run test/test_epic_token.go "your-client-id" "/path/to/private-key.pem"

项目结构

langcare-mcp-fhir/
├── cmd/
│   └── server/
│       └── main.go                          # Entry point
├── internal/
│   ├── apps/                                # MCP Apps (embedded UIs)
│   │   ├── embed.go                         # go:embed directive for HTML bundles
│   │   ├── registry.go                      # App metadata, tool names, resource URIs
│   │   └── dist/                            # Built HTML bundles (copied by build)
│   │       ├── fhir-explorer.html           # FHIR Explorer single-file bundle
│   │       └── patient-chart-review.html    # Patient Chart Review single-file bundle
│   ├── audit/
│   │   └── logger.go                        # HIPAA audit logging
│   ├── config/
│   │   └── config.go                        # YAML configuration loading
│   ├── fhir/
│   │   ├── client.go                        # FHIR HTTP client interface
│   │   ├── types.go                         # FHIR client types
│   │   └── providers/                       # Backend implementations
│   │       ├── base.go                      # Base HTTP provider
│   │       ├── epic.go                      # EPIC OAuth2 provider
│   │       ├── cerner.go                    # Cerner OAuth2 provider
│   │       ├── openemr.go                   # OpenEMR SMART Backend Services provider
│   │       └── gcp.go                       # GCP Healthcare API provider
│   ├── mcp/
│   │   └── server.go                        # MCP server + app registration
│   ├── middleware/
│   │   ├── auth.go                          # MCP authentication
│   │   └── rate_limit.go                    # Rate limiting
│   ├── tools/                               # MCP tool implementations
│   │   ├── registry.go                      # Tool registry
│   │   ├── fhir_read.go                     # Read FHIR resource
│   │   ├── fhir_search.go                   # Search FHIR resources
│   │   ├── fhir_create.go                   # Create FHIR resource
│   │   └── fhir_update.go                   # Update FHIR resource
│   └── transport/
│       ├── stdio.go                         # stdio transport (Claude Desktop)
│       └── http.go                          # Streamable HTTP transport (production)
├── apps/                                    # MCP App source code (React + TypeScript)
│   ├── README.md                            # App development guide
│   ├── package.json                         # Shared dependencies (React 19, MCP Apps SDK)
│   ├── vite.config.ts                       # Vite build config (single-file output)
│   ├── tsconfig.json                        # TypeScript config
│   ├── fhir-explorer/                       # FHIR Explorer app
│   │   ├── index.html
│   │   └── src/
│   │       ├── app.tsx
│   │       └── global.css
│   └── patient-chart-review/                # Patient Chart Review app
│       ├── index.html
│       └── src/
│           ├── app.tsx
│           └── global.css
├── scripts/
│   ├── build-apps.sh                        # Build all apps → internal/apps/dist/
│   ├── create_jwks.sh                       # Generate JWKS from public key (EPIC)
│   └── create_jwks_openemr.sh               # Generate JWKS from public key (OpenEMR)
├── pkg/
│   └── types/
│       └── errors.go                        # Custom error types
├── configs/
│   ├── config.epic.example.yaml             # Example configuration for EPIC
│   ├── config.cerner.example.yaml           # Example configuration for Cerner
│   ├── config.openemr.example.yaml          # Example configuration for OpenEMR
│   ├── config.gcp.example.yaml              # Example configuration for GCP
│   └── config.base.example.yaml             # Example configuration for any FHIR R4 server
├── docs/
│   ├── AGENT_PROMPT.md                      # AI agent system prompt
│   ├── EPIC-APP-SECURITY.md                 # EPIC authentication setup
│   ├── OPENEMR-APP-SECURITY.md              # OpenEMR SMART Backend Services setup
│   ├── EPIC-SCOPES.md                       # OAuth2 scopes reference
│   ├── LOCAL-TESTING.md                     # Local development guide
│   └── SECURITY.md                          # Production security guide
├── test/
│   ├── README.md                            # Test documentation
│   └── test_epic_token.go                   # EPIC OAuth2 token tester
├── fly/
│   ├── Dockerfile                           # Multi-stage Go build for Fly.io
│   ├── docker-entrypoint.sh                 # Key materialization + server startup
│   ├── fly.dev.toml                         # Fly.io dev deployment config
│   ├── config.fly.epic.yaml                 # Fly.io EPIC provider config
│   ├── config.fly.gcp.yaml                  # Fly.io GCP provider config
│   └── README.md                            # Fly.io deployment guide
├── bin/                                     # Build output (gitignored)
│   └── langcare-mcp-fhir                    # Compiled binary
├── go.mod                                   # Go module definition
├── go.sum                                   # Go module checksums
├── Makefile                                 # Build commands
└── README.md                                # This file

注意： 以下内容已加入 gitignore，不会提交：

• keys/ - 私钥和凭据
• config.local.*.yaml - 本地配置文件
• bin/ - 编译后的二进制文件
• .env - 环境变量
• apps/node_modules/、apps/dist/、apps/dist-tmp/ - 应用构建产物

Healthcare Voice Agent

实时语音 AI，让患者能够询问自己的健康记录，并获得直接从其 EMR 中提取信息后生成的语音回答。

技术栈：PipeCat（开源，Daily.co）用于语音流水线——STT、LLM 编排和 TTS，延迟低于 3 秒。Claude 用于临床推理和工具调用。LangCare MCP FHIR Server（开源，Go）作为无状态代理，连接任意 FHIR R4 EMR——Epic、Cerner、GCP Healthcare API。

**MCP 是连接纽带。**PipeCat 的原生 MCP 客户端会在启动时自动发现 FHIR 工具。患者询问“我正在服用哪些药物？”——Claude 调用 fhir_search——PipeCat 将请求转发到 MCP 服务——数据返回——Claude 以自然语音作答。无需手动定义工具架构。

**三层 HIPAA 身份验证：**在会话开始前验证呼叫者身份，使用 bearer token 连接 MCP，并通过 OAuth2/SMART on FHIR 连接 EMR。零 PHI 存储。

**所有组件均可替换。**可将 Claude 替换为 Gemini、将 DeepGram 替换为 Google STT、将 Daily 替换为 WebSocket。MCP FHIR 层和临床提示词保持不变。

完整文档和设置指南

LangCare CLI

命令行界面，通过 HTTP 将 4 个 FHIR MCP 工具（fhir_search、fhir_read、fhir_create、fhir_update）封装为 CLI 子命令。适用于原生不支持 MCP 的 AI Agent 框架——LangChain、smolagents、CrewAI、AutoGen，以及任何能够调用子进程的框架。CLI 会在内部处理 MCP 会话握手，因此 Agent 可直接从 stdout 获取干净的 JSON，无需了解协议。

# Install
pip install "langcare-cli @ git+https://github.com/langcare/langcare-mcp-fhir.git#subdirectory=cli"

# Use
langcare fhir search Patient --query "name=John"
langcare fhir read Patient 123
langcare fhir create Observation --data @obs.json
langcare fhir update Patient 123 --data @patient.json

Skills Library 中的 40 多个临床技能可直接使用——技能引用的是抽象工具名称，而非传输方式。将 CLI 注册为 Agent 框架中的子进程工具，即可运行技能，无需修改。

完整文档和设置指南

文档

入门

• 📖 本地开发与测试指南 - 本地设置和测试完整指南
• 🚀 安装与配置 - 上方的快速设置指南

Agent 集成

• 🤖 Agent 提示词指南 - LangCare MCP FHIR 的 AI Agent 完整使用指南（工具示例、工作流、最佳实践）

安全与身份验证

• 🛡️ 安全文档 - 完整的安全架构与 HIPAA 合规说明
• 🔐 EPIC 设置指南 - JWT 身份验证、密钥生成和 JWKS 注册
• 🔐 OpenEMR 设置指南 - SMART on FHIR Backend Services（private_key_jwt/RS384）设置、JWKS 生成和 OpenEMR API 客户端注册
• 📋 EPIC Scopes 参考 - FHIR 资源的完整 OAuth2 Scopes 指南
• 🔑 身份验证方法 - 支持的身份验证方法

部署

• Fly.io 部署指南 - 远程 Streamable HTTP 部署、提供商配置、密钥、Docker

开发与测试

• 🧪 测试方法 - Claude Desktop、MCP Inspector、手动测试和自动化
• 📦 项目结构 - 目录布局与架构
• 🔧 构建命令 - 开发工作流

依赖项

• github.com/modelcontextprotocol/go-sdk - 官方 MCP SDK
• gopkg.in/yaml.v3 - 配置解析
• golang.org/x/oauth2 - OAuth2 客户端库
• github.com/golang-jwt/jwt/v5 - JWT 签名与验证
• Go 1.25+

HIPAA 合规性

• 默认启用 PHI 清理
• 从不记录患者标识符
• 支持 HTTP 传输的 TLS
• 适当的错误清理
• 支持审计日志
• 无状态代理设计（无持久存储）

测试

公共测试服务

默认配置使用 HAPI FHIR 公共测试服务（https://hapi.fhir.org/baseR4），无需设置即可立即测试。

测试你的设置

• 📖 本地开发与测试指南 - 设置、使用 Claude Desktop 测试、MCP Inspector 和自动化的完整指南
• 🔐 EPIC 安全设置 - 详细的 EPIC 身份验证指南
• 🛡️ 安全文档 - 生产部署与安全

Claude Managed Agents

9 个可投入生产的临床 AI Agent，基于 Anthropic Managed Agents API 构建。每个 Agent 都连接到 LangCare MCP FHIR Server，并使用从 40+ Clinical Skills Library 中精选的一组特定领域临床技能。会话会持久保存，可在 platform.claude.com/workspaces/default/sessions 查看，并可通过交互方式运行，也可由单条提示词驱动。

Agent	领域
Medication Management	用药核对、药物相互作用、Beers Criteria、阿片类药物风险、用药依从性
Care Coordination	出院计划、转诊、护理缺口、护理过渡、随访任务
Clinical Decision Support	脓毒症 qSOFA、心血管风险、VTE、跌倒风险、CURB-65
Clinical Triage	临床摘要、病情严重程度、生命体征审查、脓毒症指标
Documentation	SOAP 记录、H&P、病程记录、出院摘要、操作记录
Lab & Diagnostics	危急值、糖尿病检验面板、检验结果解读、术前检验、肾功能
Patient Data	人口统计信息、过敏审查、临床摘要、保险承保范围、问题清单
Population Health	慢性病登记、免疫接种状态、预防保健、质量指标
Specialty Care	慢性疼痛、心理健康、肿瘤学、儿童生长、产前保健

快速入门

# 1. Set environment variables
export ANTHROPIC_API_KEY=sk-ant-...
export LANGCARE_MCP_URL=https://langcare-mcp-dev.fly.dev/mcp
export LANGCARE_MCP_TOKEN=your-bearer-token

# 2. Upload skills, create environment + vault, deploy all 9 agents
cd cma/scripts
./setup.sh dev

# 3. Run a session
./run-session.sh <agent-id> <env-id> <vault-id> "Show active medications for patient ID d886a934-5568-42b3-9324-0f0b05fc018c"

setup.sh 具有幂等性，可安全地重复运行。运行结束时会打印会话所需的 Environment ID 和 Vault ID。

完整指南： cma/README.md — 环境变量、所有脚本参考和故障排除。

---

贡献

我们欢迎医疗专业人员、开发者和医学信息学人员参与贡献！

主要有以下三种贡献方式：

1. 核心 MCP 服务（Go 开发）

• 修复错误并提升性能
• 实现新的 FHIR 提供方（AllScripts、Athenahealth 等）
• 增强安全性和可观测性
• 改进测试和 CI/CD

2. 临床技能（医疗工作流）

• 使用 FHIR 的循证临床工作流
• 专科特定方案（心脏病学、肿瘤学等）
• 人群健康和质量指标工作流
• 临床决策支持算法

技能是与 Agent 无关的工作流指南，可用于 Claude、ChatGPT 和 Gemini。无需编写代码，只需具备临床专业知识和 FHIR 知识！

3. MCP Apps（交互式 UI）

• 新的临床或管理类 UI 应用
• 改进现有应用（FHIR Explorer、Patient Chart Review）
• 面向医疗 UI 的可复用组件和模式

开发指南请参阅 apps/README.md。

4. Agent 集成（平台设置）

• 新 AI 平台的设置指南
• 部署示例（Docker、Kubernetes、云平台）
• 监控和可观测性设置
• CI/CD 流水线

开始参与： 阅读 CONTRIBUTING.md，了解详细指南、代码规范和提交流程。

贡献者认可： 贡献者将在 README、发行说明以及技能／集成作者名单中得到署名。杰出的贡献者可能会受邀成为维护者。

有问题？ 欢迎发起 GitHub Discussion 或提交 issue！

社区

• GitHub 讨论区 - 提问、分享想法：https://github.com/langcare/langcare-mcp-fhir/discussions
• GitHub Issues - 报告错误、申请功能：https://github.com/langcare/langcare-mcp-fhir/issues
• 贡献指南 - 如何参与贡献：https://github.com/langcare/langcare-mcp-fhir/blob/main/CONTRIBUTING.md
• 技能 - 临床工作流：https://github.com/langcare/langcare-mcp-fhir/blob/main/skills/README.md

许可证

请参阅 LICENSE 文件。

---

由 LangCare 团队和贡献者倾心打造。

通过更好的 AI 基础设施改善医疗保健。