@talkspresso/mcp-server 1.0.0 → 1.1.0

package/dist/index.js

@@ -1,21 +1,42 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { TalkspressoClient } from './client.js';
-import { registerAppointmentTools } from './tools/appointments.js';
-import { registerClientTools } from './tools/clients.js';
-import { registerServiceTools } from './tools/services.js';
-import { registerEarningsTools } from './tools/earnings.js';
-import { registerProfileTools } from './tools/profile.js';
-const server = new McpServer({
-    name: 'talkspresso',
-    version: '1.0.0',
-});
-const apiClient = new TalkspressoClient();
-registerAppointmentTools(server, apiClient);
-registerClientTools(server, apiClient);
-registerServiceTools(server, apiClient);
-registerEarningsTools(server, apiClient);
-registerProfileTools(server, apiClient);
-const transport = new StdioServerTransport();
-await server.connect(transport);
+const args = process.argv.slice(2);
+if (args.includes('--setup')) {
+    const { runSetup } = await import('./setup.js');
+    await runSetup();
+}
+else if (args.includes('--help')) {
+    console.log('Usage: talkspresso-mcp [options]\n');
+    console.log('Options:');
+    console.log('  --setup    Interactive setup wizard');
+    console.log('  --help     Show this help message');
+    console.log('  --version  Show version number');
+    console.log('\nWith no options, starts the MCP server (stdio transport).');
+    process.exit(0);
+}
+else if (args.includes('--version')) {
+    console.log('1.1.0');
+    process.exit(0);
+}
+else {
+    const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+    const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+    const { TalkspressoClient } = await import('./client.js');
+    const { registerAppointmentTools } = await import('./tools/appointments.js');
+    const { registerClientTools } = await import('./tools/clients.js');
+    const { registerServiceTools } = await import('./tools/services.js');
+    const { registerEarningsTools } = await import('./tools/earnings.js');
+    const { registerProfileTools } = await import('./tools/profile.js');
+    const server = new McpServer({
+        name: 'talkspresso',
+        version: '1.1.0',
+    });
+    const apiClient = new TalkspressoClient();
+    registerAppointmentTools(server, apiClient);
+    registerClientTools(server, apiClient);
+    registerServiceTools(server, apiClient);
+    registerEarningsTools(server, apiClient);
+    registerProfileTools(server, apiClient);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+export {};

package/dist/setup-api.d.ts

@@ -0,0 +1,18 @@
+export declare class SetupApiClient {
+    private http;
+    constructor();
+    setAccessToken(token: string): void;
+    register(data: {
+        name: string;
+        email: string;
+        password: string;
+        timezone: string;
+    }): Promise<any>;
+    login(data: {
+        email: string;
+        password: string;
+    }): Promise<any>;
+    createApiKey(name: string): Promise<any>;
+    getStatus(err: unknown): number | undefined;
+    private formatError;
+}

package/dist/setup-api.js

@@ -0,0 +1,55 @@
+import axios from 'axios';
+export class SetupApiClient {
+    http;
+    constructor() {
+        const baseURL = process.env.TALKSPRESSO_API_URL || 'https://api.talkspresso.com';
+        this.http = axios.create({
+            baseURL,
+            headers: { 'Content-Type': 'application/json' },
+            timeout: 30000,
+        });
+    }
+    setAccessToken(token) {
+        this.http.defaults.headers['Authorization'] = `Bearer ${token}`;
+    }
+    async register(data) {
+        try {
+            const response = await this.http.post('/user/register', data);
+            return response.data?.data;
+        }
+        catch (err) {
+            throw this.formatError(err);
+        }
+    }
+    async login(data) {
+        try {
+            const response = await this.http.post('/user/login', data);
+            return response.data?.data;
+        }
+        catch (err) {
+            throw this.formatError(err);
+        }
+    }
+    async createApiKey(name) {
+        try {
+            const response = await this.http.post('/api-keys', { name });
+            return response.data?.data;
+        }
+        catch (err) {
+            throw this.formatError(err);
+        }
+    }
+    getStatus(err) {
+        if (err instanceof Error && 'status' in err)
+            return err.status;
+        return undefined;
+    }
+    formatError(err) {
+        const data = err.response?.data;
+        const status = err.response?.status;
+        const message = data?.error || err.message || 'API request failed';
+        const error = new Error(message);
+        error.status = status;
+        return error;
+    }
+}

package/dist/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;

package/dist/setup.js

@@ -0,0 +1,199 @@
+import chalk from 'chalk';
+import { confirm, input, password as passwordPrompt } from '@inquirer/prompts';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { SetupApiClient } from './setup-api.js';
+const LOGO = `
+  ${chalk.hex('#032B43').bold('╔╦╗')}${chalk.hex('#0A4B6E')('┌─┐┬  ┬┌─┌─┐┌─┐┬─┐┌─┐┌─┐┌─┐┌─┐')}
+  ${chalk.hex('#032B43').bold(' ║ ')}${chalk.hex('#0A4B6E')('├─┤│  ├┴┐└─┐├─┘├┬┘├┤ └─┐└─┐│ │')}
+  ${chalk.hex('#032B43').bold(' ╩ ')}${chalk.hex('#0A4B6E')('┴ ┴┴─┘┴ ┴└─┘┴  ┴└─└─┘└─┘└─┘└─┘')}
+`;
+function getClaudeDesktopConfigPath() {
+    const home = homedir();
+    if (process.platform === 'darwin') {
+        return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    else if (process.platform === 'win32') {
+        return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+    }
+    return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+}
+function getClaudeCodeConfigPath() {
+    return join(homedir(), '.claude', 'mcp_servers.json');
+}
+function readJsonSafe(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function writeJsonSafe(path, data) {
+    try {
+        const dir = join(path, '..');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(path, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function mcpEntry(apiKey) {
+    return {
+        command: 'npx',
+        args: ['-y', '@talkspresso/mcp-server'],
+        env: { TALKSPRESSO_API_KEY: apiKey },
+    };
+}
+export async function runSetup() {
+    process.on('SIGINT', () => {
+        console.log(`\n\n  ${chalk.dim('Setup cancelled. Run')} npx @talkspresso/mcp-server --setup ${chalk.dim('anytime.')}\n`);
+        process.exit(0);
+    });
+    const api = new SetupApiClient();
+    // Welcome
+    console.log(LOGO);
+    console.log(`  ${chalk.white.bold('Manage your business with AI.')}`);
+    console.log(`  ${chalk.dim("Let's get you connected in about 30 seconds.")}\n`);
+    // Account
+    let accessToken;
+    let userName;
+    let userEmail;
+    const hasAccount = await confirm({ message: 'Do you already have a Talkspresso account?' });
+    if (hasAccount) {
+        // Login flow
+        let attempts = 0;
+        while (true) {
+            const email = await input({ message: 'Email:' });
+            const pw = await passwordPrompt({ message: 'Password:' });
+            try {
+                const user = await api.login({ email, password: pw });
+                accessToken = user.access_token;
+                userName = user.name || email.split('@')[0];
+                userEmail = email;
+                console.log(`  ${chalk.green('✓')} Logged in as ${chalk.bold(email)}\n`);
+                break;
+            }
+            catch (err) {
+                attempts++;
+                if (attempts >= 3) {
+                    console.log(`\n  ${chalk.red('Too many failed attempts.')} Create an account at ${chalk.cyan('app.talkspresso.com')}\n`);
+                    process.exit(1);
+                }
+                console.log(`  ${chalk.red('✗')} Invalid email or password. Try again.\n`);
+            }
+        }
+    }
+    else {
+        // Registration flow
+        const name = await input({ message: 'Your name:' });
+        const email = await input({ message: 'Email:' });
+        const pw = await passwordPrompt({ message: 'Password (min 8 characters):' });
+        const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+        try {
+            const user = await api.register({ name, email, password: pw, timezone });
+            accessToken = user.access_token;
+            userName = name;
+            userEmail = email;
+            console.log(`  ${chalk.green('✓')} Account created for ${chalk.bold(email)}`);
+            console.log(`  ${chalk.dim(`Timezone: ${timezone}`)}\n`);
+        }
+        catch (err) {
+            const status = api.getStatus(err);
+            if (status === 409) {
+                console.log(`\n  ${chalk.yellow('Account already exists.')} Let's log you in instead.\n`);
+                const pw2 = await passwordPrompt({ message: 'Password:' });
+                try {
+                    const user = await api.login({ email, password: pw2 });
+                    accessToken = user.access_token;
+                    userName = user.name || name;
+                    userEmail = email;
+                    console.log(`  ${chalk.green('✓')} Logged in as ${chalk.bold(email)}\n`);
+                }
+                catch {
+                    console.log(`\n  ${chalk.red('Could not log in.')} Try again at ${chalk.cyan('app.talkspresso.com')}\n`);
+                    process.exit(1);
+                }
+            }
+            else {
+                console.log(`\n  ${chalk.red('Could not create account:')} ${err.message}\n`);
+                process.exit(1);
+            }
+        }
+    }
+    // Generate API key
+    api.setAccessToken(accessToken);
+    let apiKey;
+    try {
+        const keyData = await api.createApiKey('Claude AI Assistant');
+        apiKey = keyData.key;
+        console.log(`  ${chalk.green('✓')} API key created: ${chalk.dim(apiKey.substring(0, 12) + '...')}\n`);
+    }
+    catch (err) {
+        console.log(`  ${chalk.red('Could not create API key:')} ${err.message}`);
+        console.log(`  ${chalk.dim('Create one manually at')} ${chalk.cyan('app.talkspresso.com/settings/api-keys')}\n`);
+        process.exit(1);
+    }
+    // Configure Claude Desktop
+    const desktopPath = getClaudeDesktopConfigPath();
+    const desktopDir = join(desktopPath, '..');
+    let configuredDesktop = false;
+    if (existsSync(desktopDir)) {
+        const addDesktop = await confirm({ message: 'Add Talkspresso to Claude Desktop?' });
+        if (addDesktop) {
+            const existing = readJsonSafe(desktopPath) || {};
+            if (!existing.mcpServers)
+                existing.mcpServers = {};
+            existing.mcpServers.talkspresso = mcpEntry(apiKey);
+            configuredDesktop = writeJsonSafe(desktopPath, existing);
+            if (configuredDesktop) {
+                console.log(`  ${chalk.green('✓')} Claude Desktop configured\n`);
+            }
+            else {
+                console.log(`  ${chalk.red('✗')} Could not write config. Add manually:\n`);
+                console.log(chalk.dim(JSON.stringify({ mcpServers: { talkspresso: mcpEntry(apiKey) } }, null, 2)));
+                console.log();
+            }
+        }
+    }
+    // Configure Claude Code
+    const codePath = getClaudeCodeConfigPath();
+    let configuredCode = false;
+    const addCode = await confirm({ message: 'Add Talkspresso to Claude Code?' });
+    if (addCode) {
+        const existing = readJsonSafe(codePath) || {};
+        existing.talkspresso = mcpEntry(apiKey);
+        configuredCode = writeJsonSafe(codePath, existing);
+        if (configuredCode) {
+            console.log(`  ${chalk.green('✓')} Claude Code configured\n`);
+        }
+        else {
+            console.log(`  ${chalk.red('✗')} Could not write config. Add manually:\n`);
+            console.log(chalk.dim(JSON.stringify({ talkspresso: mcpEntry(apiKey) }, null, 2)));
+            console.log();
+        }
+    }
+    // Success
+    console.log(chalk.green.bold('\n  You\'re all set!\n'));
+    const done = [];
+    done.push(`Account: ${userEmail}`);
+    done.push(`API key generated and saved`);
+    if (configuredDesktop)
+        done.push('Claude Desktop configured');
+    if (configuredCode)
+        done.push('Claude Code configured');
+    for (const item of done) {
+        console.log(`  ${chalk.green('✓')} ${item}`);
+    }
+    console.log(`\n  ${chalk.bold('Next steps:')}\n`);
+    if (configuredDesktop || configuredCode) {
+        console.log(`  1. ${chalk.white('Restart Claude')} (if it\'s open)`);
+        console.log(`  2. ${chalk.white('Try:')} "Show me my Talkspresso schedule"`);
+    }
+    console.log(`  ${configuredDesktop || configuredCode ? '3' : '1'}. ${chalk.white('Open your dashboard:')} ${chalk.cyan('https://app.talkspresso.com/dashboard')}`);
+    console.log(`     ${chalk.dim('Brew will help you set up your first session.')}\n`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talkspresso/mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Manage your Talkspresso business through Claude, ChatGPT, or any MCP-compatible AI",
   "bin": {
     "talkspresso-mcp": "./dist/index.js"
@@ -12,17 +12,25 @@
     "dev": "tsx src/index.ts",
     "prepublishOnly": "npm run build"
   },
-  "keywords": ["mcp", "talkspresso", "ai", "claude", "chatgpt"],
+  "keywords": [
+    "mcp",
+    "talkspresso",
+    "ai",
+    "claude",
+    "chatgpt"
+  ],
   "license": "MIT",
   "dependencies": {
+    "@inquirer/prompts": "^8.2.1",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "axios": "^1.7.0",
+    "chalk": "^5.6.2",
     "zod": "^3.23.0"
   },
   "devDependencies": {
-    "typescript": "^5.5.0",
+    "@types/node": "^22.0.0",
     "tsx": "^4.0.0",
-    "@types/node": "^22.0.0"
+    "typescript": "^5.5.0"
   },
   "files": [
     "dist/**/*"