🛡️ Scan Your AI Toolkit

オープンソースのAIガバナンスツール群。それぞれがMCPサーバーまたはCLIとして単独で動作し、連携することでガバナンスメッシュを形成します。

scan_your_ai_toolkit MCP server

CodeQL npm scope License MCP Conformance PRs Welcome

Maiife（エンタープライズAIコントロールプレーン）によって構築されました。

ツール

パッケージ	説明	公開済み
`@maiife-ai-pub/shared`	すべてのツールキットパッケージで使用される共有型およびフォーマッタ	✅
`@maiife-ai-pub/probe`	AI環境スキャナー — IDE拡張機能、MCPサーバー、エージェントフレームワーク、APIキー、ローカルモデルの検出	✅
`@maiife-ai-pub/mcp-audit`	MCPサーバーセキュリティスキャナー — 権限、データの機密性、影響範囲に基づく設定のスコアリング	✅
`@maiife-ai-pub/ai-stack`	「あなたのAIスタックは何ですか？」 — AIツールキットの共有可能なプロフィールカード	✅
`@maiife-ai-pub/mcp-doctor`	MCPヘルスチェックおよび自動修正ツール — MCPセットアップのための「brew doctor」	✅
`@maiife-ai-pub/ai-journal`	個人のAI利用日記 — AIの利用状況を追跡し、振り返りのインサイトを取得	✅
`@maiife-ai-pub/context-sync`	ツール間AIメモリ同期 — Cursor、Claude、MCP間で同期される単一の `context.json`	✅
`@maiife-ai-pub/prompt-score`	プロンプト品質アナライザー — AIプロンプトのスコアリング、改善、およびリント	✅
`@maiife-ai-pub/eval`	LLM-as-judge評価エンジン — 構造化されたルーブリックによるエージェント出力のスコアリング	✅
`@maiife-ai-pub/trace`	エージェントワークフロートレーサー — 実行スパンのトレース、表示、分析	✅
`@maiife-ai-pub/cost`	AI支出計算機 + 最適化ツール — ベンダー横断的な統合コストレポート	✅
`@maiife-ai-pub/prompt-craft`	ゲーミフィケーションされたプロンプトコーチ — プロンプト改善のためのレベル、ストリーク、バッジ	✅
`@maiife-ai-pub/sub-audit`	個人のAIサブスクリプション監査ツール — AI支出の無駄を発見	✅
`@maiife-ai-pub/model-match`	個人のモデルレコメンダー — あなたのタスクに最適なモデルを見つける	✅
`@maiife-ai-pub/weekly-ai-report`	AI週間レビュー — あなたのAI利用状況を毎週振り返る「Spotify Wrapped」のようなレポート	✅

クイックスタート

# Scan your AI environment
npx @maiife-ai-pub/probe scan

# Audit your MCP server security
npx @maiife-ai-pub/mcp-audit scan

# Generate your AI Stack profile card
npx @maiife-ai-pub/ai-stack --format svg --output my-stack.svg

# Health check your MCP servers
npx @maiife-ai-pub/mcp-doctor check

# Log an AI interaction
npx @maiife-ai-pub/ai-journal log --tool claude --task coding --duration 30

# Sync AI context across tools
npx @maiife-ai-pub/context-sync push

# Score your AI prompts
npx @maiife-ai-pub/prompt-score analyze --input prompt.txt

# Evaluate agent outputs with rubrics
npx @maiife-ai-pub/eval score --rubric code-review --input review.txt

# Trace agent workflows
npx @maiife-ai-pub/trace list --days 7

# Track AI spend across vendors
npx @maiife-ai-pub/cost report --period last-30d

# Gamified prompt coaching
npx @maiife-ai-pub/prompt-craft score --input prompt.txt

# Audit AI subscriptions for waste
npx @maiife-ai-pub/sub-audit

# Find the best model for your tasks
npx @maiife-ai-pub/model-match recommend --task coding

# Generate your AI week in review
npx @maiife-ai-pub/weekly-ai-report generate

MCPサーバーとしての利用

