
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 toolsPublic 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)
| Situation | Result |
|---|---|
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)
| Situation | Result |
|---|---|
| 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
Details
- Repository
- github.com/sriramnatrajhen/humsana-mcp
- Package
@humsana/mcp-server- Transport
- STDIO
- Registry
- MCP registry, active