使用说明
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服务托管。
- 提交您的更改并将其推送到GitHub/GitLab存储库。
- 创建新 Web服务 在渲染和连接存储库上。
- 选择 节点 环境。
- 设置 生成命令 致:
npm install && npm run build - 设置 启动命令 致:
npm start - 保持默认值
PORTRender注入的环境变量。 - (可选)添加 健康检查 击打
/以确保服务准备就绪。
当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内容。
快乐学习,记住:确保区域安全 之前 开始心肺复苏术!
