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!

CPR Training MCP Server