MCPサーバーを備えたすべてのツールは、Claude Desktop、Cursor、またはMCP互換クライアントに追加できます。それぞれがstdioトランスポートを介してツールを公開します。

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) または %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "maiife-probe": {
      "command": "npx",
      "args": ["@maiife-ai-pub/probe", "mcp"]
    },
    "maiife-mcp-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-audit", "mcp"]
    },
    "maiife-mcp-doctor": {
      "command": "npx",
      "args": ["@maiife-ai-pub/mcp-doctor", "mcp"]
    },
    "maiife-eval": {
      "command": "npx",
      "args": ["@maiife-ai-pub/eval", "mcp"]
    },
    "maiife-prompt-score": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-score", "mcp"]
    },
    "maiife-prompt-craft": {
      "command": "npx",
      "args": ["@maiife-ai-pub/prompt-craft", "mcp"]
    },
    "maiife-cost": {
      "command": "npx",
      "args": ["@maiife-ai-pub/cost", "mcp"]
    },
    "maiife-model-match": {
      "command": "npx",
      "args": ["@maiife-ai-pub/model-match", "mcp"]
    },
    "maiife-ai-stack": {
      "command": "npx",
      "args": ["@maiife-ai-pub/ai-stack", "mcp"]
    },
    "maiife-context-sync": {
      "command": "npx",
      "args": ["@maiife-ai-pub/context-sync", "mcp"]
    },
    "maiife-sub-audit": {
      "command": "npx",
      "args": ["@maiife-ai-pub/sub-audit", "mcp"]
    },
    "maiife-trace": {
      "command": "npx",
      "args": ["@maiife-ai-pub/trace", "mcp"]
    }
  }
}

必要なツールを選択してください。すべてを追加する必要はありません。設定が完了すると、Claudeは probe_scan、mcp_audit_scan、eval_score、prompt_score_analyze、cost_report などのツールをチャットから直接呼び出せるようになります。

Dockerでの実行

各MCPサーバーは、GHCR上のDockerイメージとして公開されています。サンドボックス環境やGlamaとの統合に便利です。

# Pull and run any server
docker run -i ghcr.io/sakthivelchan89/maiife-probe
docker run -i ghcr.io/sakthivelchan89/maiife-mcp-audit
docker run -i ghcr.io/sakthivelchan89/maiife-eval
# ... same pattern for all 12 packages

# Or build from source
docker build -f packages/probe/Dockerfile -t maiife-probe .
docker run -i maiife-probe

Dockerイメージはstdioトランスポートを使用します（ポートは公開されません）。MCPクライアントとの対話的なstdin/stdout通信には -i を渡してください。

品質とコンプライアンス

このツールキットは、MCP Tier 1 品質基準（MCP SEP-1730 に準拠）を満たすことを目指しています。その意味は以下の通りです：

ディメンション	ステータス
ライセンス	Apache 2.0 — 標準的なSPDX、OSI承認済み
トランスポート	stdioのみ（ネットワーク公開なし）
CI/CD	GitHub Actions: Node 18, 20, 22 でのリント + 型チェック + テスト
テストカバレッジ	vitest + `@vitest/coverage-v8`、パッケージごとにレポート
MCP適合性	12個のMCPサーバーすべてに対するプロトコル適合性スイート
セキュリティスキャン	CodeQL（毎週 + PR時）、Dependabot（毎週）
脆弱性対応	CRITICALは48時間以内 / HIGHは7日以内（DEPENDENCY_POLICY.md を参照）
課題トリアージSLA	2営業日（CONTRIBUTING.md を参照）
バージョニング	SemVer、パッケージ間でのロックステップ、CHANGELOG.md
サプライチェーン	`pnpm-lock.yaml` をコミット済み、CIで `--frozen-lockfile` を使用
コンテナセキュリティ	非rootユーザー、ポート公開なし、GHCR署名済み

適合性テストスイート

このリポジトリ内のすべてのMCPサーバーは、MCPプロトコル契約に対して検証されています：

✅ stdioトランスポート不変条件（stdoutへの非JSON出力なし）
✅ initialize ハンドシェイクが有効な serverInfo + 機能で応答する
✅ tools/list が文書化されたツールセットを返す
✅ すべてのツール inputSchema フィールドが有効なJSON Schemaオブジェクトである
✅ 未知のツール呼び出しが（クラッシュではなく）構造化されたエラーを返す

スイートの実行:

pnpm test:conformance      # all packages
cd packages/probe && pnpm test:conformance   # single package

ドキュメント

SECURITY.md — 脆弱性報告ポリシー
CONTRIBUTING.md — 課題/PRガイドラインおよびSLA
CHANGELOG.md — バージョン履歴（Keep a Changelog形式）
DEPENDENCY_POLICY.md — 依存関係の選択基準およびパッチSLA

コントリビューション

コントリビューションを歓迎します！完全なガイドについては CONTRIBUTING.md をお読みください。クイックバージョン：

GitHubでリポジトリを フォーク する
ブランチを作成: git checkout -b feat/my-improvement
変更を加える — 各パッケージは packages/<name>/ にあります
テストを実行: pnpm test && pnpm test:conformance
main に対して PRを開く — 何を変更したか、なぜ変更したかを説明してください

既存のコードスタイル（TypeScript、ESM、テストにはVitest）に従ってください。各パッケージは、該当する場合、CLIとMCPサーバーの両方として機能する必要があります。

ライセンス

Apache 2.0 — 自由に使用、変更、配布できます。

Maiife プラットフォームの一部 — エンタープライズAIコントロールプレーン。

scan_your_ai_toolkit