Skip to main content
Glama

🏥 MedFlow MCP

MedFlow MCP is an AI-powered Hospital Operations server built with NitroStack. It serves as the "brain" for modern healthcare management, allowing AI assistants (like Claude, Cursor, and Nitro Studio) to seamlessly interact with hospital databases, trigger automated alerts, schedule appointments, and manage maintenance via Jira.

Built for the NitroStack MCP Hackathon, this project demonstrates how the Model Context Protocol (MCP) can completely revolutionize complex operational workflows in a healthcare setting.


✨ Key Features

  • 🎫 Automated Jira Integration: AI can automatically detect malfunctioning hospital equipment (e.g., MRI machines, Defibrillators) from natural language and instantly generate a formatted Jira ticket for the maintenance team via the Atlassian API.

  • 🎨 Glassmorphism UI Widgets: Includes rich, beautifully styled Next.js frontend widgets that pop up natively inside the AI chat interface (Patient Profiles, Doctor Dashboards, and Surgery Readiness checklists).

  • 🩺 Patient & Appointment Management: Exposes AI tools for scheduling follow-ups, prioritizing critical patients, and viewing real-time doctor queues.

  • 🚨 Emergency Alerting System: Tools to broadcast critical CODE emergencies directly to ER teams via Webhook (Slack/Discord).

  • 🧠 Diagnostic Vision AI (Mock): A tool designed to read X-rays and MRI scan notes to provide instant clinical AI impressions.


Related MCP server: Personal JIRA MCP

🛠️ Tech Stack

  • Framework: NitroStack (Official MCP Framework)

  • Backend: Node.js, TypeScript

  • Frontend (Widgets): Next.js, React, Tailwind CSS, Framer Motion

  • Integrations: Atlassian Jira API v3 (REST)


🚀 How to Run Locally

1. Clone the Repository

git clone https://github.com/tsjharsha/MedFlowMCP-AI-.git
cd MedFlowMCP-AI-

2. Install Dependencies

npm install
npm --prefix src/widgets install

3. Environment Variables

Create a .env file in the root directory and add your Jira API credentials:

JIRA_DOMAIN=your-team.atlassian.net
JIRA_PROJECT_KEY=SCRUM
JIRA_EMAIL=your-email@domain.com
JIRA_API_TOKEN=your-jira-api-token

4. Start the Server

Start the development server with hot-reloading for both the backend MCP server and frontend widgets:

npm run dev

🔌 Connecting to an AI Client

Because this is an MCP Server, you don't interact with it directly through a browser. You connect an AI to it!

  1. Nitro Studio: Start your local server, open Nitro Studio, and connect to http://localhost:3000/mcp.

  2. Cursor IDE: Go to Settings -> Features -> MCP -> Add New. Select SSE, name it MedFlow, and set the URL to your deployed NitroCloud URL or http://localhost:3000/mcp.

Once connected, simply talk to the AI (e.g., "Show me the dashboard for Doctor Alice" or "Report that the X-Ray in the lab is broken") and watch it use the tools and render the widgets!


Built with ❤️ for the NitroStack Hackathon.

Available Tools

10 tools
analyze_medical_imageC

Send a medical scan (X-Ray, MRI) to a specialized Diagnostic Vision AI model for anomaly detection.

Inputs: scanType (required), patientId (required), clinicalNotes (required).

generate_medical_notesA

Extract structured medical notes (Symptoms, Diagnosis, Medicines, Tests, Advice) from a raw doctor voice transcript.

Inputs: transcript (required).

get_patient_historyC

Fetch the medical history of a patient by ID.

Inputs: patientId (required).

manage_queueB

Get the current queue for a specific doctor.

Inputs: doctorId (required).

order_lab_testC

Send a request for lab tests to the laboratory.

Inputs: tests (required), doctorId (required), patientId (required), priority.

prioritize_patientsC

Reorder a doctor's queue by changing an appointment priority.

Inputs: newPriority (required), appointmentId (required).

record_consultationC

Save finalized consultation notes to the patient record.

Inputs: notes (required), doctorId (required), patientId (required), appointmentId (required).

register_patientC

Register a new patient or update an existing one.

Inputs: age (required), name (required), gender (required), contact (required), +1 more.

schedule_appointmentC

Schedule a new appointment for a patient with a doctor.

Inputs: time (required), type (required), doctorId (required), complaint (required), +1 more.

schedule_followupC

Schedule a follow-up appointment in a given number of days.

Inputs: doctorId (required), patientId (required), daysFromNow (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool targets a distinct action or resource: patient registration, history retrieval, appointment scheduling, queue management, follow-up scheduling, queue prioritization, consultation recording, note generation, lab tests, and image analysis. No significant overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., register_patient, schedule_appointment, analyze_medical_image). No mixing of conventions.

    Tool Count5/5

    10 tools cover the main workflows of a medical practice: patient management, appointments, queue, consultations, lab, and imaging. Not too few or too many.

    Completeness4/5

    Covers core clinical operations well, including patient history, appointments, queue, consultation notes, lab tests, and image analysis. Minor gaps like billing or discharge are absent but not critical for the apparent scope.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      An MCP server that enables AI assistants to interact with JIRA, allowing for querying issue details, creating and updating work items, and managing attachments through a standardized interface.
      12
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server and web application that enables natural language medical queries and patient data analysis powered by Gemini AI. It allows users to track and analyze patient biometrics, including vitals, sleep patterns, and laboratory results, through a comprehensive set of automated medical tools.
      -