project_human

mcp
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

9 humanity skills for AI agents — crisis detection, WCAG audits, empathy, cultural sensitivity, and more. MCP + npm.

README.md

Humanity4AI

9 humanity skills for AI agents — crisis detection, accessibility auditing, empathy, cultural sensitivity, and more. Ready-to-use via MCP, npm, or direct prompting.

CI
npm
License: MIT
Release
CodeQL
MCP Registry
Works with

Demo


Skills at a Glance

Skill Category What it does
🛡️ Supportive Reply Emotional Safety Detects crisis signals, generates supportive responses with escalation guidance
📝 Safe Content Rewriter Emotional Safety Audits and rewrites text to remove harmful, stigmatising, or triggering patterns
♿ Accessibility Audit Accessibility Scores pages against all 86 WCAG 2.2 success criteria (A/AA/AAA)
🧠 Cognitive Accessibility Cognitive Support Audits content for reading level, structure, and cognitive load
🌍 Cultural Context Check Cultural Context Flags cultural sensitivity issues for a given audience and region
🔥 De-escalation Plan Conflict Navigation Generates structured de-escalation plans calibrated to conflict intensity
💬 Empathetic Reframe Communication Reframes messages with genuine empathy, catching hollow empathy patterns
🧩 Neurodiversity Design Neurodiversity Audits UIs for ADHD, autism, dyslexia, and sensory sensitivity
👶 Age-Inclusive Design Age Inclusion Audits user flows for age barriers across children, adults, and older users

Quick Start

Zero setup — just a URL:

{
  "mcpServers": {
    "humanity4ai": {
      "url": "https://humanity4ai.ascent.partners/api/mcp"
    }
  }
}

Or one command with npx:

npx @humanity4ai/mcp-servers

Then configure your MCP client:

{
  "mcpServers": {
    "humanity4ai": {
      "command": "npx",
      "args": ["-y", "@humanity4ai/mcp-servers"]
    }
  }
}

Docker: docker compose up
For contributors: git clone … && pnpm install && pnpm start

All 9 skills are discoverable via tools/list and invocable via tools/call.

Prerequisites (for local only): Node.js >= 22, pnpm >= 10 | Windows, macOS, Linux, Android, iOS


Architecture

graph TD
    A[MCP Client<br/>VS Code / Cursor / Claude Code] -->|stdio| B[mcp-server.ts]
    A -->|HTTP POST| C[Vercel<br/>humanity4ai.ascent.partners]
    B --> D[server-factory.ts<br/>createServer]
    C -->|api/mcp.ts| D
    D --> E[9 Tool Registrations]
    E --> F[handlers.ts<br/>invokeAction]
    F --> G[validate.ts<br/>SCHEMA_REGISTRY]
    G --> H[schemas-data.ts<br/>18 inline schemas]
    F --> I[9 Handler Functions<br/>rule-based, zero LLM calls]
    I --> J[crisis-resources<br/>patterns<br/>i18n<br/>wcag-criteria]

Four Ways to Use

Method Best for How
Remote URL Zero-setup, any MCP client Point to https://humanity4ai.ascent.partners/api/mcp
MCP Server VS Code, Cursor, Claude Code, Copilot, Manus AI, OpenCode npx @humanity4ai/mcp-servers or clone & start
LLM Prompting ChatGPT, Claude, Gemini (web chat) Share llms.txt or paste llms-full.txt into the chat
Local Files Offline CLI tools Clone the repo, point your tool at the skills/ directory

See Agent Adapter Guide for platform-specific setup instructions.


Why Humanity4AI?

AI agents are everywhere — but they're not always humane. Humanity4AI gives agents reusable, tested skills for the moments that matter:

  • An agent detects a user in crisis → Supportive Reply generates an appropriate response and escalates to qualified help
  • A UI is inaccessible to screen readers → Accessibility Audit scores it against WCAG 2.2 and provides remediation
  • Content uses stigmatising language → Safe Content Rewriter flags and rewrites harmful patterns
  • A conflict is escalating → De-escalation Plan generates structured, non-coercive guidance

Every skill includes:

  • Explicit safety boundaries — what the skill can and cannot do
  • Uncertainty disclosure — confidence level stated upfront (low/medium/high)
  • Evaluation gates — automated baseline checks for quality

These skills are rule-based and non-clinical — they do not provide diagnosis, treatment, or professional medical/legal advice.


Supported Platforms

OpenCode · Claude Code · Microsoft Copilot · Manus AI · OpenClaw · ChatGPT · Claude · Gemini


Contributing

git clone https://github.com/<your-username>/project_human.git
cd project_human
git checkout -b my-contribution
# Copy the skill template if adding a new skill:
cp -r templates/skill skills/my-skill-name
pnpm check && pnpm evals && pnpm test  # Run all checks before PR

Open a PR targeting main. Browse good first issues or read the Contributing Guide.

Error Fix
ERR_PNPM_OUTDATED_LOCKFILE Run pnpm install, then commit pnpm-lock.yaml
pnpm: command not found npm install -g pnpm
pnpm evals fails EVAL_REPORT=1 pnpm evals — see evals/reports/latest.md

Resources

License

MIT — see LICENSE.


A Humanity4AI project by Ascent Partners Foundation.

If this saves you time, a ⭐ on GitHub helps others find it.

Reviews (0)

No results found