@tostudy-ai/mcp-setup 1.0.0

package/dist/config.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Claude Code Configuration Manager
+ *
+ * Handles reading/writing Claude Code's MCP server configuration.
+ */
+export interface ClaudeConfig {
+    mcpServers?: Record<string, McpServerConfig>;
+    [key: string]: unknown;
+}
+export interface McpServerConfig {
+    type?: 'sse' | 'stdio';
+    url?: string;
+    headers?: Record<string, string>;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * Get the path to Claude Code's config file based on OS
+ */
+export declare function getClaudeConfigPath(): string;
+/**
+ * Check if Claude Code is installed (config directory exists)
+ */
+export declare function isClaudeInstalled(): boolean;
+/**
+ * Read Claude Code's current config
+ */
+export declare function readClaudeConfig(): ClaudeConfig;
+/**
+ * Write Claude Code's config
+ */
+export declare function writeClaudeConfig(config: ClaudeConfig): void;
+/**
+ * Add Catalyst MCP server to Claude config
+ * Uses SSE transport - MCP server runs on port 3701
+ */
+export declare function addTostudyMcpServer(apiKey: string, platformUrl: string): void;
+/**
+ * Remove Catalyst MCP server from Claude config
+ */
+export declare function removeTostudyMcpServer(): void;
+/**
+ * Check if Catalyst MCP server is already configured
+ */
+export declare function isTostudyMcpConfigured(): boolean;
+/**
+ * Get the current Catalyst config if exists
+ */
+export declare function getTostudyMcpConfig(): McpServerConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAE9B,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAc5C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAI3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAc/C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAuB7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CAG5D"}

package/dist/config.js

@@ -0,0 +1,117 @@
+/**
+ * Claude Code Configuration Manager
+ *
+ * Handles reading/writing Claude Code's MCP server configuration.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir, platform } from 'node:os';
+/**
+ * Get the path to Claude Code's config file based on OS
+ */
+export function getClaudeConfigPath() {
+    const home = homedir();
+    const os = platform();
+    switch (os) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+        case 'win32':
+            return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+        case 'linux':
+            return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+        default:
+            throw new Error(`Unsupported operating system: ${os}`);
+    }
+}
+/**
+ * Check if Claude Code is installed (config directory exists)
+ */
+export function isClaudeInstalled() {
+    const configPath = getClaudeConfigPath();
+    const configDir = dirname(configPath);
+    return existsSync(configDir);
+}
+/**
+ * Read Claude Code's current config
+ */
+export function readClaudeConfig() {
+    const configPath = getClaudeConfigPath();
+    if (!existsSync(configPath)) {
+        return { mcpServers: {} };
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        // If config is corrupted, start fresh
+        return { mcpServers: {} };
+    }
+}
+/**
+ * Write Claude Code's config
+ */
+export function writeClaudeConfig(config) {
+    const configPath = getClaudeConfigPath();
+    const configDir = dirname(configPath);
+    // Ensure directory exists
+    if (!existsSync(configDir)) {
+        mkdirSync(configDir, { recursive: true });
+    }
+    // Backup existing config
+    if (existsSync(configPath)) {
+        const backupPath = `${configPath}.backup`;
+        copyFileSync(configPath, backupPath);
+    }
+    // Write new config with pretty formatting
+    writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+/**
+ * Add Catalyst MCP server to Claude config
+ * Uses SSE transport - MCP server runs on port 3701
+ */
+export function addTostudyMcpServer(apiKey, platformUrl) {
+    const config = readClaudeConfig();
+    // Initialize mcpServers if not exists
+    if (!config.mcpServers) {
+        config.mcpServers = {};
+    }
+    // MCP server URL (port 3701 for SSE endpoint)
+    const mcpServerUrl = platformUrl.replace(':3700', ':3701');
+    // Add Catalyst server using SSE transport
+    // SECURITY: Use Authorization header instead of URL query parameters
+    // API keys in URLs can be leaked via server logs, proxy logs, browser history, and HTTP Referer headers
+    config.mcpServers['tostudy'] = {
+        type: 'sse',
+        url: `${mcpServerUrl}/mcp/sse`,
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+        },
+    };
+    writeClaudeConfig(config);
+}
+/**
+ * Remove Catalyst MCP server from Claude config
+ */
+export function removeTostudyMcpServer() {
+    const config = readClaudeConfig();
+    if (config.mcpServers && config.mcpServers['tostudy']) {
+        delete config.mcpServers['tostudy'];
+        writeClaudeConfig(config);
+    }
+}
+/**
+ * Check if Catalyst MCP server is already configured
+ */
+export function isTostudyMcpConfigured() {
+    const config = readClaudeConfig();
+    return !!(config.mcpServers && config.mcpServers['tostudy']);
+}
+/**
+ * Get the current Catalyst config if exists
+ */
+export function getTostudyMcpConfig() {
+    const config = readClaudeConfig();
+    return config.mcpServers?.['tostudy'] || null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/detect.d.ts

@@ -0,0 +1,42 @@
+/**
+ * IDE Detection Module
+ *
+ * Detects installed IDEs (VS Code, JetBrains) for MCP configuration.
+ */
+export type IDEType = 'vscode' | 'vscode-insiders' | 'cursor' | 'jetbrains';
+export interface DetectedIDE {
+    type: IDEType;
+    name: string;
+    version?: string;
+    configPath: string;
+    installed: boolean;
+}
+/**
+ * Detect VS Code installation
+ */
+export declare function detectVSCode(): DetectedIDE;
+/**
+ * Detect VS Code Insiders installation
+ */
+export declare function detectVSCodeInsiders(): DetectedIDE;
+/**
+ * Detect Cursor IDE installation
+ */
+export declare function detectCursor(): DetectedIDE;
+/**
+ * Detect JetBrains IDE installation
+ */
+export declare function detectJetBrains(): DetectedIDE;
+/**
+ * Detect all supported IDEs
+ */
+export declare function detectAllIDEs(): DetectedIDE[];
+/**
+ * Get only installed IDEs
+ */
+export declare function getInstalledIDEs(): DetectedIDE[];
+/**
+ * Check if any supported IDE is installed
+ */
+export declare function hasAnyIDE(): boolean;
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,iBAAiB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE5E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAgLD;;GAEG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAQ1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAQlD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,WAAW,CAQ1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,WAAW,CAmC7C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAO7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC"}

package/dist/detect.js

@@ -0,0 +1,277 @@
+/**
+ * IDE Detection Module
+ *
+ * Detects installed IDEs (VS Code, JetBrains) for MCP configuration.
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+/**
+ * Get VS Code config directory based on OS
+ */
+function getVSCodeConfigDir(variant) {
+    const home = homedir();
+    const os = platform();
+    const folderNames = {
+        stable: 'Code',
+        insiders: 'Code - Insiders',
+        cursor: 'Cursor',
+    };
+    const folder = folderNames[variant];
+    switch (os) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', folder, 'User');
+        case 'win32':
+            return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), folder, 'User');
+        case 'linux':
+            return join(home, '.config', folder, 'User');
+        default:
+            return '';
+    }
+}
+/**
+ * Get VS Code MCP settings file path
+ */
+function getVSCodeMcpConfigPath(variant) {
+    const configDir = getVSCodeConfigDir(variant);
+    if (!configDir)
+        return '';
+    return join(configDir, 'globalStorage', 'saoudrizwan.claude-dev', 'settings', 'cline_mcp_settings.json');
+}
+/**
+ * Check if VS Code variant is installed
+ */
+function isVSCodeInstalled(variant) {
+    const os = platform();
+    const home = homedir();
+    const appNames = {
+        stable: ['Visual Studio Code.app', 'code'],
+        insiders: ['Visual Studio Code - Insiders.app', 'code-insiders'],
+        cursor: ['Cursor.app', 'cursor'],
+    };
+    const [macApp, linuxCmd] = appNames[variant];
+    switch (os) {
+        case 'darwin':
+            // Check /Applications folder
+            return existsSync(join('/Applications', macApp)) ||
+                existsSync(join(home, 'Applications', macApp));
+        case 'win32': {
+            // Check common Windows install locations
+            const programFiles = process.env.ProgramFiles || 'C:\\Program Files';
+            const programFilesX86 = process.env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)';
+            const localAppData = process.env.LOCALAPPDATA || join(home, 'AppData', 'Local');
+            const winPaths = variant === 'cursor'
+                ? [join(localAppData, 'Programs', 'cursor', 'Cursor.exe')]
+                : [
+                    join(programFiles, 'Microsoft VS Code', 'Code.exe'),
+                    join(programFilesX86, 'Microsoft VS Code', 'Code.exe'),
+                    join(localAppData, 'Programs', 'Microsoft VS Code', 'Code.exe'),
+                ];
+            if (variant === 'insiders') {
+                winPaths.push(join(programFiles, 'Microsoft VS Code Insiders', 'Code - Insiders.exe'), join(localAppData, 'Programs', 'Microsoft VS Code Insiders', 'Code - Insiders.exe'));
+            }
+            return winPaths.some((p) => existsSync(p));
+        }
+        case 'linux':
+            // Check if config directory exists (indicates installation)
+            return existsSync(getVSCodeConfigDir(variant)) ||
+                existsSync(join('/usr/bin', linuxCmd)) ||
+                existsSync(join('/usr/local/bin', linuxCmd)) ||
+                existsSync(join(home, '.local', 'bin', linuxCmd));
+        default:
+            return false;
+    }
+}
+/**
+ * Get JetBrains config directory based on OS
+ */
+function getJetBrainsConfigDir() {
+    const home = homedir();
+    const os = platform();
+    switch (os) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'JetBrains');
+        case 'win32':
+            return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'JetBrains');
+        case 'linux':
+            return join(home, '.config', 'JetBrains');
+        default:
+            return '';
+    }
+}
+/**
+ * List installed JetBrains IDEs by scanning config directory
+ */
+function getInstalledJetBrainsIDEs() {
+    const configDir = getJetBrainsConfigDir();
+    if (!configDir || !existsSync(configDir)) {
+        return [];
+    }
+    try {
+        const entries = readdirSync(configDir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .filter((name) => {
+            // Filter for actual IDE directories (e.g., IntelliJIdea2024.1, WebStorm2023.3)
+            return /^(IntelliJIdea|WebStorm|PyCharm|PhpStorm|GoLand|Rider|CLion|RubyMine|DataGrip|Fleet)\d{4}\.\d/i.test(name);
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check if any JetBrains IDE is installed
+ */
+function isJetBrainsInstalled() {
+    const installedIDEs = getInstalledJetBrainsIDEs();
+    return installedIDEs.length > 0;
+}
+/**
+ * Get the primary JetBrains IDE name (most recently versioned)
+ */
+function getPrimaryJetBrainsIDE() {
+    const installedIDEs = getInstalledJetBrainsIDEs();
+    if (installedIDEs.length === 0)
+        return null;
+    // Sort by version (descending) to get most recent
+    const sorted = installedIDEs.sort((a, b) => {
+        const versionA = a.match(/\d{4}\.\d/)?.[0] || '0';
+        const versionB = b.match(/\d{4}\.\d/)?.[0] || '0';
+        return versionB.localeCompare(versionA);
+    });
+    return sorted[0];
+}
+/**
+ * Get JetBrains MCP config path for a specific IDE version directory
+ */
+function getJetBrainsMcpConfigPath(ideDir) {
+    const configDir = getJetBrainsConfigDir();
+    if (!configDir)
+        return '';
+    const targetDir = ideDir || getPrimaryJetBrainsIDE();
+    if (!targetDir)
+        return '';
+    // MCP Claude plugin stores config in options directory
+    return join(configDir, targetDir, 'options', 'mcp-servers.json');
+}
+/**
+ * Detect VS Code installation
+ */
+export function detectVSCode() {
+    const installed = isVSCodeInstalled('stable');
+    return {
+        type: 'vscode',
+        name: 'Visual Studio Code',
+        configPath: getVSCodeMcpConfigPath('stable'),
+        installed,
+    };
+}
+/**
+ * Detect VS Code Insiders installation
+ */
+export function detectVSCodeInsiders() {
+    const installed = isVSCodeInstalled('insiders');
+    return {
+        type: 'vscode-insiders',
+        name: 'Visual Studio Code - Insiders',
+        configPath: getVSCodeMcpConfigPath('insiders'),
+        installed,
+    };
+}
+/**
+ * Detect Cursor IDE installation
+ */
+export function detectCursor() {
+    const installed = isVSCodeInstalled('cursor');
+    return {
+        type: 'cursor',
+        name: 'Cursor',
+        configPath: getVSCodeMcpConfigPath('cursor'),
+        installed,
+    };
+}
+/**
+ * Detect JetBrains IDE installation
+ */
+export function detectJetBrains() {
+    const installed = isJetBrainsInstalled();
+    const primaryIDE = getPrimaryJetBrainsIDE();
+    // Extract IDE name and version from directory name
+    let name = 'JetBrains IDE';
+    let version;
+    if (primaryIDE) {
+        const match = primaryIDE.match(/^(\w+?)(\d{4}\.\d)/);
+        if (match) {
+            const ideNames = {
+                'IntelliJIdea': 'IntelliJ IDEA',
+                'WebStorm': 'WebStorm',
+                'PyCharm': 'PyCharm',
+                'PhpStorm': 'PhpStorm',
+                'GoLand': 'GoLand',
+                'Rider': 'Rider',
+                'CLion': 'CLion',
+                'RubyMine': 'RubyMine',
+                'DataGrip': 'DataGrip',
+                'Fleet': 'Fleet',
+            };
+            name = ideNames[match[1]] || match[1];
+            version = match[2];
+        }
+    }
+    return {
+        type: 'jetbrains',
+        name,
+        version,
+        configPath: getJetBrainsMcpConfigPath(),
+        installed,
+    };
+}
+/**
+ * Detect all supported IDEs
+ */
+export function detectAllIDEs() {
+    return [
+        detectVSCode(),
+        detectVSCodeInsiders(),
+        detectCursor(),
+        detectJetBrains(),
+    ];
+}
+/**
+ * Get only installed IDEs
+ */
+export function getInstalledIDEs() {
+    return detectAllIDEs().filter((ide) => ide.installed);
+}
+/**
+ * Check if any supported IDE is installed
+ */
+export function hasAnyIDE() {
+    return detectAllIDEs().some((ide) => ide.installed);
+}
+// CLI entry point for testing
+if (process.argv[1]?.endsWith('detect.js')) {
+    const installedIDEs = getInstalledIDEs();
+    if (installedIDEs.length === 0) {
+        process.stdout.write('No supported IDEs detected.\n');
+        process.stdout.write('\nSupported IDEs:\n');
+        process.stdout.write('  - Visual Studio Code\n');
+        process.stdout.write('  - Visual Studio Code - Insiders\n');
+        process.stdout.write('  - Cursor\n');
+        process.stdout.write('  - JetBrains IDEs (IntelliJ, WebStorm, PyCharm, etc.)\n');
+    }
+    else {
+        process.stdout.write('Detected IDEs:\n');
+        for (const ide of installedIDEs) {
+            const versionStr = ide.version ? ` (${ide.version})` : '';
+            process.stdout.write(`  ✓ ${ide.name}${versionStr}\n`);
+            process.stdout.write(`    Config: ${ide.configPath || 'N/A'}\n`);
+        }
+    }
+    // Output as JSON for programmatic use
+    process.stdout.write('\n--- JSON Output ---\n');
+    process.stdout.write(JSON.stringify(installedIDEs, null, 2) + '\n');
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"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"}

package/dist/diagnose.d.ts

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * MCP Diagnostic Module
+ *
+ * Performs diagnostic checks for common MCP configuration issues.
+ * Detects port conflicts, missing config, auth errors, and connectivity problems.
+ */
+export type IssueSeverity = 'critical' | 'warning' | 'info';
+export interface DiagnosticIssue {
+    id: string;
+    severity: IssueSeverity;
+    title: string;
+    description: string;
+    suggestion: string;
+    autoFixable: boolean;
+}
+export interface DiagnosticReport {
+    timestamp: string;
+    claudeInstalled: boolean;
+    mcpConfigured: boolean;
+    issues: DiagnosticIssue[];
+    passed: boolean;
+}
+/**
+ * Run all diagnostic checks
+ */
+export declare function runDiagnostics(): Promise<DiagnosticReport>;
+/**
+ * Print diagnostic report to console
+ */
+export declare function printDiagnosticReport(report: DiagnosticReport): void;
+/**
+ * Export diagnostic report as JSON
+ */
+export declare function exportDiagnosticReportJson(report: DiagnosticReport): string;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../src/diagnose.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAcH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AA2YD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAyDhE;AA8BD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAkDpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE3E"}