🏥 医疗账单MCP
AI助手的开源计费知识
  ](docker/) 
______________________________________________________________________
问题: 计费人员收到拒绝代码。他们用谷歌搜索,阅读5篇文章,打电话给付款人,等待45分钟,也许会得到答案。费用:每次拒绝30-60分钟。 解决方案: 问一个AI助手。通过解决步骤获得即时答案。费用:2分钟。
______________________________________________________________________
这是什么?
一 MCP(模型上下文协议) 为Claude等AI助手提供医疗计费知识的服务器:
| 工具 | 它做什么 |
|---|---|
lookup_icd10 | 查找诊断代码 |
lookup_cpt | 查找程序代码 |
lookup_modifier | 了解何时使用修饰符(25、59等) |
lookup_denial | 了解拒绝代码+如何修复它们 |
lookup_payer | 获取付款人特定规则(及时归档等) |
lookup_bundling | 检查代码是否捆绑在一起 |
这是一个知识层。 您带来自己的付款人连接(Stedi、Availity、Change Healthcare等)。
______________________________________________________________________
快速开始
选项1:Docker(推荐)
# Clone the repo
git clone https://github.com/Kustode-ce/medical-billing-mcp.git
cd medical-billing-mcp
# Run with Docker
docker compose up -d
# Test it
docker compose exec mcp python -m medical_billing_mcp --test选项2:本地安装
# Clone and install
git clone https://github.com/Kustode-ce/medical-billing-mcp.git
cd medical-billing-mcp
pip install -e .
# Run the server
python -m medical_billing_mcp配置Claude桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"medical-billing": {
"command": "python",
"args": ["-m", "medical_billing_mcp"]
}
}
}配置位置:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
重新启动克劳德桌面。
______________________________________________________________________
使用示例
安装后,向Claude提出以下问题:
理解代码
“ICD-10代码E11.9是什么意思?”
“什么是CPT代码99214,我需要什么文件?”
“我什么时候应该使用修饰符25?”
解决拒绝
“我收到了拒绝代码CO-50。它是什么意思,我该如何修复它?"
“我的索赔因‘没有医疗必要’而被驳回。解决步骤是什么?”
付款人规则
“医疗保险的及时申报限额是多少?”
“Blue Cross MA已知的计费问题是什么?”
捆绑
“CPT代码99213和36415是否捆绑在一起?”
看 文档/示例/ 用于示例对话。
______________________________________________________________________
建筑
┌─────────────────────────────────────────────────────────────────┐
│ AI ASSISTANT (Claude) │
└─────────────────────────────────────────────────────────────────┘
│
│ MCP Protocol
▼
┌─────────────────────────────────────────────────────────────────┐
│ MEDICAL BILLING MCP │
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ server.py │ │
│ │ (Tool definitions + routing) │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ handlers.py │ │
│ │ (Lookup functions) │ │
│ └──────────────────────────────────────────────────────────┘ │
│ │ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ data/ │ │
│ │ │ │
│ │ icd10.json cpt.json modifiers.json │ │
│ │ denials.json payers.json bundling.json │ │
│ │ │ │
│ │ [Community contributes here] │ │
│ └──────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────────┘看 建筑.md 详细的设计文档。
______________________________________________________________________
这不是什么
| 不在范围内 | 为什么 | 你已经有了 |
|---|---|---|
| 索赔提交 | 不是我们的工作 | Stedi,可用性 |
| 资格检查 | 实时付款人数据 | Stedi,付款人门户 |
| 先前身份验证提交 | 付款人集成 | Cohere,eviCore |
| EOB/ERA解析 | 票据交换所功能 | Stedi,票据交换所 |
| PHI存储 | 安全性/合规性 | 您的EHR/PMS |
我们提供知识。您提供连接。
______________________________________________________________________
数据源
所有数据均来自公共来源:
| 数据 | 来源 |
|---|---|
| ICD-10编码 | CMS |
| CPT描述 | AMA(有限-完全需要许可证) |
| HCPCS代码 | CMS |
| 拒绝代码(CARC/RARC) | X12/华盛顿出版 |
| 付款人规则 | 公共付款人手册 |
______________________________________________________________________
贡献
我们欢迎捐款!最简单的帮助方式:
添加付款人规则
知道付款人的怪癖吗?编辑 data/payers.json:
{
"bcbs_tx": {
"name": "Blue Cross Blue Shield Texas",
"timely_filing_days": 95,
"known_issues": ["Requires modifier 25 documentation"]
}
}添加拒绝解决步骤
修复了一个棘手的否认?分享如何 data/denials.json:
{
"CO-151": {
"description": "Service not covered",
"resolution_steps": [
"Check if service requires prior auth",
"Verify correct place of service code",
"Appeal with medical necessity documentation"
]
}
}看 贡献.md 获取完整指南。
______________________________________________________________________
项目结构
medical-billing-mcp/
├── src/medical_billing_mcp/
│ ├── __init__.py
│ ├── __main__.py
│ ├── server.py # MCP server
│ ├── handlers.py # Lookup functions
│ └── data/ # JSON knowledge base
│ ├── icd10.json
│ ├── cpt.json
│ ├── modifiers.json
│ ├── denials.json
│ ├── payers.json
│ └── bundling.json
├── tests/
├── docs/
│ ├── diagrams/ # Architecture diagrams
│ ├── api/ # API documentation
│ └── examples/ # Usage examples
├── docker/
│ ├── Dockerfile
│ └── docker-compose.yml
├── ARCHITECTURE.md
├── CONTRIBUTING.md
├── LICENSE
└── README.md______________________________________________________________________
许可证
MIT许可证-请参阅 许可证
注: CPT代码的版权归AMA所有。此工具出于教育目的提供了有限的描述。要获得完整的CPT数据,请获得AMA许可证。
______________________________________________________________________
支持
- 🐛 问题:
- 💬 讨论:
______________________________________________________________________
专为医疗保健行业打造 ❤️
*因为医疗服务提供者应该花时间与患者相处,而不是与保险公司对抗。*
