project-mcp-server 2.0.0

package/dist/tools/project/index.js

@@ -0,0 +1,193 @@
+import { z } from "zod";
+import { scanRoutes } from "../../scanner/routes.js";
+import { scanActions } from "../../scanner/actions.js";
+import { scanPrismaSchemas } from "../../scanner/prisma.js";
+import { scanComponents } from "../../scanner/components.js";
+import { invalidate } from "../../scanner/cache.js";
+import { config } from "../../config.js";
+export function registerProjectTools(server) {
+    // ─── project_scan ──────────────────────────────────────────────────────────
+    server.registerTool("project_scan", {
+        title: "Escanear proyecto completo",
+        description: `Escanea el proyecto y devuelve un resumen de rutas, Server Actions,
+schemas de Prisma y componentes instalados. Útil al inicio de una sesión
+para tener el mapa completo del proyecto.
+
+Returns: resumen con conteos y listado de entidades por categoría.`,
+        inputSchema: z.object({
+            force_refresh: z.boolean().default(false)
+                .describe("Forzar re-escaneo ignorando el cache")
+        }).strict(),
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false }
+    }, async ({ force_refresh }) => {
+        if (force_refresh)
+            invalidate();
+        const [routes, actions, models, components] = await Promise.all([
+            scanRoutes(),
+            scanActions(),
+            scanPrismaSchemas(),
+            scanComponents()
+        ]);
+        const summary = {
+            projectRoot: config.projectRoot,
+            routes: {
+                total: routes.length,
+                pages: routes.filter(r => r.type === "page").length,
+                apiHandlers: routes.filter(r => r.type === "route-handler").length,
+                dynamic: routes.filter(r => r.dynamicParams.length > 0).length,
+                clientComponents: routes.filter(r => r.rendering === "client").length
+            },
+            actions: {
+                total: actions.length,
+                withAuth: actions.filter(a => a.hasAuth).length,
+                withZod: actions.filter(a => a.zodSchema).length
+            },
+            prisma: {
+                totalModels: models.length,
+                bySchema: Object.fromEntries([...new Set(models.map(m => m.schema))].map(s => [
+                    s, models.filter(m => m.schema === s).length
+                ]))
+            },
+            components: {
+                shadcnInstalled: components.ui.length,
+                custom: components.custom.length,
+                byFeature: Object.fromEntries([...new Set(components.custom.map(c => c.feature))].map(f => [
+                    f, components.custom.filter(c => c.feature === f).length
+                ]))
+            }
+        };
+        const text = [
+            `## Proyecto: ${config.projectRoot.split("/").pop()}`,
+            ``,
+            `### Rutas (${summary.routes.total})`,
+            `- Páginas: ${summary.routes.pages} · API handlers: ${summary.routes.apiHandlers}`,
+            `- Rutas dinámicas: ${summary.routes.dynamic} · Client components: ${summary.routes.clientComponents}`,
+            ``,
+            `### Server Actions (${summary.actions.total})`,
+            `- Con autenticación: ${summary.actions.withAuth} · Con validación Zod: ${summary.actions.withZod}`,
+            ``,
+            `### Prisma (${summary.prisma.totalModels} modelos)`,
+            ...Object.entries(summary.prisma.bySchema).map(([s, n]) => `- Schema ${s}: ${n} modelos`),
+            ``,
+            `### Componentes`,
+            `- shadcn/ui instalados: ${summary.components.shadcnInstalled}`,
+            `- Componentes propios: ${summary.components.custom}`,
+        ].join("\n");
+        return { content: [{ type: "text", text }], structuredContent: summary };
+    });
+    // ─── project_routes ────────────────────────────────────────────────────────
+    server.registerTool("project_routes", {
+        title: "Listar rutas del proyecto",
+        description: `Lista todas las rutas del App Router con sus propiedades.
+Útil para entender la estructura de navegación antes de crear una página nueva
+o agregar un route handler.
+
+Args:
+  - filter: filtrar por "pages", "api", o "all" (default)
+  - dynamic_only: mostrar solo rutas con parámetros dinámicos
+
+Returns: array de rutas con path, tipo, rendering, params dinámicos.`,
+        inputSchema: z.object({
+            filter: z.enum(["all", "pages", "api"]).default("all"),
+            dynamic_only: z.boolean().default(false)
+        }).strict(),
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false }
+    }, async ({ filter, dynamic_only }) => {
+        let routes = await scanRoutes();
+        if (filter === "pages")
+            routes = routes.filter(r => r.type === "page");
+        if (filter === "api")
+            routes = routes.filter(r => r.type === "route-handler");
+        if (dynamic_only)
+            routes = routes.filter(r => r.dynamicParams.length > 0);
+        const text = routes.map(r => {
+            const flags = [
+                r.rendering === "client" ? "client" : "rsc",
+                r.dynamicParams.length > 0 ? `[${r.dynamicParams.join(", ")}]` : null,
+                r.methods ? r.methods.join("|") : null,
+                r.hasLoading ? "loading" : null,
+                r.hasError ? "error" : null,
+            ].filter(Boolean).join(" · ");
+            return `${r.path}  ${flags}`;
+        }).join("\n");
+        return {
+            content: [{ type: "text", text: routes.length > 0 ? text : "No se encontraron rutas." }],
+            structuredContent: { routes, total: routes.length }
+        };
+    });
+    // ─── project_actions ───────────────────────────────────────────────────────
+    server.registerTool("project_actions", {
+        title: "Listar Server Actions",
+        description: `Lista todas las Server Actions del proyecto con sus schemas de validación.
+Útil antes de crear una nueva action para ver los patrones existentes
+y evitar duplicaciones.
+
+Returns: array de actions con nombre, archivo, schema Zod, parámetros y flags.`,
+        inputSchema: z.object({
+            feature: z.string().optional()
+                .describe("Filtrar por feature (ej: 'users', 'posts')")
+        }).strict(),
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false }
+    }, async ({ feature }) => {
+        let actions = await scanActions();
+        if (feature) {
+            actions = actions.filter(a => a.file.toLowerCase().includes(feature.toLowerCase()));
+        }
+        const text = actions.map(a => {
+            const flags = [
+                a.hasAuth ? "auth" : "no-auth",
+                a.zodSchema ? `zod:${a.zodSchema}` : "no-zod",
+                a.hasRevalidate ? "revalidates" : null
+            ].filter(Boolean).join(" · ");
+            return `${a.name}  (${a.file})  ${flags}`;
+        }).join("\n");
+        return {
+            content: [{ type: "text", text: actions.length > 0 ? text : "No se encontraron Server Actions." }],
+            structuredContent: { actions, total: actions.length }
+        };
+    });
+    // ─── project_models ────────────────────────────────────────────────────────
+    server.registerTool("project_models", {
+        title: "Listar modelos de Prisma",
+        description: `Lista todos los modelos de Prisma con sus campos y schema.
+Útil antes de crear una relación, migration, o Server Action
+para conocer la estructura exacta de los datos.
+
+Args:
+  - schema: filtrar por schema (auth | rbac | audit | base)
+  - model_name: buscar un modelo específico por nombre
+
+Returns: modelos con campos, tipos, relaciones y atributos.`,
+        inputSchema: z.object({
+            schema: z.enum(["auth", "rbac", "audit", "base"]).optional(),
+            model_name: z.string().optional()
+        }).strict(),
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+    }, async ({ schema, model_name }) => {
+        let models = await scanPrismaSchemas();
+        if (schema)
+            models = models.filter(m => m.schema === schema);
+        if (model_name)
+            models = models.filter(m => m.name.toLowerCase().includes(model_name.toLowerCase()));
+        const text = models.map(m => {
+            const fields = m.fields
+                .filter(f => !f.isRelation)
+                .map(f => `  ${f.name}: ${f.type}${f.isOptional ? "?" : ""}${f.isArray ? "[]" : ""}`)
+                .join("\n");
+            const relations = m.fields
+                .filter(f => f.isRelation)
+                .map(f => `  ${f.name} → ${f.type}`)
+                .join("\n");
+            return [
+                `### ${m.name} (@schema: ${m.schema})`,
+                fields,
+                relations ? `  --- relaciones ---\n${relations}` : ""
+            ].filter(Boolean).join("\n");
+        }).join("\n\n");
+        return {
+            content: [{ type: "text", text: models.length > 0 ? text : "No se encontraron modelos." }],
+            structuredContent: { models, total: models.length }
+        };
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/project/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "project-mcp-server",
+  "version": "2.0.0",
+  "description": "MCP server con inteligencia de proyecto, control de entorno y generación de código para Next.js + Prisma",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "project-mcp": "dist/index.js",
+    "project-mcp-setup": "dist/setup.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "setup": "node dist/setup.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fernandosecchi/project-mcp-server.git"
+  },
+  "keywords": ["mcp", "claude-code", "nextjs", "prisma", "ai-tools"],
+  "author": "Fernando Secchi",
+  "license": "MIT",
+  "files": ["dist", "skills", "README.md", "LICENSE"],
+  "engines": { "node": ">=20" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.9.0"
+  }
+}

