Medplum MCP服务器
🚀 项目描述
该项目实现了 完整的模型上下文协议（MCP）服务器 其设计用于与Medplum Contoso服务器无缝交互。MCP服务器提供了一个标准化的接口，使大型语言模型（LLM）能够通过一套全面的工具对各种Contoso资源执行创建、读取、更新和搜索（CRUD）操作。这使用户能够通过任何兼容MCP的客户端（Claude Desktop、VS Code MCP扩展等）使用自然语言命令管理存储在Medplum中的医疗保健数据。
该服务器实现了完整的MCP协议规范，提供了33个全面的Contoso资源管理工具，任何MCP客户端都可以发现和执行这些工具。用户可以通过与LLM对话直观地管理患者信息、从业人员、组织、遭遇、观察等，LLM利用MCP工具执行针对Contoso服务器的请求。
✨ 当前状态
🎉 MCP服务器实施完成！ 🎉
实施内容：
- ✅ 核心Contoso资源管理工具（患者、从业者、组织、会面、观察、用药等）
- ✅ MCP服务器协议实现 -带stdio传输的全模型上下文协议服务器
- ✅ LLM交互的综合工具模式（33个Contoso工具）
- ✅ 交互式聊天工具 -具有自然语言界面的完整MCP客户端
- ✅ 所有工具的Jest集成测试
- ✅ Medplum Contoso服务器连接和身份验证
- ✅ MCP检验员测试和验证
- ✅ Claude桌面集成配置
准备使用：
- 🔄 MCP服务器功能齐全，可与MCP客户端集成
- ✅ 所有33个Contoso工具都已正确注册并正常工作
- 🔄 服务器已成功通过Medplum的身份验证并执行Contoso操作
- 🔄 提供交互式聊天工具 -用自然语言测试所有工具
- 🔄 使用MCP Inspector进行测试-所有工具均可发现和执行
- 🔄 Claude桌面配置可立即使用
当前能力：
- 通过自然语言对Contoso资源进行完整的CRUD操作
- 用于测试和开发的交互式聊天界面
- 与任何兼容MCP的客户端（Claude Desktop、VS Code MCP扩展等）无缝集成
- 全面的错误处理和记录
- 生产就绪的MCP协议实施
🌟 已实现的功能
MCP服务器目前支持一套全面的 33工具 用于管理各种Contoso资源：
👥 患者管理（4个工具） - src/tools/patientUtils.ts
createPatient：创建包含人口统计信息、标识符和联系信息的新患者记录。getPatientById：通过患者的唯一ID检索完整的患者详细信息。updatePatient：修改现有患者信息，包括人口统计和联系方式。searchPatients：根据姓名、出生日期、标识符或其他标准查找患者。
👩⚕️ 从业者管理（5个工具） - src/tools/practitionerUtils.ts
createPractitioner：注册新的医疗从业者及其专业信息。getPractitionerById：通过其唯一ID获取完整的从业者详细信息。updatePractitioner：更新从业者信息，包括资格和联系方式。searchPractitionersByName：使用从业者的名字或姓氏搜索从业者。searchPractitioners：根据多种标准对从业人员进行高级搜索。
🏥 组织管理（4个工具） - src/tools/organizationUtils.ts
createOrganization：增加新的医疗机构（医院、诊所、科室）。getOrganizationById：通过其唯一ID检索完整的组织详细信息。updateOrganization：更新组织信息，包括联系方式和地址。searchOrganizations：按名称、类型或其他属性搜索组织。
🏥 遭遇管理（4个工具） - src/tools/encounterUtils.ts
createEncounter：创建新的患者接触（就诊、预约、住院）。getEncounterById：通过其唯一ID检索完整的遭遇详情。updateEncounter：更新遭遇信息，包括状态、班级和参与者。searchEncounters：按患者、医生、日期、状态或类别搜索遭遇。
🔬 观察管理（4个工具） - src/tools/observationUtils.ts
createObservation：记录新的观察结果（实验室结果、生命体征、诊断结果）。getObservationById：通过其唯一ID检索完整的观察细节。updateObservation：修改现有的观察结果，包括值、状态和解释。searchObservations：按患者、代码、日期或遭遇搜索观察结果。
💊 药物申请管理（4个工具） - src/tools/medicationRequestUtils.ts
createMedicationRequest：创建新的药物请求（处方），包括剂量和说明。getMedicationRequestById：通过其唯一ID检索完整的药物申请详细信息。updateMedicationRequest：更新处方信息，包括状态、剂量和说明。searchMedicationRequests：按患者、药物或处方者搜索药物请求。
💉 药物管理（3个工具） - src/tools/medicationUtils.ts
createMedication：使用代码、名称和配方创建新的药物资源。getMedicationById：通过其唯一ID检索完整的药物详细信息。searchMedications：按代码、名称或成分搜索药物。
📋 护理管理集（4个工具） - src/tools/episodeOfCareUtils.ts
createEpisodeOfCare：随着时间的推移，创建新的护理事件来管理患者护理。getEpisodeOfCareById：通过其唯一ID检索完整的护理细节。updateEpisodeOfCare：更新剧集信息，包括状态、时段和管理组织。searchEpisodesOfCare：按患者、状态或管理组织搜索护理事件。
🔍 通用的➤操作（1个工具）
generalFhirSearch：使用任何资源类型的自定义参数进行通用Contoso搜索，支持跨所有Contoso资源的高级查询。
每个工具都通过定义良好的JSON模式暴露给LLM，并可通过专用测试工具调用(src/llm-test-harness.ts)，促进稳健的测试和集成。
🛠️ 技术栈
- 运行时：Node.js
- 语言：TypeScript
- Contoso服务器交互:
@medplum/core,@medplum/fhirtypes - LLM集成：OpenAI API（特别是
gpt-4o在测试线束中） - 测试：Jest（用于集成测试），通过测试线束手动E2E
- 装订和格式化：ESLint，Prettier
- 环境管理:
dotenv - HTTP客户端（用于Medplum SDK）:
node-fetch
📁 项目结构
medplum-mcp/
├── src/ # Source code
│ ├── config/ # Medplum client configuration (medplumClient.ts)
│ ├── tools/ # FHIR resource utility functions (patientUtils.ts, etc.)
│ ├── lib/ # Shared libraries (currently unused)
│ ├── index.ts # Main application entry point
│ ├── llm-test-harness.ts # Script for testing LLM tool calling
│ └── test-connection.ts # Script for basic Medplum connection test
├── tests/ # Test suites
│ └── integration/ # Jest integration tests for tools
├── .eslintrc.js
├── .gitignore
├── .prettierrc.js
├── .prettierignore
├── package.json
├── tsconfig.json
└── README.md⚙️ 设置和配置
- 先决条件:
- Node.js（参考 package.json 了解发动机细节；推荐LTS版本） - 正在运行的Medplum服务器实例（例如，位于 http://localhost:8103/) - Medplum客户端凭据（客户端ID和客户端密码）
- 安装:
git clone https://github.com/rkirkendall/medplum-mcp.git
cd medplum-mcp
npm install- 环境变量:
创建一个 .env 项目根目录中的文件，其中包含您的特定Medplum服务器详细信息和API密钥：
MEDPLUM_BASE_URL=http://your-medplum-server-url/
MEDPLUM_CLIENT_ID=your_client_id
MEDPLUM_CLIENT_SECRET=your_client_secret
OPENAI_API_KEY=your_openai_api_key # Required for llm-test-harness.ts🚀 用法
💬 交互式聊天工具（推荐）
测试MCP服务器最用户友好的方法是通过交互式聊天界面：
# Build and run the chat harness
npm run chat
# Or in development mode
npx ts-node src/llm-test-harness.ts特征：
- 🗣️ 与所有33个kubectl工具进行自然语言交互
- 🔧 自动工具发现和执行
- 📋 内置帮助和示例
- 🔄 会话上下文维护
- ⚡ 实时工具执行和结果
示例会话：
🏥 You: Create a new patient Jane Smith born 1985-03-20
🤖 Assistant: I'll create a new patient record for Jane Smith...
🏥 You: Find all doctors named Stevens
🤖 Assistant: I found 2 practitioners with the name Stevens...看 CHAT_HARNESS_USAGE.md 了解详细的使用说明和 IMPLEMENTATION_PLAN.md 了解开发细节。
▶️ 直接运行MCP服务器
npm start # Runs the MCP server with stdio transport
npm run dev # Development mode with live reloading🧪 替代测试方法
# MCP Inspector (web-based tool testing)
npx @modelcontextprotocol/inspector node dist/index.js
# Legacy OpenAI integration (deprecated)
npm run test:harness✅ 测试
🔗 集成测试
集成测试使用Jest并与实时Medplum实例交互（通过配置 .env).
要运行所有集成测试，请执行以下操作：
npx jest tests/integration要运行特定的集成测试文件，请执行以下操作：
npx jest tests/integration/patient.integration.test.ts
npx jest tests/integration/practitioner.integration.test.ts
npx jest tests/integration/organization.integration.test.ts
# Add other specific test files as needed📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。