内容
# K01 MCP 服务器
[](LICENSE)
[](https://modelcontextprotocol.io)
直接在AI工作流中生成和查询临床真实的合成健康数据。
---
K01的MCP服务器为AI代理和LLM驱动的工具提供隐私保护的合成健康数据生成服务。生成符合FHIR标准的患者群体，查询结构化的EHR数据，并在FHIR版本之间进行比较 — 所有这些都具有内置的差分隐私保护。整个过程中不涉及任何真实的患者数据。
> 本仓库包含K01 MCP服务器的文档和配置。服务器实现为专有技术，在K01的基础设施上运行。
## 可用工具
| 工具 | 描述 | 关键参数 |
|------|-------------|----------------|
| `generate_synthetic_cohort` | 生成具有人口统计学和临床约束的合成患者群体 | `count`, `age_min`/`age_max`, `gender`, `condition` (ICD-10), `seed`, `locale` |
| `search_patients` | 使用高级医疗过滤器搜索虚拟患者数据库 | `gender`, `birthdate`, `numberOfMedicinesFrom`/`To`, `conditionTypes`, `locale` |
| `get_patient_record` | 检索完整的患者记录，包括药物和病情摘要 | `patient_id`, `fhir_version` |
| `get_patient_medications` | 获取详细的药物记录，包括ATC代码和治疗适应症 | `patient_id`, `seed`, `fhir_version` |
| `get_patient_conditions` | 检索患者的病情记录，包括ICD-10代码和本地化名称 | `patient_id`, `seed`, `fhir_version` |
| `compare_fhir_versions` | 比较同一患者数据在FHIR R4和R5之间的差异 | `patient_id`, `resource_type` |
所有工具都支持FHIR R4和R5。有关完整的参数文档，请参见 [docs/tools.md](docs/tools.md)。
## 快速入门
### Claude Desktop
将以下配置添加到Claude Desktop配置中（`Settings > MCP Servers`）：
```json
{
"mcpServers": {
"k01": {
"url": "https://mcp.k01.is/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
### Cursor
将以下配置添加到Cursor MCP配置中（`.cursor/mcp.json`）：
```json
{
"mcpServers": {
"k01": {
"url": "https://mcp.k01.is/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
```
在添加配置后重启应用程序。K01工具将出现在工具列表中。
## 身份验证
K01 MCP服务器使用Bearer令牌身份验证。在`Authorization`头部包含您的API密钥。
要获取API密钥，请联系K01，网址为 [k01.is](https://k01.is)。自助密钥供应即将推出。
有关详细信息，请参见 [docs/authentication.md](docs/authentication.md)。
## 示例
### 生成糖尿病群体
> "生成100名年龄在40-65岁之间，患有2型糖尿病的患者"
`generate_synthetic_cohort`工具创建一个包含Patient、Condition、MedicationStatement、Procedure和Observation资源的FHIR Bundle：
```
generate_synthetic_cohort(count=100, age_min=40, age_max=65, condition="E11.9", seed=42)
```
### 搜索复杂患者
> "查找具有3种以上药物和慢性病患者的患者"
```
search_patients(numberOfMedicinesFrom=3, conditionTypes="chronic", _count=20)
```
### 比较FHIR版本
> "患者的药物在R4和R5中是什么样的？"
```
compare_fhir_versions(patient_id="0101302989", resource_type="Medication")
```
有关更多工作流程，请参见 [docs/examples.md](docs/examples.md)。
## 隐私和安全
K01生成的所有数据都是完全合成的。在整个流程中，不使用、存储或引用任何真实的患者数据。
- **差分隐私** — 噪声注入和可配置的epsilon值确保生成的分布不能被反向工程以识别真实个体
- **不使用真实数据训练** — 生成模型基于已发布的临床统计数据和药理学参考资料，而不是患者记录
- **符合FHIR标准的输出** — 所有资源都符合HL7 FHIR R4/R5规范，使其成为开发和测试中真实数据的安全替代品
- **确定性种子** — 使用种子获取可复制的结果，而无需在服务器端保留任何患者数据
## 链接
- [K01 网站](https://k01.is)
- [API 文档](https://k01.is/docs)
- [工具参考](docs/tools.md)
- [身份验证指南](docs/authentication.md)
- [使用示例](docs/examples.md)
- [FAQ](docs/faq.md)
- [MCP 协议](https://modelcontextprotocol.io)
## 许可证
本仓库（文档、配置和示例）根据 [MIT](LICENSE) 许可证授权。K01服务器实现为专有技术。
