@fhirfly io/mcp服务器
MCP(模型上下文协议)服务器,用于将Claude Desktop连接到 飞机 医疗保健参考数据API。
这是什么?
此软件包允许Claude Desktop查找真实的医疗保健参考数据,包括:
- 国家药品编码 -药品和包装(美国食品药品监督管理局)
- 负极性项目 -医疗保健提供者标识符(CMS)
- RxNorm -药物术语(NLM)
- 腰部 -实验室代码(Regenstrief研究所)
- ICD-10 -诊断和程序代码(CMS)
- CVX/MVX -疫苗代码(美国疾病控制与预防中心)
- 美国食品药品监督管理局药品标签 -处方信息
- SNOMED CT -临床概念(IPS自由设置)
- 肝细胞癌 -CMS分层条件类别风险调整映射
- OPCS-4 -英国国家医疗服务体系程序分类代码
- dm+d -英国药品和器械词典(NHS)
- 计量单位统一代码 -统一计量单位代码(NLM)
- Rx类 -药物分类层次结构(NLM)
- 程序编码系统 -二级程序和供应规范(CMS)
- MS-DRG -住院费用诊断相关组(CMS)
- 销售点 -索赔提交的服务地点代码(CMS)
- J-Code/NDC人行横道 -双向HCPCS J代码到NDC映射(CMS)
- DDI参考 --来自FDA标签的药物相互作用文本+RxNorm富集
- 连接性 -提供程序Contoso端点和直接地址
- 脊髓性肌萎缩症 -州医疗补助局(CMS)
- 索赔情报 -NCCI编辑、MUE限值、PFS/RVU数据、覆盖率确定
当你向克劳德询问药物、提供者或临床代码时,它可以查找准确、最新的信息,而不是依赖培训数据。
先决条件
- 克劳德桌面 -下载自 claude.ai/下载
- Node.js 18+ -下载自
- FHIRfly API密钥 -得到一个在 fhirfly.io (免费版可用)
快速设置
步骤1:获取FHIRfly API密钥
- 首选 fhirfly.io 并注册
- 导航至 仪表板>凭据
- 点击 创建凭据 并选择 MCP(克劳德桌面)
- 复制API密钥(以开头
ffly_)
步骤2:配置Claude桌面
查找您的Claude Desktop配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
添加FHIRfly服务器配置:
{
"mcpServers": {
"fhirfly": {
"command": "npx",
"args": ["-y", "@fhirfly-io/mcp-server"],
"env": {
"FHIRFLY_API_KEY": "ffly_live_your_key_here"
}
}
}
}替换 ffly_live_your_key_here 使用您的实际API密钥。
步骤3:重新启动克劳德桌面
完全退出Claude Desktop并重新打开它。FHIRfly工具现在应该可用了。
验证它是否有效
试着问克劳德:
- “什么是NDC 0069-0151-01?”
- “查找NPI 1234567893”
- “在CVX数据库中搜索新冠疫苗”
- “立普妥的药物相互作用是什么?”
- “哪些州已经实施了医疗补助的Contoso端点?”
- “向我展示加州医疗补助计划的Contoso端点详细信息”
- “每分升毫克的UCUM代码是什么?”
- “将100毫克转换为克”
- “HMG-CoA还原酶抑制剂类中有哪些药物?”
- “检查阿司匹林和华法林之间的相互作用”
Claude应该使用FHIRfly工具查找真实数据。
可用工具
| 工具 | 说明 |
|---|---|
ndc_get | 通过NDC代码查找药物 |
ndc_search | 按名称、成分等搜索药物。 |
npi_get | 按NPI编号查找提供商 |
npi_search | 按名称、专业、位置搜索提供商 |
rxnorm_get | 通过RxCUI查找药物 |
rxnorm_search | 搜索药物术语 |
loinc_get | 通过LOINC代码查找实验室测试 |
loinc_search | 搜索实验室代码 |
icd10_get | 查找诊断/程序代码 |
icd10_search | 搜索ICD-10代码 |
cvx_get | 通过CVX代码查找疫苗 |
cvx_search | 搜索疫苗代码 |
mvx_get | 查找疫苗制造商 |
mvx_search | 搜索制造商 |
fda_label_lookup | 查看FDA药品标签 |
fda_label_search | 搜索药品标签 |
fda_label_safety | 获取安全信息(盒装警告、禁忌症) |
fda_label_interactions | 获取药物相互作用信息 |
fda_label_dosing | 获取剂量信息 |
fda_label_sections | 获取特定标签部分 |
snomed_get | 通过SNOMED CT ID查找临床概念 |
snomed_search | 搜索SNOMED CT IPS概念 |
snomed_mappings | 查找SNOMED概念的跨术语映射 |
npi_connectivity | 查找提供商连接(Contoso端点) |
sma_list_states | 列出具有Medicaid Contoso端点状态的州 |
sma_get_state | 获取某个州的SMA Contoso端点详细信息 |
sma_stats | 获取SMA实施的汇总统计数据 |
ncci_validate | 检查两个代码是否可以一起计费(NCCI) |
mue_lookup | 查找最大服务单位(MUE限制) |
pfs_lookup | 查找医疗保险费用表/RVU数据 |
coverage_check | 检查LCD/NCD覆盖范围确定 |
| HCPCS/MS-DRG/POS/J-Code工具 | |
hcpcs_get | 查找HCPCS二级程序/供应代码 |
hcpcs_modifier_get | 查找HCPCS修改器代码 |
hcpcs_search | 搜索HCPCS二级代码 |
msdrg_get | 查找MS-DRG代码 |
msdrg_search | 搜索MS-DRG代码 |
pos_get | 查找服务地点代码 |
jcode_by_hcpcs | 查找映射到J代码/HCCS代码的NDC |
jcode_by_ndc | 查找映射到NDC的HCPCS代码 |
| HCC/OPCS-4工具 | |
hcc_get | 查找ICD-10代码的HCC风险调整映射 |
hcc_reverse | 查找映射到给定HCC类别的所有ICD-10代码 |
hcc_search | 按代码、型号或类别搜索HCC人行横道 |
opcs4_get | 查找OPCS-4英国NHS程序代码 |
opcs4_search | 搜索OPCS-4程序代码 |
| dm+d工具 | |
dmd_get | 通过SNOMED代码查找英国dm+d药品/设备 |
dmd_search | 搜索英国dm+d药品和器械 |
| UCUM工具 | |
ucum_get | 查找UCUM单位代码(例如mg、mL、kg/m2) |
ucum_search | 按名称或描述搜索度量单位 |
ucum_validate | 验证UCUM表达式的正确性 |
ucum_convert | 在兼容的UCUM单位之间转换值 |
| RxClass工具 | |
rxclass_get | 按类别ID查找药物类别 |
rxclass_search | 按名称或类型搜索药物分类 |
rxclass_members | 列出属于某一药物类别的药物 |
| DDI工具 | |
check_drug_interactions | 检查多种药物的药物相互作用(FDA标签文本+RxNorm) |
| 批处理工具 | |
ndc_batch | 查找多个NDC代码(最多500个) |
npi_batch | 查找多个NPI编号(最多100个) |
icd10_batch | 查找多个ICD-10代码(最多100个) |
rxnorm_batch | 查找多个RxCUI(最多100个) |
loinc_batch | 查找多个LOINC代码(最多100个) |
cvx_batch | 查找多个CVX代码(最多100个) |
mvx_batch | 查找多个MVX代码(最多100个) |
fda_label_batch | 查找多个FDA标签(最多50个) |
配置选项
| 环境变量 | 描述 | 默认值 |
|---|---|---|
FHIRFLY_API_KEY | 您的FHIRfly API密钥(必需) | - |
FHIRFLY_API_URL | API基本URL | https://api.fhirfly.io |
FHIRFLY_DEBUG | 启用调试日志记录(1 或 true) | false |
FHIRFLY_TIMEOUT | 获取超时(毫秒) | 30000 |
故障排除
“需要FHIRFLY_API_KEY环境变量”
您的API密钥未配置。确保:
- 您具有来自的有效API密钥 fhirfly.io
- 它设置在
envClaude桌面配置的一部分 - 关键在于
ffly_
“API密钥格式无效”
FHIRfly API密钥从 ffly_。检查您是否复制了完整密钥。
“身份验证失败”
您的API密钥可能无效或已过期。生成一个新的 fhirfly.io/仪表板/凭证.
Claude未展示FHIRfly工具
- 确保您完全退出并重新启动了Claude Desktop
- 检查配置文件语法(必须是有效的JSON)
- 启用调试模式以查看发生了什么:
{
"mcpServers": {
"fhirfly": {
"command": "npx",
"args": ["-y", "@fhirfly-io/mcp-server"],
"env": {
"FHIRFLY_API_KEY": "your_key",
"FHIRFLY_DEBUG": "1"
}
}
}
}“超出费率限制”
你已达到计划的费率上限。请稍等,再试一次,或在以下网址升级您的计划 fhirfly.io.
运作原理
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Claude Desktop │────▶│ This Package │────▶│ FHIRfly API │
│ │ │ (runs locally) │ │ (cloud) │
│ "What is │◀────│ │◀────│ │
│ NDC 123..." │ │ Translates MCP │ │ Returns drug │
│ │ │ ↔ HTTPS │ │ data │
└─────────────────┘ └─────────────────┘ └─────────────────┘该软件包在您的计算机上运行,作为Claude Desktop和FHIRfly API之间的桥梁。它
- 通过stdin接收来自Claude Desktop的请求
- 将它们转换为对FHIRfly的HTTPS请求
- 通过stdout将结果返回给Claude
您的API密钥通过HTTPS发送到FHIRfly。没有医疗保健数据存储在本地。
链接
数据来源和许可
| 数据源 | 提供者 | 许可证 |
|---|---|---|
| NDC目录 | 美国食品药品监督管理局 | 公共领域 |
| NPPES(NPI) | CMS | 公共领域 |
| RxNorm | NLM(NIH) | UMLS许可证(免费) |
| LOINC | Regenstrief研究所 | 免费归因 |
| ICD-10-CM/PCS | CMS | 公共领域 |
| CVX/MVX | 疾病控制与预防中心 | 公共领域 |
| 美国食品药品监督管理局药品标签 | FDA/openFDA | 公共领域 |
| SNOMED CT IPS | SNOMED国际 | CC BY 4.0 |
| HCC Crosswalk | CMS | 公共领域 |
| OPCS-4 | 英国国家医疗服务体系 | OGL v3.0(官方版权) |
| dm+d | 英国国家医疗服务体系/NHSBSA | OGL v3.0(官方版权) |
| UCUM | NLM(NIH)/Regenstrief研究所 | 免费归因 |
| RxClass | NLM(NIH) | UMLS许可证(免费) |
| SMA端点目录 | CMS | 公共域 |
| HCPCS二级 | CMS | 公共领域 |
| MS-DRG | CMS | 公共领域 |
| 服务地点 | CMS | 公共领域 |
| J-Code/NDC Crosswalk | CMS | 公共领域 |
| NCCI/MUE/PFS | CMS | 公共领域 |
| DDI参考 | FDA+NLM | 公共领域 |
FHIRfly汇总并索引这些数据源。看 Fhirfly.i/docs 了解详情。
更新日志
看 更改日志.md 发布历史。
许可证
麻省理工学院-见 许可证
