使用说明
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
该脚本将:
- 请输入您的 Supabase 服务角色密钥
- 请输入您的业务UUID
- 创建 .env 文件
- 构建项目
- 自动添加到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)
- 创建新服务
- 连接GitHub仓库
- 设置环境变量
- 部署
Docker(可选)
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY dist ./dist
CMD ["node", "dist/index.js"]
许可证
麻省理工学院(MIT)