AI Context Inspector

@cocaxcode/ai-context-inspector

一条命令，即刻查看项目中的所有 AI 配置。
CLI + MCP 服务 · 检测到 19 种工具 · 支持在 7 个目标之间导出/导入

快速开始 · MCP 服务 · 检测内容 · 功能 · 工具参考 · 架构

这是目前最全面的 AI 生态扫描器。AI Context Inspector 可在 19 种工具中发现项目里的所有 AI 配置文件、MCP 服务、自定义技能、Agent 和持久化记忆，并在几秒内呈现完整情况。你可以导出整个 AI 配置，并将其导入 7 种受支持的工具（Claude、Cursor、Windsurf、Copilot、Gemini、Codex、OpenCode），同时自动清除机密信息。无需配置。除了 MCP SDK 和 Zod 外，没有运行时依赖。所有操作都在本地运行——你的配置和凭据绝不会离开你的计算机。

快速开始

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

就这么简单。HTML 仪表板会打开，展示你的 AI 工具对项目所了解的一切。

# 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/ 中的自定义 Agent，并检测记忆
• 持久记忆——Claude Memory、Agent 记忆、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

注意： 密钥处理有三种模式：none（全部脱敏，便于安全分享）、all（按原样包含）或 interactive（逐个变量提示，CLI 默认值）。会自动检测 MCP 配置中的环境变量。

MCP 工具参考

作为 MCP 服务运行时（--mcp），会公开五个工具：

scan

发现项目目录中的完整 AI 生态系统。

introspect_mcp

连接到指定的 MCP 服务，并列出其工具、资源和提示词。

*必须提供 command（stdio）或 url（http）之一。

generate_report

根据扫描结果生成独立的 HTML 仪表板。

export_ecosystem

将完整的 AI 生态系统导出到可移植的 .aci/bundle.json。

import_ecosystem

将捆绑包导入项目，并根据目标工具调整配置。

警告： 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