使用说明
🏥 医疗账单MCP
AI助手的开源计费知识
问题： 计费人员收到拒绝代码。他们用谷歌搜索，阅读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许可证。
支持
专为医疗保健行业打造 ❤️
因为医疗服务提供者应该花时间与患者相处，而不是与保险公司对抗。
