Humsana MCP

🚀 @humsana/mcp-server

AI支援開発における認知的セキュリティを提供します。

🛡️ "ターミナルの呼気アルコール検査器"

Humsanaは、疲労しているときに危険なコマンドを実行したり、AIによる大規模なコード書き換えを受け入れたりすることを防ぎます。これは、あなたの脳のための産業用安全インターロックのようなものです。

🚀 クイックスタート

1. デーモンのインストール

pip install humsana-daemon
humsana start

このデーモンをターミナルのタブで実行し続けてください。

2. MCPサーバーのインストール

npm install -g @humsana/mcp-server

3. Claude Desktopの設定

~/Library/Application Support/Claude/claude_desktop_config.jsonを作成または編集します。

{
  "mcpServers": {
    "humsana": {
      "command": "node",
      "args": ["/path/to/humsana-mcp/dist/index.js"]
    }
  }
}

4. Claude Desktopの再起動

(Cmd+Q)で終了し、再度開きます。

5. テスト

Claudeに「What's my current state?」と尋ねてください。

✨ 主な機能

コマンド保護 (safe_execute_command)

AI書き換え保護 (safe_write_file)

🔧 実行モード

Humsanaは安全のためにドライランモードで起動します。コマンドはシミュレートされ、実行されません。

ドライランモード (デフォルト)

✅ [DRY RUN] セーフティチェックに合格しました。
コマンド: `kubectl delete pods`
このコマンドは実行されるはずでした。
(ドライランモードが有効なため、実行はスキップされました)

ライブモードへの切り替え

システムを信頼するようになったら、実際の実行を有効にします。

ステップ1: ~/.humsana/config.yamlを作成または編集します。

# これを 'dry_run' から 'live' に変更します
execution_mode: live

# オプション: しきい値を調整します
fatigue_threshold: 70
write_warn_threshold: 30
write_block_threshold: 50

ステップ2: Claude Desktopを再起動します (Cmd+Q、再開)

ステップ3: まず安全なコマンドでテストします。

Run `echo "live mode working"`

「WOULD have been executed.」ではなく、実際の出力が表示されるはずです。

📚 詳細ドキュメント

設定リファレンス

~/.humsana/config.yamlを作成します。

# === 実行モード ===
# 'dry_run' (デフォルト) - コマンドをシミュレートし、何も実行しません
# 'live' - 実際にコマンドを実行し、ファイルを書き込みます
execution_mode: dry_run

# === 疲労しきい値 ===
# 危険なコマンドがブロックされる疲労レベル (0-100)
fatigue_threshold: 70

# 警告をトリガーする削除行数 (疲労している場合)
write_warn_threshold: 30

# ハードブロックをトリガーする削除行数 (疲労している場合)
write_block_threshold: 50

# === カスタムパターン ===
# ブロックする追加の危険なコマンド
deny_patterns:
  - "aws ec2 terminate"
  - "docker rm -f"

# === 通知 ===
# Slack/PagerDuty用のWebhook (セーフティオーバーライド時に発火)
webhook_url: https://hooks.slack.com/services/XXX/YYY/ZZZ

オーバーライドプロトコル

ブロックされた場合は、以下のように入力します。

OVERRIDE SAFETY PROTOCOL: [理由]

例:

OVERRIDE SAFETY PROTOCOL: P0 production outage, need to restart pods

これは~/.humsana/audit.jsonにログ記録され、Webhookに送信されます。

利用可能なツール

ファイルとフォルダ

プライバシー

🔒 100% ローカル

• すべてのデータはあなたのマシン上に留まります
• ネットワーク呼び出しはありません (オプションのWebhookを除く)
• テレメトリやトラッキングはありません
• 完全に監査可能なオープンソースコード

トラブルシューティング

"Daemon not running" エラー

ターミナルでデーモンを起動します。

humsana start

コマンドが実行されない場合

モードを確認します。

cat ~/.humsana/config.yaml | grep execution_mode

dry_runと表示される場合は、liveに変更してClaudeを再起動します。

MCPが接続しない場合

Claude Desktopの設定パスを確認します。

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• dist/index.jsのパスが正しいことを確認してください。

📄 ライセンス

MIT