@revealui/mcp 0.1.0 → 0.1.3

package/src/servers/supabase.ts

@@ -1,161 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Supabase MCP Server Launcher
- *
- * Starts the Supabase MCP server for AI-powered database management.
- *
- * Usage:
- *   pnpm mcp:supabase
- */
-
-import { spawn } from 'node:child_process'
-import { randomBytes } from 'node:crypto'
-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 startSupabaseMCP() {
-  try {
-    await getProjectRoot(import.meta.url)
-    // Supabase MCP uses local package supabase-mcp
-    // Verified: Package expects SUPABASE_URL, SUPABASE_ANON_KEY, and SUPABASE_SERVICE_ROLE_KEY
-    // Source: node_modules/supabase-mcp/dist/esm/config.js and services/supabase.js
-    //
-    // NEW API KEY SUPPORT (2025):
-    // Supabase introduced new API keys: sb_publishable_... (replaces anon) and sb_secret_... (replaces service_role)
-    // Legacy keys (anon/service_role JWT) still work but will be deprecated in Nov 2025
-    // The @supabase/supabase-js client accepts any key format, so we support both
-    // Reference: https://github.com/orgs/supabase/discussions/29260
-    const supabaseUrl = process.env.SUPABASE_URL
-
-    // Support both legacy and new API key formats
-    // New format: SUPABASE_PUBLISHABLE_KEY (sb_publishable_...) or SUPABASE_ANON_KEY (legacy)
-    // New format: SUPABASE_SECRET_KEY (sb_secret_...) or SUPABASE_SERVICE_ROLE_KEY (legacy)
-    const supabaseAnonKey = process.env.SUPABASE_PUBLISHABLE_KEY || process.env.SUPABASE_ANON_KEY
-    const supabaseServiceRoleKey =
-      process.env.SUPABASE_SECRET_KEY || process.env.SUPABASE_SERVICE_ROLE_KEY
-
-    if (!supabaseUrl) {
-      logger.error('SUPABASE_URL is required')
-      logger.info('   Get your credentials from: https://supabase.com/dashboard → Settings → API')
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-
-    if (!supabaseAnonKey) {
-      logger.error('SUPABASE_ANON_KEY or SUPABASE_PUBLISHABLE_KEY is required')
-      logger.info('   Legacy: SUPABASE_ANON_KEY (anon JWT key)')
-      logger.info('   New: SUPABASE_PUBLISHABLE_KEY (sb_publishable_... key)')
-      logger.info('   Get from: https://supabase.com/dashboard → Settings → API')
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-
-    if (!supabaseServiceRoleKey) {
-      logger.error('SUPABASE_SERVICE_ROLE_KEY or SUPABASE_SECRET_KEY is required')
-      logger.info('   Legacy: SUPABASE_SERVICE_ROLE_KEY (service_role JWT key)')
-      logger.info('   New: SUPABASE_SECRET_KEY (sb_secret_... key)')
-      logger.info('   Note: Required for MCP server operations (full database access)')
-      logger.info('   Get from: https://supabase.com/dashboard → Settings → API')
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-
-    // MCP_API_KEY is required by supabase-mcp package for server authentication
-    // This is NOT a Supabase key - it's a key you generate yourself to secure the MCP server
-    let mcpApiKey = process.env.MCP_API_KEY
-    if (!mcpApiKey) {
-      // Auto-generate a secure random key if not provided
-      mcpApiKey = randomBytes(32).toString('hex')
-      logger.warning('⚠️  MCP_API_KEY not set - auto-generated a secure key')
-      logger.warning('   Add this to your .env file to persist it:')
-      logger.warning(`   MCP_API_KEY=${mcpApiKey}`)
-      logger.warning('   (This key secures your MCP server endpoint)')
-    }
-
-    const withRestart = process.argv.includes('--restart')
-    logger.header('Starting Supabase MCP Server (Local)')
-    logger.info(`   Supabase URL: ${supabaseUrl}`)
-    if (withRestart) logger.info('   Restart mode: enabled (up to 3 attempts)')
-
-    // Detect key format for logging
-    const usingNewKeys = process.env.SUPABASE_PUBLISHABLE_KEY || process.env.SUPABASE_SECRET_KEY
-    if (usingNewKeys) {
-      logger.info('   Using new API key format (sb_publishable_/sb_secret_)')
-    } else {
-      logger.info('   Using legacy API key format (anon/service_role JWT)')
-      logger.warning('   ⚠️  Consider migrating to new keys before Nov 2025')
-      logger.info('   See: https://github.com/orgs/supabase/discussions/29260')
-    }
-
-    // Build env once — used for all spawn attempts
-    // Package validates: SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, MCP_API_KEY
-    // We map new keys to legacy variable names for package compatibility
-    const spawnEnv = {
-      ...process.env,
-      SUPABASE_URL: supabaseUrl,
-      SUPABASE_ANON_KEY: supabaseAnonKey,
-      SUPABASE_SERVICE_ROLE_KEY: supabaseServiceRoleKey,
-      MCP_API_KEY: mcpApiKey,
-      SUPABASE_PUBLISHABLE_KEY: process.env.SUPABASE_PUBLISHABLE_KEY,
-      SUPABASE_SECRET_KEY: process.env.SUPABASE_SECRET_KEY,
-    }
-
-    const MaxRestarts = 3
-    const RestartDelaysMs = [2000, 4000, 8000]
-
-    const spawnSupabase = (): Promise<number | null> =>
-      new Promise((resolve) => {
-        const child = spawn('pnpm', ['dlx', 'supabase-mcp'], { stdio: 'inherit', env: spawnEnv })
-        child.on('error', (error) => {
-          logger.error(`Failed to start Supabase 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')
-        })
-      })
-
-    let attempt = 0
-    while (true) {
-      const code = await spawnSupabase()
-      if (!withRestart || attempt >= MaxRestarts) {
-        process.exit(code ?? 0)
-      }
-      const delay = RestartDelaysMs[attempt] ?? 8000
-      attempt++
-      logger.warning(
-        `   Server exited (code ${code}). Restarting in ${delay / 1000}s (attempt ${attempt}/${MaxRestarts})...`,
-      )
-      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 startSupabaseMCP()
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-main()

package/src/servers/vercel.ts

@@ -1,100 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Vercel MCP Server Launcher
- *
- * Starts the Vercel MCP server for AI-powered Vercel management.
- *
- * Usage:
- *   pnpm mcp:vercel
- */
-
-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 spawnVercel(vercelApiKey: string): Promise<number | null> {
-  return new Promise((resolve) => {
-    // Pass credentials via environment only — never as CLI arguments (visible in ps aux).
-    const child = spawn('pnpm', ['exec', 'vercel-mcp'], {
-      stdio: 'inherit',
-      env: { ...process.env, VERCEL_API_KEY: vercelApiKey },
-    })
-
-    child.on('error', (error) => {
-      logger.error(`Failed to start Vercel 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 startVercelMCP() {
-  try {
-    await getProjectRoot(import.meta.url)
-    const vercelApiKey = process.env.VERCEL_API_KEY ?? process.env.VERCEL_TOKEN
-
-    if (!vercelApiKey) {
-      logger.error('VERCEL_API_KEY environment variable is required')
-      logger.info('   Get your token from: https://vercel.com/account/tokens')
-      process.exit(ErrorCode.CONFIG_ERROR)
-    }
-
-    const withRestart = process.argv.includes('--restart')
-    logger.header('Starting Vercel MCP Server')
-    logger.info(`   API Key: ${vercelApiKey.substring(0, 8)}...`)
-    if (withRestart) logger.info('   Restart mode: enabled (up to 3 attempts)')
-
-    let attempt = 0
-    while (true) {
-      const code = await spawnVercel(vercelApiKey)
-      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 startVercelMCP()
-  } catch (error) {
-    logger.error(`Script failed: ${error instanceof Error ? error.message : String(error)}`)
-    process.exit(ErrorCode.EXECUTION_ERROR)
-  }
-}
-
-main()

package/src/servers/vultr-test.ts

@@ -1,97 +0,0 @@
-#!/usr/bin/env node
-// Demo script to exercise Vultr Inference (chat + embeddings)
-// Usage:
-// Use ts-node or compile to JS. Example with ts-node:
-// VULTR_API_KEY=your_key VULTR_MODEL=your-model-id ts-node packages/ai/scripts/test-vultr.ts
-
-import { logger } from '@revealui/core/observability/logger'
-import { checkMcpLicense } from '../index.js'
-
-const KEY = process.env.VULTR_API_KEY
-const MODEL = process.env.VULTR_MODEL
-const BASE = process.env.VULTR_BASE_URL || 'https://api.vultrinference.com/v1'
-
-if (!(KEY && MODEL)) {
-  logger.error(
-    'Missing VULTR_API_KEY or VULTR_MODEL environment variables',
-    new Error('Missing required environment variables'),
-  )
-  process.exit(1)
-}
-
-const headers = {
-  'Content-Type': 'application/json',
-  // biome-ignore lint/style/useNamingConvention: API field name
-  Authorization: `Bearer ${KEY}`,
-}
-
-async function chat(prompt: string) {
-  const body = {
-    model: MODEL,
-    messages: [{ role: 'user', content: prompt }],
-    max_tokens: 256,
-  }
-
-  const res = await fetch(`${BASE}/chat/completions`, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  })
-
-  if (!res.ok) {
-    const err = await res.text().catch(() => res.statusText)
-    throw new Error(`Chat request failed: ${res.status} ${err}`)
-  }
-
-  const data = (await res.json()) as { choices?: unknown[] }
-  logger.info('Chat response', { data })
-  const choice = Array.isArray(data.choices)
-    ? (data.choices[0] as { message?: { content: string }; text?: string } | undefined)
-    : undefined
-  const message = choice?.message
-    ? choice.message
-    : choice?.text
-      ? { content: choice.text }
-      : undefined
-  if (message) {
-    logger.info('Assistant output', {
-      content: typeof message.content === 'string' ? message.content : JSON.stringify(message),
-    })
-  }
-}
-
-async function embed(inputs: string | string[]) {
-  const body = {
-    model: MODEL,
-    input: Array.isArray(inputs) ? inputs : [inputs],
-  }
-
-  const res = await fetch(`${BASE}/embeddings`, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  })
-
-  if (!res.ok) {
-    const err = await res.text().catch(() => res.statusText)
-    throw new Error(`Embeddings request failed: ${res.status} ${err}`)
-  }
-
-  const data = await res.json()
-  logger.info('Embeddings response', { data })
-}
-
-async function main() {
-  if (!(await checkMcpLicense())) {
-    process.exit(2)
-  }
-  try {
-    await chat('What is the capital of France?')
-    await embed('This is a test embedding.')
-  } catch (err) {
-    logger.error('Error during demo', err instanceof Error ? err : new Error(String(err)))
-    process.exitCode = 2
-  }
-}
-
-await main()

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "noEmit": false
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "__tests__", "**/*.test.ts", "**/*.spec.ts"]
-}

package/vitest.config.ts

@@ -1,22 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  resolve: {
-    conditions: ['import', 'module', 'browser', 'default'],
-  },
-  test: {
-    globals: true,
-    environment: 'node',
-    include: ['__tests__/**/*.test.ts', 'src/**/*.test.ts'],
-    env: {
-      // Set NODE_ENV to 'test' to skip integration tests that require database setup
-      // Integration tests will check for TEST_DATABASE_URL and skip if not present
-      NODE_ENV: 'test',
-    },
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html', 'lcov'],
-      exclude: ['node_modules/', 'dist/', '**/*.test.ts', '**/__tests__/**'],
-    },
-  },
-})