explaingit

govardhansatya/surakshamcp

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 4/5LicenseSetup · hard

TLDR

An MCP server that detects construction safety violations from photos and speaks alerts back to workers in their own Indian language.

Mindmap

mindmap
  root((SurakshaMCP))
    What it does
      Detects PPE and hazard violations
      Identifies spoken language
      Delivers voice safety alerts
    Tech stack
      TypeScript
      Python FastAPI
      YOLOv8
    Use cases
      Monitor site safety from photos
      Alert workers in their native language
      Generate BRSR safety reports
    Audience
      Construction safety teams
      MCP tool developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Detect missing protective equipment or hazards from a construction site photo.

USE CASE 2

Speak safety alerts back to workers automatically in their own spoken Indian language.

USE CASE 3

Generate a BRSR-aligned safety disclosure report from logged detections and alerts.

USE CASE 4

Send safety alerts to a site foreman's phone over WhatsApp.

What is it built with?

TypeScriptPythonFastAPIYOLOv8NitroStack

How does it compare?

govardhansatya/surakshamcp0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires running two separate services (Node.js MCP server plus a Python FastAPI inference service) or Docker Compose to run both together.

The MCP server and framework are Apache-2.0, permissive and free to use commercially, the bundled vision model is AGPL-3.0, which has stricter copyleft terms.

In plain English

SurakshaMCP is a construction safety tool built as an MCP server, meaning it exposes its capabilities as structured tools that any AI assistant supporting the Model Context Protocol, such as Claude or ChatGPT, can call and use. It was built for a hackathon focused on occupational and construction safety, and it targets a specific real problem: construction sites in India, especially small contractors, often have low-literacy, multilingual, migrant workforces that English-only safety dashboards and signage never reach. The README cites a study estimating around 38 fatal construction accidents a day in India, with falls from height and structural collapses making up most documented deaths. The tool works by analyzing a photo from a construction site to detect personal protective equipment and hazard violations, using a fine-tuned YOLOv8 vision model. A second model identifies which language a worker is speaking, so that safety alerts can then be spoken back to them in their own language, covering ten Indian languages through a text-to-speech system called AI4Bharat Indic-TTS. The project frames this voice and language capability as especially useful for real-time hazards, like a worker straying near moving machinery, and for multilingual safety briefings with migrant crews, rather than just reading out static signs. Every detection and alert is also logged to a local database and can be rolled up into a safety disclosure report aligned with an Indian regulatory framework called BRSR, which is mandatory reporting for India's largest listed companies and increasingly expected from their supply chains. Alerts can additionally be sent to a site foreman's phone over WhatsApp using Twilio. Architecturally, the project is split into two services: an MCP server written in TypeScript using a framework called NitroStack, which is the main deliverable, and a separate Python FastAPI service that runs the actual PPE detection, language identification, and text-to-speech models. The MCP server talks to the inference service over HTTPS. A live demo endpoint is provided that any MCP client can connect to directly. To run it locally, you need Node.js 20.18.1 or newer, Python 3.10 or newer, and either run both services manually or start them together with Docker Compose. The underlying datasets and models are drawn from free and openly licensed sources, though the README notes the vision model's own license is AGPL-3.0.

Copy-paste prompts

Prompt 1
Help me connect an MCP client like Claude Desktop to the SurakshaMCP live demo endpoint.
Prompt 2
Walk me through running the inference service and MCP server locally with Docker Compose.
Prompt 3
Explain how SurakshaMCP identifies a worker's spoken language and delivers a voice alert in that language.
Prompt 4
Show me how the run_site_safety_audit task and generate_esg_report tool fit together.

Frequently asked questions

What is surakshamcp?

An MCP server that detects construction safety violations from photos and speaks alerts back to workers in their own Indian language.

What language is surakshamcp written in?

Mainly TypeScript. The stack also includes TypeScript, Python, FastAPI.

What license does surakshamcp use?

The MCP server and framework are Apache-2.0, permissive and free to use commercially, the bundled vision model is AGPL-3.0, which has stricter copyleft terms.

How hard is surakshamcp to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is surakshamcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.