CPR培训资源服务器

一个提供心肺复苏(CPR)培训资源的服务器,包括结构化课程、演示视频链接和反思问题,供AI助手和应用程序按需获取可信内容。

  • by AffirmerAu
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 AffirmerAu/MCP_Server

使用说明

CPR MCP服务器

该项目提供了一个用TypeScript实现的初学者友好的模型上下文协议(MCP)服务器。服务器公开了心肺复苏(CPR)培训资源——一个结构化的课程、一个演示视频链接和一个反思性问题——这样人工智能助手和应用程序就可以按需提取可信的内容。

该服务器是基于HTTP的与传输无关的JSON-RPC,使其易于在本地运行或部署到 渲染 以获得更广泛的访问。

特性

  • ✅ 结构化心肺复苏课程 涵盖危险检查、响应、气道、呼吸、按压和AED使用。
  • 🎬 演示视频参考 有关于要注意什么的指导。
  • ❓ 反思性检查题 因此,每次互动都以确认理解而结束。
  • 📦 MCP风格JSON-RPC接口 随着 initialize, resources/*,以及 prompts/* 方法。
  • 🌐 内置REST助手 (/resources, /prompts)用于快速手动测试。
  • ☁️ 渲染就绪 零外部依赖。

先决条件

  • Node.js 18或更新(随附 npm).
  • Git(用于克隆存储库)。

1.克隆项目

git clone <your-fork-or-repo-url>
cd MCP_Server

如果您在新机器上从该模板开始,请更换 <your-fork-or-repo-url> 带有存储副本的存储库地址。

2.安装依赖项

该项目只依赖于TypeScript工具,因此安装很快:

npm install

提示: 如果您在代理后面工作,请配置 npm config set proxy http://... 在运行命令之前。

3.在本地运行MCP服务器

开发模式(直接使用TypeScript)

npm run dev

此命令使用 ts-node-dev 因此,当您编辑文件时,服务器会自动重新启动。您将看到类似以下内容的控制台消息:

CPR MCP server listening on port 3000

生产建设

npm run build
npm start

npm run build 将编译后的JavaScript发送到 dist/,以及 npm start 使用Node.js运行编译后的代码。

默认情况下,服务器侦听端口 3000。通过导出来覆盖此内容 PORT 在运行服务器之前:

PORT=8080 npm start

4.探索API

服务器在以下地址使用JSON-RPC 2.0 /mcp 并且还为人类暴露了辅助端点。

4.1快速健康检查

curl http://localhost:3000/

答复:

{
  "message": "CPR MCP Server is running.",
  "endpoints": {
    "rpc": "/mcp",
    "resources": "/resources",
    "prompts": "/prompts"
  }
}

4.2列出MCP资源

curl http://localhost:3000/resources

4.3通过JSON-RPC获取课程

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "resources/read",
    "params": {
      "uri": "cpr://lesson"
    }
  }'

4.4获取问题提示

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "prompts/get",
    "params": {
      "name": "cpr-quick-start"
    }
  }'

5.部署以渲染

Render可以将此服务器作为免费web服务托管。

  1. 提交您的更改并将其推送到GitHub/GitLab存储库。
  2. 创建新 Web服务 在渲染和连接存储库上。
  3. 选择 节点 环境。
  4. 设置 生成命令 致:
    npm install && npm run build
    
  5. 设置 启动命令 致:
    npm start
    
  6. 保持默认值 PORT Render注入的环境变量。
  7. (可选)添加 健康检查 击打 / 以确保服务准备就绪。

当Render完成部署时,您将收到一个公共URL,如下所示 https://cpr-mcp.onrender.com.用同样的方法进行测试 curl 命令,交换 localhost:3000 对于您的渲染域。

6.定制内容

  • 编辑 src/content/cprLesson.ts 要更新课程副本,请链接到其他视频,或更改反思性问题。
  • 向添加更多条目 RESOURCES 在 src/resources.ts 公开其他文章、下载或清单。
  • 在中创建新条目 PROMPTS 对于其他预先编写的导师回复,您的MCP客户端可以重复使用。

更改后,重建(npm run build)并重新部署。

7.下一步

  • 通过将MCP服务器指向 /mcp 终点。
  • 通过其他方法扩展协议支持,例如 tools/list 或 tools/call 如果你的客户期待他们。
  • 为JSON-RPC处理程序添加自动测试,以验证CPR内容。

快乐学习,记住:确保区域安全 之前 开始心肺复苏术!