project-human

@humanity4ai/mcp-servers

Humanity4AI 技能的 MCP 操作契约和服务运行时。

全部 9 项 humanity 技能均以标准 MCP 工具的形式提供，采用官方 @modelcontextprotocol/sdk JSON-RPC 2.0 协议，可原生兼容 Claude Code、Copilot、Manus AI、OpenCode、LangChain，以及任何其他 MCP SDK 客户端。

---

面向 AI Agent 的快速入门

1. 克隆并安装

git clone https://github.com/humanity4ai/project_human.git
cd project_human
pnpm install

2. 启动 MCP 服务

pnpm start
# or directly:
pnpm --filter @humanity4ai/mcp-servers start

服务使用官方 MCP SDK JSON-RPC 2.0 协议，通过 stdio 启动。 全部 9 项 humanity 技能均已注册为 MCP 工具，可通过 tools/list 发现。

此外，还提供了一个远程端点 https://humanity4ai.ascent.partners/api/mcp，使用 Streamable HTTP 传输，无需克隆即可使用。

3. 配置 MCP 客户端

本地（stdio）：

将以下内容添加到 MCP 客户端配置中（例如 claude_desktop_config.json、.cursor/mcp.json、opencode.json）：

{
  "mcpServers": {
    "humanity4ai": {
      "command": "pnpm",
      "args": ["--filter", "@humanity4ai/mcp-servers", "start"],
      "cwd": "/path/to/project_human"
    }
  }
}

也可以在发布到 npm 后使用 npx（无需本地克隆）：

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

远程（Streamable HTTP）：

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

---

可用工具（9 项技能）

工具名称	技能	描述
accessibility_audit	WCAG 无障碍审核	审核网页是否符合 WCAG 2.2（爬取网页），或设置会话的 WCAG 级别
rewrite_depression_sensitive_content	抑郁症敏感内容	审核或改写文本，确保其符合心理健康敏感性要求
supportive_reply	支持性对话	生成支持性、非临床的回复并提供升级指导；包含悲伤支持模式（陪伴、实用建议、反思）
cognitive_accessibility_audit	认知无障碍	审核内容的认知负荷和简明语言合规性
cultural_context_check	文化敏感性	检查消息是否存在文化敏感性问题
deescalation_plan	冲突降级	生成结构化的降级计划
empathetic_reframe	共情沟通	以真诚共情的方式改写消息
neurodiversity_design_check	神经多样性友好设计	审核 UI 是否考虑 ADHD、自闭症、阅读障碍和感官敏感性
age_inclusive_design_check	年龄包容性设计	审核用户流程是否符合年龄包容性设计要求

---

协议

此服务使用官方 @modelcontextprotocol/sdk，通过两种传输方式使用 JSON-RPC 2.0 进行通信：

• stdio — 本地进程（克隆并运行、npx、Docker）
• Streamable HTTP — 远程部署（Vercel、无状态模式）

工具发现：

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

工具调用：

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"empathetic_reframe","arguments":{"message":"I failed the exam I studied so hard for","tone":"warm"}}}

---

安全边界

每个工具响应都包含 boundaryNotice 字段。请始终向用户展示此字段：

• accessibility_audit — 仅提供合规指导，不能替代法律审查
• rewrite_depression_sensitive_content — 仅提供非临床的 UX/内容指导
• supportive_reply — 提供非临床支持；风险升高时必须升级处理（包含悲伤支持模式）
• cognitive_accessibility_audit — 仅提供设计指导
• cultural_context_check — 提供考虑语境的建议，并披露不确定性
• deescalation_plan — 不采用胁迫手段
• empathetic_reframe — 不进行操纵或虚假共情
• neurodiversity_design_check — 仅提供包容性设计指导
• age_inclusive_design_check — 仅提供包容性设计指导

---

使用软件包

pnpm add @humanity4ai/mcp-servers
# or
npm install @humanity4ai/mcp-servers

以编程方式导入契约：

import { actionContracts, validateContracts } from "@humanity4ai/mcp-servers";
const contracts = validateContracts(actionContracts);

---

示例

examples/ 目录中为每项操作提供了一个完整的请求/响应对：

文件	操作
examples/accessibility_audit.example.json	accessibility_audit
examples/rewrite_depression_sensitive_content.example.json	rewrite_depression_sensitive_content
examples/supportive_reply.example.json	supportive_reply
examples/cognitive_accessibility_audit.example.json	cognitive_accessibility_audit
examples/cultural_context_check.example.json	cultural_context_check
examples/deescalation_plan.example.json	deescalation_plan
examples/empathetic_reframe.example.json	empathetic_reframe
examples/neurodiversity_design_check.example.json	neurodiversity_design_check
examples/age_inclusive_design_check.example.json	age_inclusive_design_check

---

路线图

• 远程部署的身份验证策略和速率控制
• 遥测和评估钩子
• 超越结构检查的丰富场景评分
• MCP 注册表上架（mcp-publisher）