医疗凭证管理服务器

BIP医疗凭证平台的MCP服务器,通过安全认证的API实现AI代理与医疗提供者数据、凭证工作流程和医疗操作的交互。

  • by The-Bip-App
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 The-Bip-App/bip-mcp-server

使用说明

BIP MCP 服务器

BIP医疗保健认证平台的生产就绪型MCP服务器。它使AI代理能够通过安全、经过身份验证的API与提供商数据、认证工作流和医疗保健操作进行交互。

特点/功能

  • 全面的供应商管理提供者、许可证、教育背景、工作经历、继续医学教育(CME)活动及同行推荐的完整CRUD(创建、读取、更新、删除)操作
  • 多租户安全使用Supabase行级安全性(RLS)实现业务级别的数据隔离
  • 已准备好投入生产速率限制、缓存、审计日志、错误处理
  • 认证服务帐户和API密钥支持
  • 外部集成NPPES查询,LexisNexis增强功能
  • 工作流自动化常见认证任务的引导提示

快速入门

先决条件

  • Node.js 20+(版本)
  • 使用BIP架构的Supabase项目
  • 来自Supabase的服务角色密钥
  • 您的业务唯一标识符(UUID)

安装

互动装置(推荐):

cd ~/dev/bip-mcp-server
./install.sh

该脚本将:

  1. 请输入您的 Supabase 服务角色密钥
  2. 请输入您的业务UUID
  3. 创建 .env 文件
  4. 构建项目
  5. 自动添加到Claude代码中

手动安装:

cd ~/dev/bip-mcp-server
npm install

# Copy and edit environment file
cp .env.example .env
# Edit .env with your credentials

npm run build

使用服务器

安装完成后,服务器将自动添加到Claude Code中。

在Claude代码中尝试这些命令:

Read bip://providers/list
Use the search_providers tool to find all Active providers
Use the create_provider tool to add a new provider with NPI 1234567890

卸载

cd ~/dev/bip-mcp-server
./uninstall.sh

建筑学

资源(只读)

  • bip://providers/list - 列出所有提供商
  • bip://providers/{id} - 单个提供商
  • bip://providers/{id}/licenses - 服务提供商许可证
  • bip://providers/{id}/education - 教育记录
  • bip://providers/{id}/work-history - 工作经历
  • bip://providers/{id}/cme - CME(继续医学教育)活动
  • bip://providers/{id}/peer-references - 同龄人推荐
  • bip://providers/{id}/documents - 文件

工具(操作)

  • create_provider - 创建新的提供商
  • update_provider - 更新提供商详细信息
  • search_providers - 搜索并筛选供应商
  • add_license - 添加提供商许可证
  • add_education - 添加教育记录
  • add_work_history - 添加工作经历
  • add_cme_activity - 添加继续医学教育(CME)活动
  • upload_document - 上传文件
  • import_from_nppes - NPPES查询

提示(工作流)

  • onboard_provider - 完成供应商入驻流程
  • complete_credentialing - 准入资格核对清单
  • generate_roster - 创建名单
  • review_expiring_items - 到期审查

安全

  • 需要服务角色密钥(全数据库访问权限)
  • 实施了业务级别的数据隔离
  • 限制速率以防止滥用
  • 对所有变异进行审计日志记录
  • 使用 Zod 进行输入验证
  • 错误消息中不包含敏感数据

发展

# Run with hot reload
npm run dev

# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Lint code
npm run lint

# Format code
npm run format

环境变量

看 .env.example 适用于所有配置选项。

测试

# Unit tests
npm run test

# Integration tests (requires test Supabase instance)
npm run test -- tests/integration

# E2E tests
npm run test -- tests/e2e

部署

云部署(渲染、铁路运输、Fly.io)

  1. 创建新服务
  2. 连接GitHub仓库
  3. 设置环境变量
  4. 部署

Docker(可选)

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY dist ./dist
CMD ["node", "dist/index.js"]

许可证

麻省理工学院(MIT)