@revealui/mcp 0.1.0 → 0.1.3

package/src/servers/code-validator.ts

@@ -1,188 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Code Validator MCP Server
- *
- * Model Context Protocol server that exposes code validation tools
- * for AI assistants to validate code before writing to disk.
- *
- * This server provides:
- * - validate_code: Validate code content against standards
- * - get_standards: Get current code standards configuration
- *
- * Usage:
- *   Add to Claude Code MCP config:
- *   {
- *     "mcpServers": {
- *       "revealui-validator": {
- *         "command": "node",
- *         "args": ["./packages/mcp/src/servers/code-validator.ts"]
- *       }
- *     }
- *   }
- */
-
-import { resolve } from 'node:path'
-import { Server } from '@modelcontextprotocol/sdk/server/index.js'
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
-import {
-  type CallToolRequest,
-  CallToolRequestSchema,
-  ListToolsRequestSchema,
-  type Tool,
-} from '@modelcontextprotocol/sdk/types.js'
-import { logger } from '@revealui/core/observability/logger'
-import { ErrorCode, ScriptError } from '../../../../scripts/lib/errors.js'
-import { createValidator, loadStandards } from '../../../dev/src/code-validator/index.js'
-import { checkMcpLicense } from '../index.js'
-
-const STANDARDS_PATH = resolve(process.cwd(), '.revealui/code-standards.json')
-
-// Initialize MCP server
-const server = new Server(
-  {
-    name: 'revealui-code-validator',
-    version: '1.0.0',
-  },
-  {
-    capabilities: {
-      tools: {},
-    },
-  },
-)
-
-// Define tools
-const TOOLS: Tool[] = [
-  {
-    name: 'validate_code',
-    description:
-      'Validates code content against RevealUI standards to prevent technical debt (console.log, any types, etc.)', // ai-validator-ignore - documentation text
-    inputSchema: {
-      type: 'object',
-      properties: {
-        code: {
-          type: 'string',
-          description: 'The code content to validate',
-        },
-        filePath: {
-          type: 'string',
-          description: 'Optional file path for path-based exemptions',
-        },
-        autoFix: {
-          type: 'boolean',
-          description: 'Whether to apply automatic fixes',
-          default: false,
-        },
-      },
-      required: ['code'],
-    },
-  },
-  {
-    name: 'get_standards',
-    description: 'Get the current code standards configuration',
-    inputSchema: {
-      type: 'object',
-      properties: {},
-    },
-  },
-]
-
-// Handle tool listing
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: TOOLS,
-  }
-})
-
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request: CallToolRequest) => {
-  try {
-    switch (request.params.name) {
-      case 'validate_code': {
-        const {
-          code,
-          filePath,
-          autoFix = false,
-        } = request.params.arguments as {
-          code: string
-          filePath?: string
-          autoFix?: boolean
-        }
-
-        const validator = await createValidator(STANDARDS_PATH)
-
-        // Auto-fix if requested
-        let codeToValidate = code
-        let fixesApplied = 0
-
-        if (autoFix) {
-          const fixResult = validator.autoFix(code)
-          codeToValidate = fixResult.code
-          fixesApplied = fixResult.fixesApplied
-        }
-
-        // Validate
-        const result = validator.validate(codeToValidate, { filePath })
-
-        // Format response
-        const response = {
-          valid: result.valid,
-          violations: result.violations,
-          stats: result.stats,
-          summary: `${result.errors} errors, ${result.warnings} warnings, ${result.info} info`,
-          fixesApplied,
-          fixedCode: autoFix && fixesApplied > 0 ? codeToValidate : undefined,
-          formatted: validator.formatResult(result, { colors: false }),
-        }
-
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(response, null, 2),
-            },
-          ],
-        }
-      }
-
-      case 'get_standards': {
-        const standards = await loadStandards(STANDARDS_PATH)
-        return {
-          content: [
-            {
-              type: 'text',
-              text: JSON.stringify(standards, null, 2),
-            },
-          ],
-        }
-      }
-
-      default:
-        throw new ScriptError(`Unknown tool: ${request.params.name}`, ErrorCode.NOT_FOUND)
-    }
-  } catch (error) {
-    return {
-      content: [
-        {
-          type: 'text',
-          text: `Error: ${error instanceof Error ? error.message : String(error)}`,
-        },
-      ],
-      isError: true,
-    }
-  }
-})
-
-// Start server
-async function main() {
-  if (!(await checkMcpLicense())) {
-    process.exit(ErrorCode.CONFIG_ERROR)
-  }
-  const transport = new StdioServerTransport()
-  await server.connect(transport)
-}
-
-main().catch((error) => {
-  logger.error('Server error', error instanceof Error ? error : new Error(String(error)))
-  process.exit(1)
-})