package/skills/commit.md

@@ -0,0 +1,109 @@
+---
+name: commit
+description: "Activar cuando se hace un commit, se abre un Pull Request o se prepara un release"
+license: MIT
+metadata:
+  version: "1.0.0"
+---
+
+# Skill: Commits, PRs y releases
+
+## Cuándo cargar esta skill
+- Hacer un commit
+- Abrir o cerrar un Pull Request
+- Crear una release
+- Revisar el estado del repo
+
+---
+
+## Conventional Commits
+
+Formato: `tipo(scope): descripción en minúsculas`
+
+| Tipo | Cuándo usarlo |
+|---|---|
+| `feat` | Nueva feature visible para el usuario |
+| `fix` | Bugfix |
+| `refactor` | Cambio de código sin cambio de comportamiento |
+| `chore` | Configuración, deps, tooling |
+| `docs` | Solo documentación |
+| `test` | Solo tests |
+| `perf` | Mejora de performance |
+| `ci` | Cambios en CI/CD |
+
+```bash
+# Ejemplos correctos
+git commit -m "feat(auth): agregar login con credentials"
+git commit -m "fix(prisma): corregir query de roles en schema rbac"
+git commit -m "chore(deps): actualizar next a 16.1.0"
+git commit -m "refactor(users): extraer helper de permisos a lib/auth"
+
+# Breaking change
+git commit -m "feat(api)!: cambiar estructura de respuesta de /api/users"
+```
+
+---
+
+## Flujo de trabajo con ramas
+
+```bash
+# Nueva feature
+git checkout -b feat/nombre-descriptivo
+
+# Bugfix
+git checkout -b fix/descripcion-del-bug
+
+# Chore / refactor
+git checkout -b chore/descripcion
+
+# Ver estado antes de commitear
+git status
+git diff
+
+# Commitear
+git add .
+git commit -m "feat(scope): descripción"
+
+# Push
+git push origin feat/nombre-descriptivo
+```
+
+---
+
+## Antes de cada commit — checklist
+
+```bash
+# 1. Tipos correctos
+pnpm type-check
+
+# 2. Linting
+pnpm lint
+
+# 3. Si hay tests
+pnpm test
+
+# 4. Build (en PRs importantes)
+pnpm build
+```
+
+---
+
+## PR — descripción mínima esperada
+
+```markdown
+## ¿Qué hace este PR?
+Breve descripción del cambio.
+
+## Tipo de cambio
+- [ ] Nueva feature
+- [ ] Bugfix
+- [ ] Refactor
+- [ ] Chore
+
+## Checklist
+- [ ] `pnpm type-check` pasa
+- [ ] `pnpm lint` pasa
+- [ ] Tests actualizados (si aplica)
+- [ ] Migrations incluidas (si aplica)
+- [ ] Variables de entorno documentadas en .env.example (si aplica)
+```

