CPR MCP Server

This project provides a beginner-friendly Model Context Protocol (MCP) server implemented in TypeScript. The server exposes CPR (Cardiopulmonary Resuscitation) training resources — a structured lesson, a demonstration video link, and a reflective question — so that AI assistants and applications can pull trusted content on demand.

The server is transport-agnostic JSON-RPC over HTTP, making it easy to run locally or deploy to Render for wider access.

Features

✅ Structured CPR lesson covering danger checks, response, airway, breathing, compressions, and AED usage.
🎬 Demonstration video reference with guidance on what to watch for.
❓ Reflective check question so each interaction ends by confirming understanding.
📦 MCP-style JSON-RPC interface with initialize, resources/*, and prompts/* methods.
🌐 Built-in REST helpers (/resources, /prompts) for quick manual testing.
☁️ Render-ready with zero external dependencies.

Prerequisites

Node.js 18 or newer (comes with npm).
Git (for cloning the repository).

1. Clone the project

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

If you are starting from this template on a fresh machine, replace <your-fork-or-repo-url> with the repository address where you store your copy.

2. Install dependencies

The project only relies on TypeScript tooling, so installation is quick:

npm install

Tip: If you are working behind a proxy, configure npm config set proxy http://... before running the command.

3. Run the MCP server locally

Development mode (TypeScript directly)

npm run dev

This command uses ts-node-dev so the server restarts automatically when you edit files. You will see a console message similar to:

CPR MCP server listening on port 3000

Production build

npm run build npm start

npm run build emits compiled JavaScript into dist/, and npm start runs the compiled code with Node.js.

By default the server listens on port 3000. Override this by exporting PORT before running the server:

PORT=8080 npm start

4. Explore the API

The server speaks JSON-RPC 2.0 at /mcp and also exposes helper endpoints for humans.

4.1 Quick health check

curl http://localhost:3000/

Response:

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

4.2 List MCP resources

curl http://localhost:3000/resources

4.3 Fetch the lesson via 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 Get the question prompt

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. Deploy to Render

Render can host this server as a free web service.

Commit your changes and push them to a GitHub/GitLab repository.
Create a new Web Service on Render and connect your repository.
Choose the Node environment.
Set the Build Command to:
npm install && npm run build
Set the Start Command to:
npm start
Keep the default PORT environment variable that Render injects.
(Optional) Add a health check hitting / to ensure the service is ready.

When Render finishes deployment you will receive a public URL like https://cpr-mcp.onrender.com. Test it with the same curl commands, swapping localhost:3000 for your Render domain.

6. Customising the content

Edit src/content/cprLesson.ts to update the lesson copy, link to a different video, or change the reflective question.
Add more entries to RESOURCES in src/resources.ts to expose additional articles, downloads, or checklists.
Create new entries in PROMPTS for other pre-composed tutor responses your MCP client can reuse.

After making changes, rebuild (npm run build) and redeploy.

7. Next steps

Connect the MCP server to an MCP-compatible client (for example, a local AI assistant) by pointing it to the /mcp endpoint.
Expand the protocol support with additional methods such as tools/list or tools/call if your client expects them.
Add automated tests for JSON-RPC handlers to keep the CPR content verified.

Happy learning, and remember: ensure the area is safe before you begin CPR!

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides structured CPR training resources including lessons, demonstration videos, and reflective questions through an MCP interface. Enables AI assistants to deliver trusted cardiopulmonary resuscitation training content on demand.

CPR Training MCP Server