Patient Search & Create Tasks MCP Server

患者搜索与创建任务 MCP 服务

此项目提供一个模型上下文协议（MCP）服务，用于在 Flight Health Atlas 系统中搜索患者并创建新任务。

功能

• V2 服务（server-v2.ts）：使用 Puppeteer 实现高级网页自动化，并提供更可靠的登录处理

先决条件

• Node.js 18 或更高版本
• npm 或 yarn 包管理器

安装

1. 克隆仓库：

git clone <repository-url>
cd patient-search-mcp

2. 安装依赖项：

npm install

3. 更新凭据 前往 auth.ts，将 LOGIN_CREDENTIALS 中的邮箱和密码替换为你的凭据。 出于演示目的，这些凭据是硬编码的，因为默认情况下 Cursor AI 无法访问 .env 文件（可以通过创建 .cursorignore 文件并在其中添加 !.env 来解决）。

4. 构建服务：

npm build:v2      # only build the V2 server
npm run start     # Build and start V2 server

配置

用于 Cursor MCP

将以下内容添加到 Cursor 的 mcp.json 文件中（可在 Cursor 设置中找到）：

V2 服务（推荐）：

{
  "mcpServers": {
    "patient-search-v2": {
      "command": "node",
      "args": ["/path/to/mcp-search-and-create-task/dist/server-v2.js"]
    }
  }
}

使用方法

可用工具

两个服务都提供以下工具：

hello_world

• 说明：测试 MCP 连接
• 参数：
  • name（可选）：要问候的姓名

search_patient_v2（V2 服务）

• 说明：使用 Puppeteer 网页自动化搜索患者
• 参数：
  • patient_name（必需）：要搜索的患者姓名
  • detailed（可选）：是否返回详细信息

create_new_task（V2 服务）

• 说明：创建新任务
• 参数：
  • task_type（必需）：要创建的任务类型
  • task_name（必需）：要创建的任务名称
  • description（可选）：要添加到任务的任何说明

使用示例

// Test connection
await callTool("hello_world", { name: "Aakarsh" });

// Search for a patient (V2 server)
await callTool("search_patient_v2", { 
  patient_name: "John Smith",
  detailed: true 
});

开发

在开发模式下运行

npm run dev

### Starting the Server

```bash
# Latest server
npm start

### Testing

You can test the servers directly using JSON-RPC messages:

```bash
# Test V2 server initialization
echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | node dist/server-v2.js

我还创建了一个名为 test-task-creation 的示例测试文件，用于测试任务创建。构建服务后，可以通过命令 node dist/test-task-creation.js 运行测试。

故障排除

常见问题

1. 浏览器启动失败（V2 服务）：

   • 确保系统资源充足
   • 尝试使用 --no-sandbox 标志运行（已包含）

2. 登录失败：

   • 确认凭据正确
   • 检查是否可以访问 Atlas 暂存站点
   • 确保网络连接正常

3. 患者搜索无结果：

   • 确认患者姓名拼写正确
   • 检查是否已登录到正确的环境
   • 尝试使用部分姓名进行匹配

调试模式

两个服务都会将调试信息记录到 stderr。查看控制台输出以获取详细错误消息。 此外，如果需要清理 /dist 文件夹，可以运行 npm run clean。

依赖项

• @modelcontextprotocol/sdk：MCP TypeScript SDK
• puppeteer：网页自动化（V2 服务）
• dotenv：环境变量管理