package/skills/infra.md

@@ -0,0 +1,218 @@
+---
+name: infra
+description: "Activar cuando se trabaja con Docker, variables de entorno, setup de base de datos o configuracion del entorno de desarrollo"
+license: MIT
+metadata:
+  version: "1.0.0"
+---
+
+# Skill: Infra — Docker, variables de entorno, base de datos local
+
+## Cuándo cargar esta skill
+- Levantar o modificar servicios de Docker
+- Trabajar con variables de entorno
+- Setup inicial del proyecto
+- Troubleshooting de conexiones a DB
+
+---
+
+## Docker Compose — servicios locales
+
+```yaml
+# docker-compose.yml
+services:
+  postgres:
+    image: postgres:16-alpine
+    container_name: app_postgres
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-appuser}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-apppassword}
+      POSTGRES_DB: ${POSTGRES_DB:-appdb}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-appuser}"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  mysql:
+    image: mysql:5.7
+    container_name: app_mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-rootpassword}
+      MYSQL_DATABASE: ${MYSQL_DB:-legacydb}
+      MYSQL_USER: ${MYSQL_USER:-appuser}
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD:-apppassword}
+    ports:
+      - "3306:3306"
+    volumes:
+      - mysql_data:/var/lib/mysql
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  postgres_data:
+  mysql_data:
+```
+
+### Comandos Docker frecuentes
+
+```bash
+# Levantar todo en background
+docker compose up -d
+
+# Ver logs en vivo
+docker compose logs -f postgres
+docker compose logs -f mysql
+
+# Reiniciar un servicio
+docker compose restart postgres
+
+# Bajar todo (conserva volúmenes)
+docker compose down
+
+# Bajar y eliminar volúmenes (reset total de datos)
+docker compose down -v
+
+# Ver estado de los servicios
+docker compose ps
+```
+
+---
+
+## Variables de entorno
+
+```bash
+# .env.local (desarrollo local — no commitear)
+# .env.example (template — sí commitear, sin valores reales)
+
+# Base de datos PostgreSQL
+DATABASE_URL="postgresql://appuser:apppassword@localhost:5432/appdb"
+
+# Base de datos MySQL
+MYSQL_DATABASE_URL="mysql://appuser:apppassword@localhost:3306/legacydb"
+
+# NextAuth
+NEXTAUTH_SECRET="genera-con: openssl rand -base64 32"
+NEXTAUTH_URL="http://localhost:3000"
+
+# App
+NEXT_PUBLIC_APP_URL="http://localhost:3000"
+NODE_ENV="development"
+```
+
+### Generar NEXTAUTH_SECRET
+
+```bash
+openssl rand -base64 32
+# Pegar el resultado en NEXTAUTH_SECRET
+```
+
+### Validar variables de entorno al iniciar
+
+```typescript
+// lib/env.ts — validación con Zod al startup
+import { z } from "zod"
+
+const EnvSchema = z.object({
+  DATABASE_URL: z.string().url(),
+  MYSQL_DATABASE_URL: z.string().url(),
+  NEXTAUTH_SECRET: z.string().min(32),
+  NEXTAUTH_URL: z.string().url(),
+  NODE_ENV: z.enum(["development", "test", "production"]).default("development")
+})
+
+export const env = EnvSchema.parse(process.env)
+
+// Importar en lib/db/postgres.ts, lib/auth/config.ts, etc.
+// Si falta una variable, el error explota al iniciar → fail fast
+```
+
+---
+
+## Setup inicial completo
+
+```bash
+# 1. Instalar dependencias
+pnpm install
+
+# 2. Copiar variables de entorno
+cp .env.example .env.local
+# Editar .env.local con los valores correctos
+
+# 3. Levantar bases de datos
+docker compose up -d
+
+# Esperar a que estén ready (healthcheck)
+docker compose ps  # status debe ser "healthy"
+
+# 4. Correr migrations de Prisma
+pnpm prisma migrate dev
+
+# 5. Generar cliente Prisma
+pnpm prisma generate
+
+# 6. Correr seeds
+pnpm tsx prisma/seeds/roles.ts
+pnpm tsx prisma/seeds/admin-user.ts
+
+# 7. Iniciar dev server
+pnpm dev
+```
+
+---
+
+## Troubleshooting de conexiones
+
+```bash
+# PostgreSQL — verificar que acepta conexiones
+docker compose exec postgres pg_isready -U appuser
+
+# Conectarse con psql
+docker compose exec postgres psql -U appuser -d appdb
+
+# MySQL — verificar conexión
+docker compose exec mysql mysqladmin ping -h localhost -u appuser -p
+
+# Conectarse con mysql CLI
+docker compose exec mysql mysql -u appuser -p legacydb
+
+# Ver logs de error de conexión
+docker compose logs postgres | grep -i error
+docker compose logs mysql | grep -i error
+
+# Si Prisma no conecta — verificar DATABASE_URL
+pnpm prisma db pull  # Si conecta, lista las tablas existentes
+```
+
+---
+
+## Scripts útiles en package.json
+
+```json
+{
+  "scripts": {
+    "dev": "next dev --turbo",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "type-check": "tsc --noEmit",
+    "db:up": "docker compose up -d",
+    "db:down": "docker compose down",
+    "db:reset": "docker compose down -v && docker compose up -d",
+    "db:migrate": "prisma migrate dev",
+    "db:generate": "prisma generate",
+    "db:studio": "prisma studio",
+    "db:seed": "tsx prisma/seeds/index.ts",
+    "setup": "pnpm install && pnpm db:up && pnpm db:migrate && pnpm db:seed"
+  }
+}
+```
+
+Con `pnpm setup` un desarrollador nuevo levanta todo el entorno en un comando.