project-human

@humanity4ai/mcp-servers

Humanity4AI のスキル向け MCP アクションコントラクトとサーバーランタイムです。

9 つすべての humanity スキルが、公式の @modelcontextprotocol/sdk JSON-RPC 2.0 プロトコルを使用する標準 MCP ツールとして公開されています。Claude Code、Copilot、Manus AI、OpenCode、LangChain、およびその他すべての MCP SDK クライアントとネイティブに互換性があります。

---

AI エージェント向けクイックスタート

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 から検出できます。

Streamable HTTP トランスポートを使用するリモートエンドポイント https://humanity4ai.ascent.partners/api/mcp も利用できます。クローンは不要です。

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	ニューロダイバーシティに配慮したデザイン	ADHD、自閉症、ディスレクシア、感覚過敏に配慮して UI を監査します
age_inclusive_design_check	年齢を問わず利用しやすいデザイン	年齢に配慮したデザインになっているか、ユーザーフローを監査します

---

プロトコル

サーバーは公式の @modelcontextprotocol/sdk を使用し、2 種類のトランスポートを介して 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/ ディレクトリには、各アクションのリクエストとレスポンスの完全なペアが 1 つずつ含まれています。

ファイル	アクション
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 Registry への登録（mcp-publisher）