sriramnatrajhen avatar

Humsana Mcp

sriramnatrajhen/humsana-mcp

Monitors your typing patterns through a local daemon to detect cognitive fatigue, then blocks risky shell commands and large AI code deletions when you're running on empty. Exposes four tools: get_user_state for current stress and focus levels, check_dangerous_command for pre-flight validation, safe_execute_command that stops destructive operations like rm -rf when fatigue is high, and safe_write_file that warns or blocks when Claude tries to delete 30+ lines while you're tired. Starts in dry-run mode and logs all safety overrides to a local audit file. Reach for this if you've ever merged a bad PR at 2am or nuked something important while exhausted.

tools
4
transport
STDIO
last updated
Jan 2, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

get_user_stateGet current stress, focus, fatigue levels

Get current stress, focus, fatigue levels

No parameter schema in public metadata yet.

check_dangerous_commandCheck if a command would be blocked

Check if a command would be blocked

No parameter schema in public metadata yet.

safe_execute_commandExecute shell commands with interlock

Execute shell commands with interlock

No parameter schema in public metadata yet.

safe_write_fileWrite files with AI rewrite protection

Write files with AI rewrite protection

No parameter schema in public metadata yet.

Sponsors

Readme

@humsana/mcp-server

Cognitive Security for AI-assisted development.

πŸ›‘οΈ "The breathalyzer for your terminal."

Humsana prevents you from running dangerous commands or accepting large AI code rewrites when you're fatigued. Think of it as an industrial safety interlock, but for your brain.

What It Does

Command Protection (safe_execute_command)

SituationResult
You're fresh, running lsβœ… Runs normally
You're fresh, running rm -rf⚠️ Warning, allowed
You're tired, running rm -rfβ›” BLOCKED β€” requires override

AI Rewrite Protection (safe_write_file)

SituationResult
AI writes new fileβœ… Allowed
AI rewrites 10 linesβœ… Allowed
You're tired + AI deletes 30+ lines⚠️ Warning
You're tired + AI deletes 50+ linesβ›” BLOCKED β€” saved for review

Quick Start

1. Install the Daemon

pip install humsana-daemon
humsana start

Keep this running in a terminal tab.

2. Install the MCP Server

npm install -g @humsana/mcp-server

3. Configure Claude Desktop


View the full README on GitHub

Details

Repository
github.com/sriramnatrajhen/humsana-mcp
Package
@humsana/mcp-server
Transport
STDIO
Registry
MCP registry, active