AI导哈

医疗收入周期管理API

一个基于Node.js的医疗收入周期管理（RCM）服务器，实现模型上下文协议（MCP），为React前端和AI代理提供双重接口，支持索赔状态跟踪、拒付管理和合规性功能。

  • by keerthirajrr
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 keerthirajrr/rcm-mcp-server

使用说明

医疗RCM MCP服务器API

一个全面的Node.js服务器，实现了用于医疗保健收入周期管理（RCM）的模型上下文协议（MCP），为React前端和AI代理提供服务。

🏗️ 建筑

React Frontend  →  Node.js MCP Server API  →  Adapters (EHR / DB / Clearinghouse / Payer APIs)
                                    ↘  MCP Tool Interface (Model Context Protocol)

✨ 特性

核心RCM功能

  • 索赔状态跟踪：来自EHR/清算所的实时索赔状态
  • 拒绝管理：全面的拒绝分析和根本原因分析
  • 吸引力生成：人工智能驱动的上诉信生成
  • CPT/ICD验证：带有警告的代码组合验证
  • HIPAA 合规：内置PHI编辑和审计日志

MCP集成

  • 双接口：人工智能代理React+MCP的REST API
  • 基于工具的体系结构：用于特定RCM任务的模块化MCP工具
  • 上下文感知：基于身份验证和权限的数据访问
  • 可扩展：易于添加新工具和适配器

安全与合规

  • JWT身份验证：基于角色的访问控制
  • PHI补救措施：自动敏感数据编辑
  • 审计日志：符合HIPAA的审计跟踪
  • 速率限制：DDoS保护
  • 输入验证：全面的请求验证

🚀 快速开始

1.安装

npm install

2.环境设置

cp .env.example .env
# Edit .env with your configuration

3.发展

npm run dev

服务器将于启动 http://localhost:4000

4.测试身份验证

# Login as admin
curl -X POST http://localhost:4000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "admin", "password": "admin123"}'

# Use the returned token for subsequent requests
export TOKEN="your-jwt-token-here"

📚 API文档

REST端点（用于React前端）

认证

  • POST /api/auth/login -用户登录
  • POST /api/auth/validate -令牌验证

索赔管理

  • GET /api/claims -搜索索赔
  • GET /api/claims/:id -获取具体索赔状态

拒绝分析

  • GET /api/denials -通过过滤列出拒绝
  • GET /api/denials/:id/analyze -根本原因分析

申诉管理

  • POST /api/appeals/generate -生成上诉信

MCP接口（用于AI代理）

工具发现

curl -X POST http://localhost:4000/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"method": "list_tools"}'

工具执行

curl -X POST http://localhost:4000/mcp \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "call_tool",
    "params": {
      "name": "list_denials",
      "arguments": {
        "category": "authorization",
        "limit": 10
      }
    }
  }'

🛠️ 可用的MCP工具

工具 说明 所需范围
get_claim_status 获取索赔状态和历史记录 rcm.claim.read
list_denials 使用分析查询拒绝 rcm.denial.read
validate_cpt_combo 验证CPT/ICD组合 rcm.claim.read
analyze_denial_root_cause 基于人工智能的拒绝分析 rcm.denial.read
generate_appeal_letter 创建上诉信 rcm.appeal.write

🔐 身份验证和授权

用户角色

  • 管理员：完全访问所有功能
  • 账单管理器：索赔、拒绝、上诉管理
  • 图像：阅读索赔/拒绝、基本操作
  • 只读：仅查看报告的访问权限

默认测试用户

  • 用户名： admin，密码： admin123
  • 用户名： billing_manager，密码： billing123

示波器系统

细粒度权限：

  • rcm.claim.read/write -索赔操作
  • rcm.denial.read/write -拒绝操作
  • rcm.appeal.read/write -上诉行动
  • rcm.patient.read -患者数据访问
  • rcm.analytics.read -分析访问

🏥 医疗保健合规

HIPAA 功能

  • PHI补救措施：自动敏感数据屏蔽
  • 审计日志：完成活动跟踪
  • 访问控制：基于角色的数据访问
  • 安全传输：HTTPS强制
  • 叫做数据缩小：基于范围的数据过滤

集成点

  • EHR系统：模块化适配器模式
  • 票据交换所：EDI处理支持
  • 付款人API：多付款人集成就绪
  • 分析：兼容Power BI/Tableau

🧪 React前端集成

示例：拒绝接收

// React component example
const [denials, setDenials] = useState([]);

useEffect(() => {
  fetch('/api/denials?category=authorization&limit=50', {
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    }
  })
  .then(res => res.json())
  .then(data => setDenials(data.data));
}, []);

示例：生成上诉

const generateAppeal = async (denialId: string) => {
  const response = await fetch('/api/appeals/generate', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      denial_id: denialId,
      template_type: 'medical_necessity',
      include_clinical_notes: true
    })
  });
  
  const appeal = await response.json();
  return appeal.data;
};

🔧 发展

项目结构

src/
├── adapters/          # External system integrations
├── mcp/              # MCP tools and server
├── routes/           # REST API endpoints
├── types/            # TypeScript definitions
├── utils/            # Utilities (auth, logging, etc.)
└── server.ts         # Main server file

添加新的MCP工具

  1. 在中创建工具文件 src/mcp/tools/
  2. 使用Zod定义模式
  3. 实施 run 函数
  4. 从导出工具 mcpServer.ts

添加新适配器

  1. 在中创建适配器 src/adapters/
  2. 实现接口方法
  3. 添加错误处理和日志记录
  4. 在MCP工具或路线中使用

📊 监控和记录

日志文件

  • logs/error.log -错误事件
  • logs/audit.log HIPAA审计跟踪

健康检查

  • GET /health -服务器状态和指标

监控集成

准备好使用APM工具，如：

  • 新遗迹
  • 数据 Dog
  • 应用洞察

🚀 部署

生产检查表

  • []设置强JWT_SECRET
  • []配置真实的数据库连接
  • []设置日志轮换
  • []启用HTTPS
  • []配置监控
  • []设置备份系统
  • []查看安全标头

Docker支持（可选）

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist ./dist
EXPOSE 4000
CMD ["node", "dist/server.js"]

🤝 贡献

  1. 遵循TypeScript严格模式
  2. 添加适当的错误处理
  3. 包括敏感操作的审计日志记录
  4. 为新功能编写测试
  5. 更新文档

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🆘 支持

有关技术支持或集成问题：

  • 查看上面的API文档
  • 查看示例实现
  • 确保正确的身份验证设置
  • 验证操作所需的范围

该服务器为医疗保健RCM运营提供了坚实的基础，同时保持了HIPAA合规性，并支持传统的web应用程序和现代AI驱动的工作流程。

相关 MCP