AI Context Inspector

@cocaxcode/ai-context-inspector

1つのコマンドで、プロジェクト内のすべての AI 設定を即座に確認できます。
CLI + MCP サーバー · 19 個のツールを検出 · 7 つの対象にエクスポート／インポート

クイックスタート · MCP サーバー · 検出対象 · 機能 · ツールリファレンス · アーキテクチャ

利用可能な中で最も包括的な AI エコシステムスキャナーです。AI Context Inspector は、プロジェクト内のあらゆる AI 設定ファイル、MCP サーバー、カスタムスキル、エージェント、永続メモリを 19 個のツールにわたって検出し、数秒で全体像を提示します。AI 環境全体をエクスポートし、自動的なシークレットの秘匿化を行いながら、対応する 7 つのツール（Claude、Cursor、Windsurf、Copilot、Gemini、Codex、OpenCode）のいずれにもインポートできます。設定は不要です。MCP SDK と Zod 以外のランタイム依存関係もありません。すべてローカルで実行されるため、設定や認証情報がマシンの外に出ることはありません。

クイックスタート

npx -y @cocaxcode/ai-context-inspector@latest

これだけです。AI ツールがプロジェクトについて把握している内容をすべてまとめた HTML ダッシュボードが開きます。

# Scan a specific directory
npx -y @cocaxcode/ai-context-inspector@latest --dir /path/to/project

# Include user-level configs (~/.claude, ~/.gemini, etc.)
npx -y @cocaxcode/ai-context-inspector@latest --user

# Live-connect to each MCP server and list its tools
npx -y @cocaxcode/ai-context-inspector@latest --introspect

# Output raw JSON instead of HTML
npx -y @cocaxcode/ai-context-inspector@latest --json

MCP サーバーのセットアップ

MCP サーバーとして実行すると、AI ツールが独自のエコシステムを調査できます。

Claude Code

claude mcp add --scope user ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcp

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "ai-context-inspector": {
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

{
  "mcpServers": {
    "ai-context-inspector": {
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

{
  "servers": {
    "ai-context-inspector": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

codex mcp add ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcp

または、任意の .mcp.json に直接追加します。

{
  "mcpServers": {
    "ai-context-inspector": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

検出対象

ヒント： --user を渡すと、ユーザーレベルの設定もスキャンされます：~/.claude/、~/.gemini/、~/.codex/、~/.continue/、~/.aider.conf.yml、~/.augment/、~/.github/agents/、~/.codeium/、~/.opencode/、~/.tabnine/。

コンテキストファイルに加えて、スキャナーは以下も検出します：

• MCP サーバー：.mcp.json、~/.claude.json、.vscode/mcp.json、Claude Desktop の設定から検出（ライブでのイントロスペクションも任意で実行可能）
• カスタムスキル：.claude/skills/ 内（npx skills add によるシンボリックリンクを含む）
• カスタムエージェント：メモリ検出機能付きで .claude/agents/ 内を検出
• 永続メモリ：Claude Memory、エージェントメモリ、engram、OpenSpec、ATL

機能

スキャン

npx -y @cocaxcode/ai-context-inspector@latest
npx -y @cocaxcode/ai-context-inspector@latest --user --introspect

ダーク／ライトモード、検索、折りたたみ可能なセクション、ファイルのプレビュー、色分けされたツールバッジを備えた、単体で動作する HTML ダッシュボードを生成します。生の出力を取得するには --json を渡します。

エクスポート

# Export your AI ecosystem to .aci/bundle.json
npx -y @cocaxcode/ai-context-inspector@latest export

# Export only MCP and context configs, redact secrets
npx -y @cocaxcode/ai-context-inspector@latest export --only mcp,context --secrets none

インポート

# Import into a Cursor project
npx -y @cocaxcode/ai-context-inspector@latest import --target cursor

# Auto-detect tool, skip confirmation, overwrite existing
npx -y @cocaxcode/ai-context-inspector@latest import --yes --force

Note: シークレットの処理には、none（すべてを秘匿化 — 安全に共有できます）、all（そのまま含める）、interactive（変数ごとに確認する。CLI のデフォルト）の 3 つのモードがあります。MCP 設定内の環境変数は自動的に検出されます。

MCP ツールリファレンス

MCP サーバーとして実行すると（--mcp）、5 つのツールが公開されます。

scan

プロジェクトディレクトリ内の AI エコシステム全体を検出します。

introspect_mcp

特定の MCP サーバーに接続し、そのツール、リソース、プロンプトを一覧表示します。

*command（stdio）または url（http）のいずれかが必要です。

generate_report

スキャン結果からスタンドアロンの HTML ダッシュボードを生成します。

export_ecosystem

AI エコシステム全体を、移植可能な .aci/bundle.json にエクスポートします。

import_ecosystem

バンドルをプロジェクトにインポートし、対象ツールに合わせて設定を調整します。

Warning: import_ecosystem はデフォルトでドライランモード（confirm: false）です。実際にファイルを書き込むには、confirm: true を設定してください。

Architecture

src/
├── index.ts              # Entry: CLI vs MCP mode routing
├── cli.ts                # CLI arg parsing + orchestration
├── server.ts             # createServer() MCP factory
├── scanner/              # 6 parallel scanners (Promise.all)
│   ├── catalog.ts        # AI_FILE_CATALOG — 50+ entries, 19 tools
│   ├── context-files.ts  # Scan .md, rules, configs
│   ├── mcp-configs.ts    # Parse .mcp.json, ~/.claude.json, etc.
│   ├── mcp-introspect.ts # Connect to servers, list tools/resources
│   ├── skills.ts         # Skills + symlinks + frontmatter
│   ├── agents.ts         # Agents + memory detection
│   └── memories.ts       # engram, openspec, .atl, claude memory
├── ecosystem/            # Export/import engine
│   ├── export.ts         # Scan → bundle → .aci/bundle.json
│   ├── import.ts         # Load → plan → execute
│   ├── target-map.ts     # Path configs for 7 AI tools
│   ├── detect-target.ts  # Auto-detect tool in project
│   └── secrets.ts        # Env var detection + redaction
├── report/               # HTML dashboard generator
│   ├── generator.ts      # generateHtml(ScanResult) → string
│   ├── sections.ts       # Section renderers
│   ├── styles.ts         # CSS (dark/light)
│   └── scripts.ts        # JS (collapse, search, preview)
└── tools/                # 5 MCP tool handlers
    ├── scan.ts
    ├── introspect.ts
    ├── report.ts
    ├── export.ts
    └── import.ts

Stack: TypeScript 5 (strict, ESM) / MCP SDK / Zod / tsup / Vitest

MIT · Built by cocaxcode