@cocaxcode/ai-context-inspector 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +126 -0
- package/dist/chunk-6HBCUZQJ.js +1565 -0
- package/dist/index.js +112 -0
- package/dist/server-6EILEUO5.js +177 -0
- package/package.json +74 -0
package/README.md
ADDED
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# @cocaxcode/ai-context-inspector
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/@cocaxcode/ai-context-inspector)
|
|
4
|
+
[]()
|
|
5
|
+
[]()
|
|
6
|
+
[]()
|
|
7
|
+
|
|
8
|
+
**Escanea cualquier proyecto para descubrir su ecosistema AI completo.** MCP servers, tools, archivos de contexto, skills, memorias — todo en un dashboard HTML interactivo.
|
|
9
|
+
|
|
10
|
+
## El problema
|
|
11
|
+
|
|
12
|
+
Tu proyecto tiene archivos de configuración AI dispersos: `CLAUDE.md`, `.cursorrules`, `.mcp.json`, `.windsurfrules`, `GEMINI.md`, `.github/copilot-instructions.md`... y no sabes exactamente qué tienes disponible ni qué tools exponen tus MCP servers.
|
|
13
|
+
|
|
14
|
+
## La solución
|
|
15
|
+
|
|
16
|
+
```bash
|
|
17
|
+
npx @cocaxcode/ai-context-inspector
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Genera un **dashboard HTML interactivo** que muestra:
|
|
21
|
+
- Todos los archivos de configuración AI encontrados (13 herramientas soportadas)
|
|
22
|
+
- MCP servers configurados con sus tools, resources y prompts (introspección real)
|
|
23
|
+
- Skills disponibles
|
|
24
|
+
- Sistemas de memoria (engram, openspec, .atl)
|
|
25
|
+
|
|
26
|
+
## Instalacion
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
# Uso directo (sin instalar)
|
|
30
|
+
npx @cocaxcode/ai-context-inspector
|
|
31
|
+
|
|
32
|
+
# Instalar globalmente
|
|
33
|
+
npm install -g @cocaxcode/ai-context-inspector
|
|
34
|
+
|
|
35
|
+
# Como MCP server en tu proyecto
|
|
36
|
+
# .mcp.json:
|
|
37
|
+
{
|
|
38
|
+
"mcpServers": {
|
|
39
|
+
"ai-context-inspector": {
|
|
40
|
+
"command": "npx",
|
|
41
|
+
"args": ["-y", "@cocaxcode/ai-context-inspector", "--mcp"]
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Uso CLI
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
# Escanear directorio actual y generar HTML
|
|
51
|
+
npx @cocaxcode/ai-context-inspector
|
|
52
|
+
|
|
53
|
+
# Escanear otro directorio
|
|
54
|
+
npx @cocaxcode/ai-context-inspector --dir /path/to/project
|
|
55
|
+
|
|
56
|
+
# Output JSON (para pipes o programatico)
|
|
57
|
+
npx @cocaxcode/ai-context-inspector --json
|
|
58
|
+
|
|
59
|
+
# Sin conectar a MCP servers (solo archivos)
|
|
60
|
+
npx @cocaxcode/ai-context-inspector --no-introspect
|
|
61
|
+
|
|
62
|
+
# Incluir configuracion del usuario (~/.claude/, ~/.gemini/, etc.)
|
|
63
|
+
npx @cocaxcode/ai-context-inspector --include-user
|
|
64
|
+
|
|
65
|
+
# Guardar en ruta personalizada
|
|
66
|
+
npx @cocaxcode/ai-context-inspector --output ./reports/scan.html
|
|
67
|
+
|
|
68
|
+
# Timeout personalizado para introspección MCP
|
|
69
|
+
npx @cocaxcode/ai-context-inspector --timeout 5000
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## Uso como MCP Server
|
|
73
|
+
|
|
74
|
+
Cuando se ejecuta con `--mcp`, expone 3 tools:
|
|
75
|
+
|
|
76
|
+
| Tool | Descripcion |
|
|
77
|
+
|------|-------------|
|
|
78
|
+
| `scan` | Escanea un proyecto y retorna todo el ecosistema AI como JSON |
|
|
79
|
+
| `introspect_mcp` | Introspecciona un MCP server específico por nombre |
|
|
80
|
+
| `generate_report` | Genera el dashboard HTML interactivo |
|
|
81
|
+
|
|
82
|
+
## Herramientas AI Soportadas (13)
|
|
83
|
+
|
|
84
|
+
| Herramienta | Archivos detectados |
|
|
85
|
+
|-------------|-------------------|
|
|
86
|
+
| **Claude** | CLAUDE.md, .claude/, .mcp.json |
|
|
87
|
+
| **Cursor** | .cursorrules, .cursor/rules/, .cursorignore |
|
|
88
|
+
| **Windsurf** | .windsurfrules, .windsurf/rules/ |
|
|
89
|
+
| **GitHub Copilot** | .github/copilot-instructions.md, .github/instructions/, .github/agents/ |
|
|
90
|
+
| **Gemini** | GEMINI.md, .gemini/ |
|
|
91
|
+
| **OpenAI Codex** | AGENTS.md, AGENT.md, .codex/ |
|
|
92
|
+
| **Aider** | .aider.conf.yml, .aiderignore |
|
|
93
|
+
| **Cline** | .clinerules, .clineignore |
|
|
94
|
+
| **Continue** | ~/.continue/ |
|
|
95
|
+
| **Amazon Q** | .amazonq/rules/ |
|
|
96
|
+
| **Augment** | .augment/rules/, .augment-guidelines |
|
|
97
|
+
| **Replit** | .replit.md |
|
|
98
|
+
| **Firebase Studio** | .idx/airules.md |
|
|
99
|
+
|
|
100
|
+
Ademas detecta: `.vscode/mcp.json`, `CONVENTIONS.md`, y configuraciones a nivel de usuario (`~/.claude/`, `~/.gemini/`, etc.)
|
|
101
|
+
|
|
102
|
+
## Dashboard HTML
|
|
103
|
+
|
|
104
|
+
El dashboard generado es un archivo HTML single-file:
|
|
105
|
+
- **Zero dependencias externas** — funciona offline, sin servidor
|
|
106
|
+
- **Dark/Light mode** automatico (respeta prefers-color-scheme)
|
|
107
|
+
- **Busqueda global** — filtra tools, archivos y skills
|
|
108
|
+
- **Secciones colapsables** — navega rapido por el contenido
|
|
109
|
+
- **Preview de archivos** — ve el contenido sin abrir el editor
|
|
110
|
+
|
|
111
|
+
## Arquitectura
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
Scanner modular → ScanResult (JSON) → HTML Dashboard
|
|
115
|
+
↑ ↑ ↑
|
|
116
|
+
5 scanners Usado por CLI Template literals
|
|
117
|
+
en paralelo y MCP tools CSS/JS inline
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
- **33 tests** | **3 MCP tools** | **13 AI tools** | **40+ archivos detectados**
|
|
121
|
+
- TypeScript 5.x + ESM + Node 20+
|
|
122
|
+
- Zero runtime dependencies beyond MCP SDK + Zod
|
|
123
|
+
|
|
124
|
+
## License
|
|
125
|
+
|
|
126
|
+
MIT
|