deploy

Deploy MCP Server

Deploys your MCP server to various platforms and registries.

Usage

/deploy [target] [options]

Targets

• npm - Publish to npm registry
• docker - Push to Docker registry
• claude - Register with Claude Code
• github - Create GitHub release

Options

• --tag - Version tag (default: from package.json)
• --registry - Custom registry URL
• --dry-run - Test deployment without publishing

Implementation

import { exec } from 'child_process';
import { promisify } from 'util';
import * as fs from 'fs/promises';
import * as path from 'path';

const execAsync = promisify(exec);

async function deployServer(
  target: 'npm' | 'docker' | 'claude' | 'github',
  options: {
    tag?: string;
    registry?: string;
    dryRun?: boolean;
  } = {}
) {
  console.log('🚀 Deploying MCP Server');
  console.log('='.repeat(50));
  
  // Get version info
  const pkg = JSON.parse(await fs.readFile('package.json', 'utf-8'));
  const version = options.tag || pkg.version;
  
  // Pre-deployment checks
  await runPreDeploymentChecks(version);
  
  // Deploy based on target
  switch (target) {
    case 'npm':
      await deployToNpm(pkg, version, options);
      break;
    case 'docker':
      await deployToDocker(pkg, version, options);
      break;
    case 'claude':
      await deployToClaude(pkg, version, options);
      break;
    case 'github':
      await deployToGitHub(pkg, version, options);
      break;
  }
  
  console.log('\n✅ Deployment completed successfully!');
}

async function runPreDeploymentChecks(version: string) {
  console.log('\n🔍 Running pre-deployment checks...');
  
  // Check git status
  try {
    const { stdout: status } = await execAsync('git status --porcelain');
    if (status.trim()) {
      throw new Error('Working directory has uncommitted changes');
    }
    console.log('  ✅ Working directory clean');
  } catch (error) {
    if (error.message.includes('uncommitted')) {
      throw error;
    }
    console.warn('  ⚠️  Git not available');
  }
  
  // Check if version tag exists
  try {
    await execAsync(`git rev-parse v${version}`);
    console.log(`  ✅ Version tag v${version} exists`);
  } catch {
    console.warn(`  ⚠️  Version tag v${version} not found`);
    console.log('  Create with: git tag v' + version);
  }
  
  // Verify build exists
  const buildExists = await fs.access('dist').then(() => true).catch(() => false);
  if (!buildExists) {
    throw new Error('Build not found. Run /build first');
  }
  console.log('  ✅ Build found');
  
  // Run tests
  console.log('  Running tests...');
  try {
    await execAsync('npm test');
    console.log('  ✅ Tests passed');
  } catch {
    throw new Error('Tests must pass before deployment');
  }
}

async function deployToNpm(pkg: any, version: string, options: any) {
  console.log(`\n📦 Deploying to npm (v${version})...`);
  
  // Check npm authentication
  try {
    await execAsync('npm whoami');
    console.log('  ✅ npm authenticated');
  } catch {
    throw new Error('Not authenticated with npm. Run: npm login');
  }
  
  // Check if version already published
  try {
    const { stdout } = await execAsync(`npm view ${pkg.name}@${version}`);
    if (stdout) {
      throw new Error(`Version ${version} already published`);
    }
  } catch (error) {
    if (error.message.includes('already published')) {
      throw error;
    }
    // Version not published yet (good)
  }
  
  // Update version if different
  if (pkg.version !== version) {
    console.log(`  Updating version to ${version}...`);
    await execAsync(`npm version ${version} --no-git-tag-version`);
  }
  
  // Publish package
  const publishCmd = options.dryRun
    ? 'npm publish --dry-run'
    : `npm publish ${options.registry ? `--registry ${options.registry}` : ''}`;
  
  console.log('  Publishing to npm...');
  const { stdout } = await execAsync(publishCmd);
  
  if (options.dryRun) {
    console.log('  🧪 Dry run complete (not published)');