@vasperacapital/vaspera-mcp-server 0.1.0 → 0.2.0

package/src/cli.ts

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import { createInterface } from 'readline';
+
+// ASCII Art Banner
+const BANNER = `
+\x1b[36m╔═══════════════════════════════════════════════════════════════╗
+║                                                               ║
+║   ██╗   ██╗ █████╗ ███████╗██████╗ ███████╗██████╗  █████╗    ║
+║   ██║   ██║██╔══██╗██╔════╝██╔══██╗██╔════╝██╔══██╗██╔══██╗   ║
+║   ██║   ██║███████║███████╗██████╔╝█████╗  ██████╔╝███████║   ║
+║   ╚██╗ ██╔╝██╔══██║╚════██║██╔═══╝ ██╔══╝  ██╔══██╗██╔══██║   ║
+║    ╚████╔╝ ██║  ██║███████║██║     ███████╗██║  ██║██║  ██║   ║
+║     ╚═══╝  ╚═╝  ╚═╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝   ║
+║                                                               ║
+║              \x1b[33mAI-Powered Product Management\x1b[36m                    ║
+║                                                               ║
+╚═══════════════════════════════════════════════════════════════╝\x1b[0m
+`;
+
+const VERSION = '0.1.1';
+
+const HELP = `
+\x1b[1mUsage:\x1b[0m vasperapm <command> [options]
+
+\x1b[1mCommands:\x1b[0m
+  \x1b[32minstall\x1b[0m     Configure VasperaPM with Claude Code
+  \x1b[32mconnect\x1b[0m     Set up your API key and integrations
+  \x1b[32mserve\x1b[0m       Start the MCP server (used by Claude Code)
+  \x1b[32mstatus\x1b[0m      Check your current configuration
+  \x1b[32mhelp\x1b[0m        Show this help message
+
+\x1b[1mExamples:\x1b[0m
+  $ vasperapm install     # Set up VasperaPM with Claude Code
+  $ vasperapm connect     # Configure API key interactively
+  $ vasperapm status      # Check configuration status
+
+\x1b[1mDocumentation:\x1b[0m
+  https://github.com/rcolkitt/VasperaPM
+
+\x1b[1mGet an API Key:\x1b[0m
+  https://vasperapm.com/dashboard
+`;
+
+// Get Claude config path
+function getClaudeConfigPath(): string {
+  return join(homedir(), '.claude', 'claude_desktop_config.json');
+}
+
+// Get VasperaPM config path
+function getVasperaConfigPath(): string {
+  return join(homedir(), '.vasperapm', 'config.json');
+}
+
+// Read JSON file safely
+function readJsonFile(path: string): Record<string, unknown> | null {
+  try {
+    if (!existsSync(path)) return null;
+    return JSON.parse(readFileSync(path, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+// Write JSON file safely
+function writeJsonFile(path: string, data: Record<string, unknown>): void {
+  const dir = path.substring(0, path.lastIndexOf('/'));
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  writeFileSync(path, JSON.stringify(data, null, 2));
+}
+
+// Prompt for input
+function prompt(question: string): Promise<string> {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+// Print success message
+function success(message: string): void {
+  console.log(`\x1b[32m✓\x1b[0m ${message}`);
+}
+
+// Print error message
+function error(message: string): void {
+  console.log(`\x1b[31m✗\x1b[0m ${message}`);
+}
+
+// Print info message
+function info(message: string): void {
+  console.log(`\x1b[36mℹ\x1b[0m ${message}`);
+}
+
+// Print warning message
+function warn(message: string): void {
+  console.log(`\x1b[33m⚠\x1b[0m ${message}`);
+}
+
+// Install command - Configure Claude Code
+async function install(): Promise<void> {
+  console.log(BANNER);
+  console.log('\x1b[1mInstalling VasperaPM for Claude Code...\x1b[0m\n');
+
+  const configPath = getClaudeConfigPath();
+  let config = readJsonFile(configPath) as { mcpServers?: Record<string, unknown> } | null;
+
+  if (!config) {
+    config = { mcpServers: {} };
+    info('Creating Claude Code configuration...');
+  }
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  // Check if already installed
+  if (config.mcpServers['vaspera-pm']) {
+    warn('VasperaPM is already installed in Claude Code.');
+    const answer = await prompt('\nDo you want to reinstall? (y/N): ');
+    if (answer.toLowerCase() !== 'y') {
+      info('Installation cancelled.');
+      return;
+    }
+  }
+
+  // Get API key
+  const vasperaConfig = readJsonFile(getVasperaConfigPath()) as { apiKey?: string } | null;
+  let apiKey = vasperaConfig?.apiKey || process.env.VASPERA_API_KEY || '';
+
+  if (!apiKey) {
+    console.log('\n\x1b[1mAPI Key Setup\x1b[0m');
+    console.log('Get your API key at: \x1b[36mhttps://vasperapm.com/dashboard\x1b[0m\n');
+    apiKey = await prompt('Enter your VasperaPM API key (or press Enter to use test mode): ');
+
+    if (!apiKey) {
+      apiKey = 'vpm_test_local_development_key_for_testing';
+      info('Using test mode API key (limited features)');
+    }
+  }
+
+  // Add VasperaPM to Claude config
+  config.mcpServers['vaspera-pm'] = {
+    command: 'vasperapm',
+    args: ['serve'],
+    env: {
+      VASPERA_API_KEY: apiKey,
+      NODE_ENV: apiKey.includes('test') ? 'development' : 'production',
+    },
+  };
+
+  writeJsonFile(configPath, config);
+
+  // Save API key to VasperaPM config
+  const vasperaDir = join(homedir(), '.vasperapm');
+  if (!existsSync(vasperaDir)) {
+    mkdirSync(vasperaDir, { recursive: true });
+  }
+  writeJsonFile(getVasperaConfigPath(), { apiKey });
+
+  console.log('\n');
+  success('VasperaPM installed successfully!');
+  console.log('\n\x1b[1mNext steps:\x1b[0m');
+  console.log('  1. Restart Claude Code (or VSCode)');
+  console.log('  2. Look for VasperaPM tools in the MCP panel');
+  console.log('  3. Try: "Generate a PRD for a todo app"\n');
+
+  console.log('\x1b[1mAvailable Tools:\x1b[0m');
+  console.log('  \x1b[33m•\x1b[0m generate_prd          - Create PRDs from context');
+  console.log('  \x1b[33m•\x1b[0m infer_prd_from_code   - Analyze code to generate PRD');
+  console.log('  \x1b[33m•\x1b[0m generate_code         - Generate code from PRD');
+  console.log('  \x1b[33m•\x1b[0m sync_jira/linear/github - Sync with PM tools');
+  console.log('  \x1b[33m•\x1b[0m generate_api_spec     - Create OpenAPI specs');
+  console.log('  \x1b[33m•\x1b[0m generate_test_cases   - Create test plans\n');
+}
+
+// Connect command - Set up API key and integrations
+async function connect(): Promise<void> {
+  console.log(BANNER);
+  console.log('\x1b[1mConnect VasperaPM to your services...\x1b[0m\n');
+
+  // API Key setup
+  console.log('\x1b[1m1. API Key\x1b[0m');
+  const vasperaConfig = readJsonFile(getVasperaConfigPath()) as { apiKey?: string } | null;
+
+  if (vasperaConfig?.apiKey) {
+    const masked = vasperaConfig.apiKey.substring(0, 12) + '...' + vasperaConfig.apiKey.substring(vasperaConfig.apiKey.length - 4);
+    info(`Current API key: ${masked}`);
+    const answer = await prompt('Update API key? (y/N): ');
+    if (answer.toLowerCase() !== 'y') {
+      success('Keeping existing API key');
+    } else {
+      const newKey = await prompt('Enter new API key: ');
+      if (newKey) {
+        writeJsonFile(getVasperaConfigPath(), { ...vasperaConfig, apiKey: newKey });
+        success('API key updated');
+      }
+    }
+  } else {
+    console.log('Get your API key at: \x1b[36mhttps://vasperapm.com/dashboard\x1b[0m\n');
+    const apiKey = await prompt('Enter your VasperaPM API key: ');
+    if (apiKey) {
+      writeJsonFile(getVasperaConfigPath(), { apiKey });
+      success('API key saved');
+    } else {
+      warn('No API key provided. Some features will be limited.');
+    }
+  }
+
+  console.log('\n\x1b[1m2. Integrations\x1b[0m');
+  console.log('Configure integrations at: \x1b[36mhttps://vasperapm.com/dashboard/integrations\x1b[0m\n');
+  console.log('  \x1b[33m•\x1b[0m Jira     - Sync PRDs to Jira epics/stories');
+  console.log('  \x1b[33m•\x1b[0m Linear   - Export tasks to Linear projects');
+  console.log('  \x1b[33m•\x1b[0m GitHub   - Create issues and track progress\n');
+
+  success('Connection setup complete!');
+  console.log('\nRun \x1b[36mvasperapm status\x1b[0m to check your configuration.\n');
+}
+
+// Status command - Check configuration
+async function status(): Promise<void> {
+  console.log(BANNER);
+  console.log('\x1b[1mVasperaPM Status\x1b[0m\n');
+
+  // Check VasperaPM config
+  const vasperaConfig = readJsonFile(getVasperaConfigPath()) as { apiKey?: string } | null;
+  if (vasperaConfig?.apiKey) {
+    const masked = vasperaConfig.apiKey.substring(0, 12) + '...' + vasperaConfig.apiKey.substring(vasperaConfig.apiKey.length - 4);
+    success(`API Key: ${masked}`);
+
+    if (vasperaConfig.apiKey.includes('_live_')) {
+      info('Mode: Production');
+    } else if (vasperaConfig.apiKey.includes('_test_')) {
+      info('Mode: Test/Development');
+    }
+  } else {
+    warn('API Key: Not configured');
+    console.log('  Run \x1b[36mvasperapm connect\x1b[0m to set up your API key\n');
+  }
+
+  // Check Claude Code config
+  const claudeConfig = readJsonFile(getClaudeConfigPath()) as { mcpServers?: Record<string, unknown> } | null;
+  if (claudeConfig?.mcpServers?.['vaspera-pm']) {
+    success('Claude Code: Installed');
+  } else {
+    warn('Claude Code: Not installed');
+    console.log('  Run \x1b[36mvasperapm install\x1b[0m to set up Claude Code integration\n');
+  }
+
+  // Version info
+  console.log(`\n\x1b[1mVersion:\x1b[0m ${VERSION}`);
+  console.log('\x1b[1mDocs:\x1b[0m https://github.com/rcolkitt/VasperaPM\n');
+}
+
+// Serve command - Start MCP server
+async function serve(): Promise<void> {
+  // Import and run the MCP server
+  const { startServer } = await import('./server.js');
+  await startServer();
+}
+
+// Main CLI
+async function main(): Promise<void> {
+  const args = process.argv.slice(2);
+  const command = args[0]?.toLowerCase();
+
+  switch (command) {
+    case 'install':
+      await install();
+      break;
+    case 'connect':
+      await connect();
+      break;
+    case 'serve':
+      await serve();
+      break;
+    case 'status':
+      await status();
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      console.log(BANNER);
+      console.log(HELP);
+      break;
+    case '--version':
+    case '-v':
+      console.log(`vasperapm v${VERSION}`);
+      break;
+    case undefined:
+      console.log(BANNER);
+      console.log(HELP);
+      break;
+    default:
+      error(`Unknown command: ${command}`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  error(err.message);
+  process.exit(1);
+});

package/src/middleware/auth.ts

@@ -1,4 +1,4 @@
-import { QUOTA_LIMITS, type SubscriptionTier } from '@vaspera/shared';
+import { QUOTA_LIMITS, type SubscriptionTier } from '@vasperacapital/vaspera-shared';
 
 // Response type from validate-key API
 interface ValidateKeyResponse {

package/src/middleware/rate-limit.ts

@@ -1,4 +1,4 @@
-import type { SubscriptionTier } from '@vaspera/shared';
+import type { SubscriptionTier } from '@vasperacapital/vaspera-shared';
 
 export interface RateLimitResult {
   allowed: boolean;

package/src/{index.ts → server.ts}

@@ -6,15 +6,17 @@ import {
   ErrorCode,
   McpError,
 } from '@modelcontextprotocol/sdk/types.js';
-import { validateApiKey, type ValidationResult } from './middleware/auth.js';
+import { validateApiKey } from './middleware/auth.js';
 import { trackUsage } from './middleware/usage.js';
 import { checkRateLimit } from './middleware/rate-limit.js';
 import { tools, toolHandlers } from './tools/index.js';
 
+const VERSION = '0.1.1';
+
 const server = new Server(
   {
     name: 'vaspera-pm',
-    version: '1.0.0',
+    version: VERSION,
   },
   {
     capabilities: {
@@ -127,14 +129,17 @@ function sanitizeArgs(args: Record<string, unknown> | undefined): Record<string,
   return sanitized;
 }
 
-// Start server
-async function main() {
+// Start server (exported for CLI)
+export async function startServer(): Promise<void> {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error('VasperaPM MCP Server v1.0.0 running');
+  console.error(`VasperaPM MCP Server v${VERSION} running`);
 }
 
-main().catch((error) => {
-  console.error('Failed to start MCP server:', error);
-  process.exit(1);
-});
+// Allow direct execution
+if (import.meta.url === `file://${process.argv[1]}`) {
+  startServer().catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+  });
+}

package/tsup.config.ts

@@ -1,13 +1,14 @@
 import { defineConfig } from 'tsup';
 
 export default defineConfig({
-  entry: ['src/index.ts'],
+  entry: {
+    cli: 'src/cli.ts',
+    server: 'src/server.ts',
+  },
   format: ['esm'],
   dts: true,
   clean: true,
   sourcemap: true,
   target: 'node20',
-  banner: {
-    js: '#!/usr/bin/env node',
-  },
+  splitting: false,
 });

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-
-export {  }