package/src/servers/neon.ts

@@ -1,103 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Neon MCP Server Launcher
- *
- * Starts the Neon Database MCP server for AI-powered database management.
- *
- * Usage:
- *   pnpm mcp:neon
- */
-
-import { spawn } from 'node:child_process'
-import { createLogger, getProjectRoot } from '@revealui/scripts'
-import { ErrorCode } from '@revealui/scripts/errors'
-import { config } from 'dotenv'
-import { checkMcpLicense } from '../index.js'
-
-const logger = createLogger()
-
-// Load environment variables
-config()
-
-const MAX_RESTARTS = 3
-const RESTART_DELAYS_MS = [2000, 4000, 8000]
-
-async function spawnNeon(neonApiKey: string): Promise<number | null> {
-  return new Promise((resolve) => {
-    // Pass credentials via environment only — never as CLI arguments (visible in ps aux).
-    // mcp-server-neon reads NEON_API_KEY from the environment.
-    // Using pnpm exec instead of dlx so pnpm overrides apply to dependencies.
-    const child = spawn('pnpm', ['exec', 'mcp-server-neon', 'start'], {
-      stdio: 'inherit',
-      env: { ...process.env, NEON_API_KEY: neonApiKey },
-    })
-
-    child.on('error', (error) => {
-      logger.error(`Failed to start NeonDB MCP server: ${error.message}`)
-      resolve(ErrorCode.CONFIG_ERROR)
-    })
-
-    child.on('exit', (code) => resolve(code ?? 0))
-
-    process.on('SIGINT', () => {
-      child.kill('SIGINT')
-    })
-    process.on('SIGTERM', () => {
-      child.kill('SIGTERM')
-    })
-  })
-}
-
-async function startNeonMCP() {
-  try {
-    await getProjectRoot(import.meta.url)
-    // Neon MCP uses local package @neondatabase/mcp-server-neon
-    const neonApiKey = process.env.NEON_API_KEY
-
-    if (!neonApiKey) {
-      logger.error('NEON_API_KEY environment variable is required')
-      logger.info('   Get your API key from: https://console.neon.tech/app/settings/api-keys')
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-
-    const withRestart = process.argv.includes('--restart')
-    logger.header('Starting NeonDB MCP Server (Local)')
-    logger.info(`   API Key: ${neonApiKey.substring(0, 12)}...`)
-    if (withRestart) logger.info('   Restart mode: enabled (up to 3 attempts)')
-
-    let attempt = 0
-    while (true) {
-      const code = await spawnNeon(neonApiKey)
-      if (!withRestart || attempt >= MAX_RESTARTS) {
-        process.exit(code ?? 0)
-      }
-      const delay = RESTART_DELAYS_MS[attempt] ?? 8000
-      attempt++
-      logger.warning(
-        `   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MAX_RESTARTS})...`,
-      )
-      await new Promise((resolve) => setTimeout(resolve, delay))
-    }
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  try {
-    if (!(await checkMcpLicense())) {
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-    await startNeonMCP()
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-main()

package/src/servers/next-devtools.ts

@@ -1,230 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Next.js DevTools MCP Server Launcher
- *
- * Starts the Next.js DevTools MCP server for AI-powered Next.js development.
- *
- * Usage:
- *   pnpm mcp:next-devtools
- */
-
-import { spawn } from 'node:child_process'
-import { createServer } from 'node:net'
-import { createLogger, getProjectRoot } from '@revealui/scripts'
-import { ErrorCode } from '@revealui/scripts/errors'
-import { config } from 'dotenv'
-import { checkMcpLicense } from '../index.js'
-
-const logger = createLogger()
-
-// Load environment variables
-config()
-
-async function checkPort(port: number): Promise<boolean> {
-  return new Promise((resolve) => {
-    const server = createServer()
-    server.listen(port, () => {
-      server.once('close', () => resolve(false))
-      server.close()
-    })
-    server.on('error', () => resolve(true))
-  })
-}
-
-async function startNextDevToolsMCP() {
-  try {
-    await getProjectRoot(import.meta.url)
-
-    // Check if we're being invoked by an MCP client (non-TTY stdin)
-    // MCP servers need clean stdio pipes for JSON-RPC protocol
-    const isMCPSession = !process.stdin.isTTY
-    const stdioConfig: 'inherit' | ['pipe', 'pipe', 'pipe'] = isMCPSession
-      ? ['pipe', 'pipe', 'pipe'] // stdin, stdout, stderr as pipes for MCP protocol
-      : 'inherit' // Use inherit for interactive/debugging sessions
-
-    // Only log when running interactively (not via MCP client)
-    if (!isMCPSession) {
-      logger.header('Starting Next.js DevTools MCP Server')
-      logger.info('   This server provides Next.js 16+ development tools for coding agents')
-      logger.info('   Features: Runtime diagnostics, upgrade automation, Cache Components setup')
-    }
-
-    // Spawn the next-devtools-mcp process
-    // Use pnpm exec for locally installed package
-    // next-devtools-mcp automatically discovers Next.js dev servers and connects to them
-    const child = spawn('pnpm', ['exec', 'next-devtools-mcp'], {
-      stdio: stdioConfig,
-      env: {
-        ...process.env,
-        // Disable telemetry if NEXT_TELEMETRY_DISABLED is set
-        NEXT_TELEMETRY_DISABLED: process.env.NEXT_TELEMETRY_DISABLED || '0',
-      },
-    })
-
-    // Pipe stdio when running as MCP server (for JSON-RPC protocol)
-    if (isMCPSession) {
-      const { stdin, stdout, stderr } = child
-      if (stdin) {
-        process.stdin.pipe(stdin)
-      }
-      stdout?.pipe(process.stdout)
-      stderr?.pipe(process.stderr)
-    } else {
-      // Check CMS dev server
-      const cmsPort = 4000
-      const cmsRunning = await checkPort(cmsPort)
-      // In interactive mode, provide feedback that the server is running
-      // MCP servers don't produce output until they receive JSON-RPC messages
-      logger.info('\n📊 Server Discovery')
-      logger.info('📝 Next Steps')
-      if (!cmsRunning) {
-        logger.info('1. Start your CMS dev server:')
-        logger.info('   cd apps/cms && pnpm dev')
-        logger.info('')
-      }
-      logger.info('2. Ensure Next.js DevTools MCP is running:')
-      logger.info('   pnpm mcp:next-devtools')
-      logger.info('   (or pnpm mcp:all for all servers)')
-      logger.info('')
-      logger.info('3. In Cursor, you can now ask:')
-      logger.info('   - "What errors are in my Next.js app?"')
-      logger.info('   - "Show me my application routes"')
-      logger.info('   - "Help me upgrade to Next.js 16"')
-      logger.info('   - "Enable Cache Components in my app"')
-      logger.info('')
-
-      if (cmsRunning) {
-        logger.success(`Next.js CMS app detected on port ${cmsPort}`)
-        logger.info(`   URL: http://localhost:${cmsPort}`)
-        logger.info(`   MCP Endpoint: http://localhost:${cmsPort}/_next/mcp`)
-        logger.info('   Server started successfully ✓')
-        logger.info('   Waiting for MCP client connections...')
-        logger.info('   (This server communicates via JSON-RPC protocol on stdin/stdout)')
-        logger.info('')
-        logger.info('   To use this with Cursor IDE:')
-        logger.info("   • Ensure it's configured in .cursor/mcp-config.json")
-        logger.info('   • Cursor will automatically start it when needed')
-        logger.info('')
-        logger.info('')
-
-        logger.info('🛠️  Available Next.js DevTools MCP Tools')
-        logger.info('1. nextjs_index')
-        logger.info('   - Discovers all running Next.js 16+ dev servers')
-        logger.info('   - Lists available diagnostic tools')
-        logger.info('   - Shows server metadata (port, PID, URL)')
-        logger.info('')
-        logger.info('2. nextjs_call')
-        logger.info('   - Executes runtime diagnostics on dev server')
-        logger.info('   - Can query:')
-        logger.info('     • Real-time build/runtime errors')
-        logger.info('     • Application routes and pages')
-        logger.info('     • Component metadata')
-        logger.info('     • Development server logs')
-        logger.info('     • Server Actions')
-        logger.info('')
-        logger.info('3. upgrade_nextjs_16')
-        logger.info('   - Automated Next.js 16 upgrade')
-        logger.info('   - Runs official codemods')
-        logger.info('   - Handles async API changes')
-        logger.info('   - Fixes deprecated features')
-        logger.info('')
-        logger.info('4. enable_cache_components')
-        logger.info('   - Complete Cache Components setup')
-        logger.info('   - Automated error detection and fixing')
-        logger.info('   - Route verification')
-        logger.info('   - Intelligent boundary setup')
-        logger.info('')
-
-        logger.info('💡 How to Use with Your CMS App')
-        logger.info('Once your CMS dev server is running (pnpm dev in apps/cms):')
-        logger.info('')
-        logger.info('1. Auto-discovery:')
-        logger.info('   The MCP server will automatically detect your CMS app')
-        logger.info("   when it's running on http://localhost:4000")
-        logger.info('')
-        logger.info('2. Query runtime errors:')
-        logger.info('   "Next Devtools, what errors are in my Next.js app?"')
-        logger.info('   → Returns real-time build and runtime errors')
-        logger.info('')
-        logger.info('3. Check application routes:')
-        logger.info('   "Next Devtools, show me my application routes"')
-        logger.info('   → Lists all routes, pages, and dynamic segments')
-        logger.info('')
-        logger.info('4. View dev server logs:')
-        logger.info('   "Next Devtools, what\'s in the dev server logs?"')
-        logger.info('   → Shows recent development server output')
-        logger.info('')
-        logger.info('5. Upgrade assistance:')
-        logger.info('   "Next Devtools, help me upgrade to Next.js 16"')
-        logger.info('   → Guides through upgrade with automated codemods')
-        logger.info('')
-        logger.info('6. Cache Components setup:')
-        logger.info('   "Next Devtools, enable Cache Components"')
-        logger.info('   → Automated setup with error detection/fixing')
-        logger.info('')
-
-        logger.info('🔗 Integration with Your Setup')
-        logger.success('Next.js DevTools MCP is configured in:')
-        logger.info('   - .cursor/mcp-config.json')
-        logger.info('   - package.json scripts (mcp:next-devtools)')
-        logger.info('   - Included in mcp:all command')
-        logger.info('')
-        logger.success('Your CMS app is Next.js 16.1.1 - fully compatible!')
-        logger.success('Dev server runs on port 4000 with Turbopack')
-        logger.success('MCP endpoint available at: /_next/mcp')
-        logger.info('')
-        logger.info('   Press Ctrl+C to stop the server')
-      } else {
-        logger.warning(`Next.js CMS app not running on port ${cmsPort}`)
-        logger.info(`   Start it with: cd apps/cms && pnpm dev`)
-      }
-    }
-
-    child.on('error', (error) => {
-      if (!isMCPSession) {
-        logger.error(`Failed to start Next.js DevTools MCP server: ${error.message}`)
-      }
-      process.exit(ErrorCode.CONFIG_ERROR)
-    })
-
-    child.on('exit', (code) => {
-      process.exit(code ?? 0)
-    })
-
-    // Handle termination signals
-    process.on('SIGINT', () => {
-      if (!isMCPSession) {
-        logger.info('\n🛑 Stopping Next.js DevTools MCP Server...')
-      }
-      child.kill('SIGINT')
-    })
-
-    process.on('SIGTERM', () => {
-      if (!isMCPSession) {
-        logger.info('\n🛑 Stopping Next.js DevTools MCP Server...')
-      }
-      child.kill('SIGTERM')
-    })
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  try {
-    if (!(await checkMcpLicense())) {
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-    await startNextDevToolsMCP()
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-main()

package/src/servers/playwright.ts

@@ -1,77 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Playwright MCP Server Launcher
- *
- * Starts the Playwright MCP server for AI-powered browser automation.
- *
- * Usage:
- *   pnpm mcp:playwright
- */
-
-import { spawn } from 'node:child_process'
-import { createLogger, getProjectRoot } from '@revealui/scripts'
-import { ErrorCode } from '@revealui/scripts/errors'
-import { config } from 'dotenv'
-import { checkMcpLicense } from '../index.js'
-
-const logger = createLogger()
-
-// Load environment variables
-config()
-
-async function startPlaywrightMCP() {
-  try {
-    await getProjectRoot(import.meta.url)
-    logger.header('Starting Playwright MCP Server')
-
-    // Spawn the Playwright MCP server
-    // Using @executeautomation/playwright-mcp-server which is the most popular option
-    const child = spawn('pnpm', ['dlx', '@executeautomation/playwright-mcp-server'], {
-      stdio: 'inherit',
-      env: {
-        ...process.env,
-      },
-    })
-
-    child.on('error', (error) => {
-      logger.error(`Failed to start Playwright MCP server: ${error.message}`)
-      process.exit(ErrorCode.CONFIG_ERROR)
-    })
-
-    child.on('exit', (code) => {
-      process.exit(code ?? 0)
-    })
-
-    // Handle termination signals
-    process.on('SIGINT', () => {
-      logger.info('\n🛑 Stopping Playwright MCP Server...')
-      child.kill('SIGINT')
-    })
-
-    process.on('SIGTERM', () => {
-      logger.info('\n🛑 Stopping Playwright MCP Server...')
-      child.kill('SIGTERM')
-    })
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  try {
-    if (!(await checkMcpLicense())) {
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-    await startPlaywrightMCP()
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-main()

package/src/servers/stripe.ts

@@ -1,99 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Stripe MCP Server Launcher
- *
- * Starts the Stripe MCP server for AI-powered payment management.
- *
- * Usage:
- *   pnpm mcp:stripe
- */
-
-import { spawn } from 'node:child_process'
-import { createLogger, getProjectRoot } from '@revealui/scripts'
-import { ErrorCode } from '@revealui/scripts/errors'
-import { config } from 'dotenv'
-import { checkMcpLicense } from '../index.js'
-
-const logger = createLogger()
-
-// Load environment variables
-config()
-
-const MAX_RESTARTS = 3
-const RESTART_DELAYS_MS = [2000, 4000, 8000]
-
-async function spawnStripe(stripeSecretKey: string): Promise<number | null> {
-  return new Promise((resolve) => {
-    const child = spawn('pnpm', ['dlx', '@stripe/mcp', '--tools=all'], {
-      stdio: 'inherit',
-      env: { ...process.env, STRIPE_SECRET_KEY: stripeSecretKey },
-    })
-
-    child.on('error', (error) => {
-      logger.error(`Failed to start Stripe MCP server: ${error.message}`)
-      resolve(ErrorCode.CONFIG_ERROR)
-    })
-
-    child.on('exit', (code) => resolve(code ?? 0))
-
-    process.on('SIGINT', () => {
-      child.kill('SIGINT')
-    })
-    process.on('SIGTERM', () => {
-      child.kill('SIGTERM')
-    })
-  })
-}
-
-async function startStripeMCP() {
-  try {
-    await getProjectRoot(import.meta.url)
-    const stripeSecretKey = process.env.STRIPE_SECRET_KEY
-
-    if (!stripeSecretKey) {
-      logger.error('STRIPE_SECRET_KEY environment variable is required')
-      logger.info('   Get your key from: https://dashboard.stripe.com/apikeys')
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-
-    const withRestart = process.argv.includes('--restart')
-    logger.header('Starting Stripe MCP Server')
-    logger.info(`   Secret Key: ${stripeSecretKey.substring(0, 12)}...`)
-    if (withRestart) logger.info('   Restart mode: enabled (up to 3 attempts)')
-
-    let attempt = 0
-    while (true) {
-      const code = await spawnStripe(stripeSecretKey)
-      if (!withRestart || attempt >= MAX_RESTARTS) {
-        process.exit(code ?? 0)
-      }
-      const delay = RESTART_DELAYS_MS[attempt] ?? 8000
-      attempt++
-      logger.warning(
-        `   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MAX_RESTARTS})...`,
-      )
-      await new Promise((resolve) => setTimeout(resolve, delay))
-    }
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-/**
- * Main function
- */
-async function main() {
-  try {
-    if (!(await checkMcpLicense())) {
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-    await startStripeMCP()
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-main()