@syke1/mcp-server 1.2.0 → 1.3.0

package/README.md

@@ -23,7 +23,10 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible AI
       "command": "npx",
       "args": ["@syke1/mcp-server@latest"],
       "env": {
-        "SYKE_LICENSE_KEY": "your-key-here"
+        "SYKE_LICENSE_KEY": "your-key-here",
+        "GEMINI_KEY": "your-gemini-key",
+        "OPENAI_KEY": "your-openai-key",
+        "ANTHROPIC_KEY": "your-anthropic-key"
       }
     }
   }
@@ -39,7 +42,8 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible AI
       "command": "npx",
       "args": ["@syke1/mcp-server@latest"],
       "env": {
-        "SYKE_LICENSE_KEY": "your-key-here"
+        "SYKE_LICENSE_KEY": "your-key-here",
+        "GEMINI_KEY": "your-gemini-key"
       }
     }
   }
@@ -55,13 +59,16 @@ Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible AI
       "command": "npx",
       "args": ["@syke1/mcp-server@latest"],
       "env": {
-        "SYKE_LICENSE_KEY": "your-key-here"
+        "SYKE_LICENSE_KEY": "your-key-here",
+        "GEMINI_KEY": "your-gemini-key"
       }
     }
   }
 }
 ```
 
+> **Note:** You only need ONE AI key. SYKE auto-selects: Gemini > OpenAI > Anthropic. Set `SYKE_AI_PROVIDER` to force a specific one.
+
 > **Windows note:** If `npx` is not found, use the full path: `"command": "C:\\Program Files\\nodejs\\npx.cmd"`
 
 ### 2. Restart your AI agent
@@ -84,9 +91,22 @@ A web dashboard opens automatically at `http://localhost:3333` showing your live
 | `get_dependencies` | Lists internal imports (forward dependencies) of a file. |
 | `get_hub_files` | Ranks files by how many other files depend on them. |
 | `refresh_graph` | Re-scans all source files and rebuilds the dependency graph. |
-| `ai_analyze` | **Pro** — Gemini AI semantic analysis of a file and its dependents. |
+| `ai_analyze` | **Pro** — AI semantic analysis (Gemini/OpenAI/Claude) of a file and its dependents. |
 | `check_warnings` | Real-time monitoring alerts for file changes that may break dependents. |
 
+### Multi-AI Provider Support
+
+SYKE supports three AI providers for semantic analysis. Bring your own key:
+
+| Provider | Model | Env Variable |
+|----------|-------|-------------|
+| Google Gemini | `gemini-2.5-flash` | `GEMINI_KEY` |
+| OpenAI | `gpt-4o-mini` | `OPENAI_KEY` |
+| Anthropic | `claude-sonnet-4-20250514` | `ANTHROPIC_KEY` |
+
+**Auto-selection:** SYKE uses the first available key (Gemini > OpenAI > Anthropic).
+**Force provider:** Set `SYKE_AI_PROVIDER=openai` (or `gemini`, `anthropic`) to override.
+
 ### Language Support
 
 Auto-detected, zero-config: **Dart/Flutter**, **TypeScript/JavaScript**, **Python**, **Go**, **Rust**, **Java**, **C++**, **Ruby**.
@@ -110,7 +130,7 @@ Live dependency graph visualization at `localhost:3333` with:
 - All tools including get_hub_files, ai_analyze, check_warnings
 - Real-time cascade monitoring (SSE)
 - Cycle detection & simulation
-- AI semantic analysis (BYOK Gemini key)
+- AI semantic analysis (BYOK — Gemini, OpenAI, or Claude)
 - Priority support
 
 Get your license key at [syke.cloud/dashboard](https://syke.cloud/dashboard/).
@@ -120,7 +140,10 @@ Get your license key at [syke.cloud/dashboard](https://syke.cloud/dashboard/).
 | Environment Variable | Description | Required |
 |---------------------|-------------|----------|
 | `SYKE_LICENSE_KEY` | Pro license key from dashboard | No (Free tier works without) |
-| `GEMINI_KEY` | Google Gemini API key for `ai_analyze` | Pro only |
+| `GEMINI_KEY` | Google Gemini API key for `ai_analyze` | No (any one AI key) |
+| `OPENAI_KEY` | OpenAI API key for `ai_analyze` | No (any one AI key) |
+| `ANTHROPIC_KEY` | Anthropic API key for `ai_analyze` | No (any one AI key) |
+| `SYKE_AI_PROVIDER` | Force AI provider: `gemini`, `openai`, or `anthropic` | No (auto-selects) |
 | `SYKE_WEB_PORT` | Dashboard port (default: 3333) | No |
 | `SYKE_NO_BROWSER` | Set to `1` to disable auto-open browser | No |
 | `SYKE_currentProjectRoot` | Override auto-detected project root | No |

package/dist/ai/analyzer.js

@@ -36,18 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeWithAI = analyzeWithAI;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const generative_ai_1 = require("@google/generative-ai");
-let genAI = null;
-function getGenAI() {
-    if (!genAI) {
-        const key = process.env.GEMINI_KEY;
-        if (!key) {
-            throw new Error("GEMINI_KEY environment variable is required for AI analysis");
-        }
-        genAI = new generative_ai_1.GoogleGenerativeAI(key);
-    }
-    return genAI;
-}
+const provider_1 = require("./provider");
+const context_extractor_1 = require("./context-extractor");
 function readFileContent(filePath) {
     try {
         return fs.readFileSync(filePath, "utf-8");
@@ -78,20 +68,26 @@ function buildSystemPrompt(languages) {
 한국어로 답변하세요. 간결하되 구체적으로 작성하세요.`;
 }
 async function analyzeWithAI(filePath, impactResult, graph) {
-    const ai = getGenAI();
-    const model = ai.getGenerativeModel({ model: "gemini-2.5-flash" });
+    const provider = (0, provider_1.getAIProvider)();
+    if (!provider) {
+        return "AI 분석 비활성화 — GEMINI_KEY, OPENAI_KEY, 또는 ANTHROPIC_KEY를 설정하세요.";
+    }
     const targetSource = readFileContent(filePath);
     if (!targetSource) {
         return `파일을 읽을 수 없습니다: ${filePath}`;
     }
     const codeBlockLang = graph.languages[0] || "text";
+    // Build smart context for the target file
+    const smartTarget = (0, context_extractor_1.buildSmartContext)(targetSource, codeBlockLang);
+    // Build smart context for dependent files (top 5)
     const directDeps = (graph.reverse.get(path.normalize(filePath)) || []).slice(0, 5);
     const dependentSources = [];
     for (const dep of directDeps) {
         const source = readFileContent(dep);
         if (source) {
             const rel = path.relative(graph.sourceDir, dep).replace(/\\/g, "/");
-            dependentSources.push(`### ${rel}\n\`\`\`${codeBlockLang}\n${source}\n\`\`\``);
+            const smartDep = (0, context_extractor_1.buildSmartContext)(source, codeBlockLang);
+            dependentSources.push(`### ${rel}\n\`\`\`${codeBlockLang}\n${smartDep}\n\`\`\``);
         }
     }
     const userPrompt = `## 분석 대상 파일: ${impactResult.relativePath}
@@ -102,17 +98,13 @@ async function analyzeWithAI(filePath, impactResult, graph) {
 
 ### 대상 파일 소스코드
 \`\`\`${codeBlockLang}
-${targetSource}
+${smartTarget}
 \`\`\`
 
 ${dependentSources.length > 0 ? `### 이 파일에 의존하는 파일들 (상위 ${dependentSources.length}개)\n${dependentSources.join("\n\n")}` : "이 파일에 의존하는 내부 파일이 없습니다."}`;
     try {
         const systemPrompt = buildSystemPrompt(graph.languages);
-        const result = await model.generateContent({
-            contents: [{ role: "user", parts: [{ text: userPrompt }] }],
-            systemInstruction: { role: "model", parts: [{ text: systemPrompt }] },
-        });
-        return result.response.text();
+        return await provider.analyze(systemPrompt, userPrompt);
     }
     catch (err) {
         return `AI 분석 중 오류 발생: ${err.message || err}`;

package/dist/ai/context-extractor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Semantic context extractor — structural code analysis for AI prompts.
+ * Extracts function/class/type signatures, compares changes, builds smart context.
+ */
+export interface CodeSignature {
+    type: "function" | "class" | "interface" | "type" | "variable";
+    name: string;
+    signature: string;
+    exported: boolean;
+    line: number;
+}
+export interface SignatureChange {
+    type: "added" | "removed" | "modified";
+    name: string;
+    oldSignature?: string;
+    newSignature?: string;
+}
+/**
+ * Extract function/class/type signatures from source code.
+ */
+export declare function extractSignatures(content: string, lang: string): CodeSignature[];
+/**
+ * Compare signatures between old and new file content.
+ * Returns structural changes (added/removed/modified declarations).
+ */
+export declare function diffSignatures(oldContent: string, newContent: string, lang: string): SignatureChange[];
+/**
+ * Build a smart context summary of a file for AI prompts.
+ * Short files (<100 lines) are passed through as-is.
+ * Longer files get: imports + exported signatures + body summary.
+ */
+export declare function buildSmartContext(content: string, lang: string, maxLines?: number): string;

package/dist/ai/context-extractor.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * Semantic context extractor — structural code analysis for AI prompts.
+ * Extracts function/class/type signatures, compares changes, builds smart context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSignatures = extractSignatures;
+exports.diffSignatures = diffSignatures;
+exports.buildSmartContext = buildSmartContext;
+const LANG_PATTERNS = {
+    typescript: {
+        patterns: [
+            { type: "function", regex: /^(export\s+)?(async\s+)?function\s+(\w+)\s*(<[^>]*>)?\s*\([^)]*\)/gm },
+            { type: "class", regex: /^(export\s+)?(abstract\s+)?class\s+(\w+)(\s+extends\s+\w+)?(\s+implements\s+[\w,\s]+)?/gm },
+            { type: "interface", regex: /^(export\s+)?interface\s+(\w+)(\s+extends\s+[\w,\s]+)?/gm },
+            { type: "type", regex: /^(export\s+)?type\s+(\w+)\s*(<[^>]*>)?\s*=/gm },
+            { type: "variable", regex: /^(export\s+)?(const|let)\s+(\w+)\s*[=:]/gm },
+        ],
+    },
+    dart: {
+        patterns: [
+            { type: "class", regex: /^(abstract\s+)?class\s+(\w+)(\s+extends\s+\w+)?(\s+with\s+[\w,\s]+)?(\s+implements\s+[\w,\s]+)?/gm },
+            { type: "function", regex: /^\s*(static\s+)?(Future<[^>]+>|void|String|int|double|bool|List<[^>]+>|Map<[^>]+>|Set<[^>]+>|\w+\??)\s+(\w+)\s*\([^)]*\)/gm },
+            { type: "variable", regex: /^\s*(static\s+)?(final|const|late\s+final)\s+(\w+\??)\s+(\w+)/gm },
+        ],
+    },
+    python: {
+        patterns: [
+            { type: "function", regex: /^(async\s+)?def\s+(\w+)\s*\([^)]*\)(\s*->\s*\w+)?/gm },
+            { type: "class", regex: /^class\s+(\w+)(\([^)]*\))?/gm },
+            { type: "variable", regex: /^(\w+)\s*:\s*\w+\s*=/gm },
+        ],
+    },
+    go: {
+        patterns: [
+            { type: "function", regex: /^func\s+(\([^)]+\)\s+)?(\w+)\s*\([^)]*\)(\s*\([^)]*\)|\s*\w+)?/gm },
+            { type: "interface", regex: /^type\s+(\w+)\s+interface/gm },
+            { type: "type", regex: /^type\s+(\w+)\s+struct/gm },
+        ],
+    },
+    rust: {
+        patterns: [
+            { type: "function", regex: /^(pub\s+)?(async\s+)?fn\s+(\w+)\s*(<[^>]*>)?\s*\([^)]*\)(\s*->\s*[\w<>&]+)?/gm },
+            { type: "class", regex: /^(pub\s+)?struct\s+(\w+)/gm },
+            { type: "interface", regex: /^(pub\s+)?trait\s+(\w+)/gm },
+            { type: "type", regex: /^(pub\s+)?enum\s+(\w+)/gm },
+        ],
+    },
+    java: {
+        patterns: [
+            { type: "class", regex: /^(public\s+)?(abstract\s+)?class\s+(\w+)(\s+extends\s+\w+)?(\s+implements\s+[\w,\s]+)?/gm },
+            { type: "interface", regex: /^(public\s+)?interface\s+(\w+)(\s+extends\s+[\w,\s]+)?/gm },
+            { type: "function", regex: /^\s*(public|protected|private)?\s*(static\s+)?([\w<>\[\]]+)\s+(\w+)\s*\([^)]*\)/gm },
+        ],
+    },
+    cpp: {
+        patterns: [
+            { type: "class", regex: /^(class|struct)\s+(\w+)/gm },
+            { type: "function", regex: /^(virtual\s+)?(static\s+)?([\w:*&<>]+)\s+(\w+)\s*\([^)]*\)/gm },
+        ],
+    },
+    ruby: {
+        patterns: [
+            { type: "class", regex: /^class\s+(\w+)(\s*<\s*\w+)?/gm },
+            { type: "function", regex: /^\s*def\s+(self\.)?(\w+[?!]?)\s*(\([^)]*\))?/gm },
+        ],
+    },
+};
+// Map file extensions / language names to pattern keys
+function getLangKey(lang) {
+    const map = {
+        ts: "typescript", tsx: "typescript", typescript: "typescript", javascript: "typescript", js: "typescript",
+        dart: "dart", flutter: "dart",
+        py: "python", python: "python",
+        go: "go",
+        rs: "rust", rust: "rust",
+        java: "java", kotlin: "java",
+        cpp: "cpp", "c++": "cpp", c: "cpp", h: "cpp", hpp: "cpp",
+        rb: "ruby", ruby: "ruby",
+    };
+    return map[lang.toLowerCase()] || "typescript"; // fallback to TS patterns
+}
+// ── Signature Extraction ────────────────────────────────────────────
+/**
+ * Extract function/class/type signatures from source code.
+ */
+function extractSignatures(content, lang) {
+    const langKey = getLangKey(lang);
+    const langPatterns = LANG_PATTERNS[langKey];
+    if (!langPatterns)
+        return [];
+    const lines = content.split("\n");
+    const signatures = [];
+    const seen = new Set();
+    for (const { type, regex } of langPatterns.patterns) {
+        // Reset regex state
+        regex.lastIndex = 0;
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            const matchLine = content.substring(0, match.index).split("\n").length;
+            const fullLine = lines[matchLine - 1]?.trim() || match[0].trim();
+            const exported = /^export\s/.test(fullLine) || /^pub\s/.test(fullLine);
+            // Extract name (last capturing group that looks like a name)
+            let name = "";
+            for (let i = match.length - 1; i >= 1; i--) {
+                if (match[i] && /^\w+$/.test(match[i])) {
+                    name = match[i];
+                    break;
+                }
+            }
+            if (!name)
+                name = fullLine.split(/[\s(<{=]/)[1] || "unknown";
+            const key = `${type}:${name}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            signatures.push({
+                type,
+                name,
+                signature: fullLine,
+                exported,
+                line: matchLine,
+            });
+        }
+    }
+    return signatures.sort((a, b) => a.line - b.line);
+}
+// ── Signature Diff ──────────────────────────────────────────────────
+/**
+ * Compare signatures between old and new file content.
+ * Returns structural changes (added/removed/modified declarations).
+ */
+function diffSignatures(oldContent, newContent, lang) {
+    const oldSigs = extractSignatures(oldContent, lang);
+    const newSigs = extractSignatures(newContent, lang);
+    const oldMap = new Map(oldSigs.map((s) => [`${s.type}:${s.name}`, s]));
+    const newMap = new Map(newSigs.map((s) => [`${s.type}:${s.name}`, s]));
+    const changes = [];
+    // Removed
+    for (const [key, sig] of oldMap) {
+        if (!newMap.has(key)) {
+            changes.push({ type: "removed", name: sig.name, oldSignature: sig.signature });
+        }
+    }
+    // Added
+    for (const [key, sig] of newMap) {
+        if (!oldMap.has(key)) {
+            changes.push({ type: "added", name: sig.name, newSignature: sig.signature });
+        }
+    }
+    // Modified
+    for (const [key, newSig] of newMap) {
+        const oldSig = oldMap.get(key);
+        if (oldSig && oldSig.signature !== newSig.signature) {
+            changes.push({
+                type: "modified",
+                name: newSig.name,
+                oldSignature: oldSig.signature,
+                newSignature: newSig.signature,
+            });
+        }
+    }
+    return changes;
+}
+// ── Smart Context Builder ───────────────────────────────────────────
+/**
+ * Build a smart context summary of a file for AI prompts.
+ * Short files (<100 lines) are passed through as-is.
+ * Longer files get: imports + exported signatures + body summary.
+ */
+function buildSmartContext(content, lang, maxLines = 100) {
+    const lines = content.split("\n");
+    // Short files: return as-is
+    if (lines.length <= maxLines)
+        return content;
+    const parts = [];
+    const importLines = [];
+    let lastImportLine = 0;
+    // Collect imports
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line.startsWith("import ") ||
+            line.startsWith("from ") ||
+            line.startsWith("require(") ||
+            line.startsWith("const ") && line.includes("require(") ||
+            line.startsWith("use ") ||
+            line.startsWith("#include") ||
+            line.startsWith("package ")) {
+            importLines.push(lines[i]);
+            lastImportLine = i;
+        }
+        // Stop scanning after a non-import, non-blank line beyond the header
+        if (i > 20 && line && !line.startsWith("import") && !line.startsWith("from") && !line.startsWith("//") && !line.startsWith("#") && !line.startsWith("*") && !line.startsWith("/*")) {
+            break;
+        }
+    }
+    if (importLines.length > 0) {
+        parts.push("// ── Imports ──");
+        parts.push(...importLines);
+        parts.push("");
+    }
+    // Collect exported signatures
+    const sigs = extractSignatures(content, lang).filter((s) => s.exported);
+    if (sigs.length > 0) {
+        parts.push("// ── Exported Declarations ──");
+        for (const sig of sigs) {
+            parts.push(`${sig.signature}  // L${sig.line}`);
+        }
+        parts.push("");
+    }
+    // All signatures (non-exported)
+    const privateSigs = extractSignatures(content, lang).filter((s) => !s.exported);
+    if (privateSigs.length > 0) {
+        parts.push("// ── Internal Declarations ──");
+        for (const sig of privateSigs) {
+            parts.push(`${sig.signature}  // L${sig.line}`);
+        }
+        parts.push("");
+    }
+    const bodyLines = lines.length - lastImportLine - 1;
+    parts.push(`// ... (${bodyLines} lines of implementation omitted)`);
+    parts.push(`// Total: ${lines.length} lines`);
+    return parts.join("\n");
+}

package/dist/ai/provider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AI Provider abstraction — Multi-AI support (Gemini, OpenAI, Anthropic)
+ * Automatically selects the best available provider based on API keys.
+ */
+export interface AIProvider {
+    name: string;
+    analyze(systemPrompt: string, userPrompt: string): Promise<string>;
+    analyzeJSON<T>(systemPrompt: string, userPrompt: string): Promise<T>;
+}
+/**
+ * Returns the best available AI provider, or null if no API key is set.
+ *
+ * Priority:
+ * 1. SYKE_AI_PROVIDER env var forces a specific provider
+ * 2. Auto-select: GEMINI_KEY > OPENAI_KEY > ANTHROPIC_KEY
+ */
+export declare function getAIProvider(): AIProvider | null;
+/**
+ * Human-readable name for the active AI provider (for logs/UI).
+ */
+export declare function getProviderName(): string;

package/dist/ai/provider.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * AI Provider abstraction — Multi-AI support (Gemini, OpenAI, Anthropic)
+ * Automatically selects the best available provider based on API keys.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAIProvider = getAIProvider;
+exports.getProviderName = getProviderName;
+const generative_ai_1 = require("@google/generative-ai");
+// ── Gemini ──────────────────────────────────────────────────────────
+class GeminiProvider {
+    constructor(apiKey) {
+        this.name = "Gemini (gemini-2.5-flash)";
+        this.ai = new generative_ai_1.GoogleGenerativeAI(apiKey);
+    }
+    async analyze(systemPrompt, userPrompt) {
+        const model = this.ai.getGenerativeModel({ model: "gemini-2.5-flash" });
+        const result = await model.generateContent({
+            contents: [{ role: "user", parts: [{ text: userPrompt }] }],
+            systemInstruction: { role: "model", parts: [{ text: systemPrompt }] },
+        });
+        return result.response.text();
+    }
+    async analyzeJSON(systemPrompt, userPrompt) {
+        const text = await this.analyze(systemPrompt, userPrompt);
+        let jsonStr = text;
+        const jsonMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+        if (jsonMatch)
+            jsonStr = jsonMatch[1];
+        return JSON.parse(jsonStr.trim());
+    }
+}
+// ── OpenAI ──────────────────────────────────────────────────────────
+class OpenAIProvider {
+    constructor(apiKey) {
+        this.name = "OpenAI (gpt-4o-mini)";
+        this.apiKey = apiKey;
+    }
+    async analyze(systemPrompt, userPrompt) {
+        const res = await fetch("https://api.openai.com/v1/chat/completions", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: "gpt-4o-mini",
+                messages: [
+                    { role: "system", content: systemPrompt },
+                    { role: "user", content: userPrompt },
+                ],
+                temperature: 0.3,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`OpenAI API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return data.choices[0].message.content;
+    }
+    async analyzeJSON(systemPrompt, userPrompt) {
+        const res = await fetch("https://api.openai.com/v1/chat/completions", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: "gpt-4o-mini",
+                messages: [
+                    { role: "system", content: systemPrompt },
+                    { role: "user", content: userPrompt },
+                ],
+                temperature: 0.3,
+                response_format: { type: "json_object" },
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`OpenAI API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return JSON.parse(data.choices[0].message.content);
+    }
+}
+// ── Anthropic ───────────────────────────────────────────────────────
+class AnthropicProvider {
+    constructor(apiKey) {
+        this.name = "Claude (claude-sonnet-4-20250514)";
+        this.apiKey = apiKey;
+    }
+    async analyze(systemPrompt, userPrompt) {
+        const res = await fetch("https://api.anthropic.com/v1/messages", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": this.apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify({
+                model: "claude-sonnet-4-20250514",
+                max_tokens: 4096,
+                system: systemPrompt,
+                messages: [{ role: "user", content: userPrompt }],
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            throw new Error(`Anthropic API error ${res.status}: ${body}`);
+        }
+        const data = (await res.json());
+        return data.content[0].text;
+    }
+    async analyzeJSON(systemPrompt, userPrompt) {
+        const text = await this.analyze(systemPrompt + "\n\nJSON만 응답하세요. 설명 텍스트 없이 순수 JSON만.", userPrompt);
+        let jsonStr = text;
+        const jsonMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+        if (jsonMatch)
+            jsonStr = jsonMatch[1];
+        return JSON.parse(jsonStr.trim());
+    }
+}
+// ── Factory ─────────────────────────────────────────────────────────
+let cachedProvider = undefined;
+/**
+ * Returns the best available AI provider, or null if no API key is set.
+ *
+ * Priority:
+ * 1. SYKE_AI_PROVIDER env var forces a specific provider
+ * 2. Auto-select: GEMINI_KEY > OPENAI_KEY > ANTHROPIC_KEY
+ */
+function getAIProvider() {
+    if (cachedProvider !== undefined)
+        return cachedProvider;
+    const forced = process.env.SYKE_AI_PROVIDER?.toLowerCase();
+    if (forced) {
+        if (forced === "gemini" && process.env.GEMINI_KEY) {
+            cachedProvider = new GeminiProvider(process.env.GEMINI_KEY);
+        }
+        else if (forced === "openai" && process.env.OPENAI_KEY) {
+            cachedProvider = new OpenAIProvider(process.env.OPENAI_KEY);
+        }
+        else if (forced === "anthropic" && process.env.ANTHROPIC_KEY) {
+            cachedProvider = new AnthropicProvider(process.env.ANTHROPIC_KEY);
+        }
+        else {
+            console.error(`[syke] SYKE_AI_PROVIDER=${forced} but no matching API key found`);
+            cachedProvider = null;
+        }
+        return cachedProvider;
+    }
+    // Auto-select
+    if (process.env.GEMINI_KEY) {
+        cachedProvider = new GeminiProvider(process.env.GEMINI_KEY);
+    }
+    else if (process.env.OPENAI_KEY) {
+        cachedProvider = new OpenAIProvider(process.env.OPENAI_KEY);
+    }
+    else if (process.env.ANTHROPIC_KEY) {
+        cachedProvider = new AnthropicProvider(process.env.ANTHROPIC_KEY);
+    }
+    else {
+        cachedProvider = null;
+    }
+    return cachedProvider;
+}
+/**
+ * Human-readable name for the active AI provider (for logs/UI).
+ */
+function getProviderName() {
+    const provider = getAIProvider();
+    return provider ? provider.name : "disabled";
+}

package/dist/ai/realtime-analyzer.d.ts

@@ -14,7 +14,7 @@ export interface RealtimeAnalysis {
     analysisMs: number;
 }
 /**
- * Analyze a file change in real-time using Gemini.
+ * Analyze a file change in real-time using the configured AI provider.
  * Receives the diff + connected files context from memory cache.
  */
 export declare function analyzeChangeRealtime(change: FileChange, graph: DependencyGraph, getFileContent: (relPath: string) => string | null): Promise<RealtimeAnalysis>;

package/dist/ai/realtime-analyzer.js

@@ -34,9 +34,10 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.analyzeChangeRealtime = analyzeChangeRealtime;
-const generative_ai_1 = require("@google/generative-ai");
 const analyze_impact_1 = require("../tools/analyze-impact");
 const path = __importStar(require("path"));
+const provider_1 = require("./provider");
+const context_extractor_1 = require("./context-extractor");
 const REALTIME_SYSTEM_PROMPT = `당신은 20년 경력의 풀스택 아키텍트이자, 코드 영향도 감시 AI입니다.
 역할: 파일이 수정/추가/삭제될 때, 빌드 전에 잠재적 오류와 연쇄 영향을 감지합니다.
 
@@ -64,18 +65,8 @@ LOW: 사소한 영향
 SAFE: 안전한 변경
 
 JSON만 응답하세요. 설명 텍스트 없이 순수 JSON만.`;
-let genAI = null;
-function getGenAI() {
-    if (!genAI) {
-        const key = process.env.GEMINI_KEY;
-        if (!key)
-            throw new Error("GEMINI_KEY required");
-        genAI = new generative_ai_1.GoogleGenerativeAI(key);
-    }
-    return genAI;
-}
 /**
- * Analyze a file change in real-time using Gemini.
+ * Analyze a file change in real-time using the configured AI provider.
  * Receives the diff + connected files context from memory cache.
  */
 async function analyzeChangeRealtime(change, graph, getFileContent) {
@@ -89,7 +80,7 @@ async function analyzeChangeRealtime(change, graph, getFileContent) {
         const impact = (0, analyze_impact_1.analyzeImpact)(absPath, graph);
         affectedNodes = [...impact.directDependents, ...impact.transitiveDependents];
     }
-    // Build context: changed file + top 5 connected files' content
+    // Build context: changed file + top 5 connected files' smart context
     const connectedFiles = [];
     const revDeps = graph.reverse.get(absPath) || [];
     const fwdDeps = graph.forward.get(absPath) || [];
@@ -98,19 +89,21 @@ async function analyzeChangeRealtime(change, graph, getFileContent) {
         const depRel = path.relative(graph.sourceDir, dep).replace(/\\/g, "/");
         const content = getFileContent(depRel);
         if (content) {
-            const truncated = content.split("\n").slice(0, 60).join("\n");
-            connectedFiles.push(`### ${depRel}\n\`\`\`${codeBlockLang}\n${truncated}\n\`\`\``);
+            const smartCtx = (0, context_extractor_1.buildSmartContext)(content, codeBlockLang);
+            connectedFiles.push(`### ${depRel}\n\`\`\`${codeBlockLang}\n${smartCtx}\n\`\`\``);
         }
     }
-    // Build diff summary
+    // Build diff summary with signature changes
     let diffSummary = "";
     if (change.type === "deleted") {
         diffSummary = `파일이 삭제됨. 이전 내용:\n\`\`\`${codeBlockLang}\n${(change.oldContent || "").split("\n").slice(0, 40).join("\n")}\n\`\`\``;
     }
     else if (change.type === "added") {
-        diffSummary = `새 파일 추가됨:\n\`\`\`${codeBlockLang}\n${(change.newContent || "").split("\n").slice(0, 60).join("\n")}\n\`\`\``;
+        const smartNew = (0, context_extractor_1.buildSmartContext)(change.newContent || "", codeBlockLang);
+        diffSummary = `새 파일 추가됨:\n\`\`\`${codeBlockLang}\n${smartNew}\n\`\`\``;
     }
     else {
+        // Modified — include signature diff
         const diffLines = change.diff.slice(0, 30).map(d => {
             if (d.type === "added")
                 return `+ L${d.line}: ${d.new}`;
@@ -119,8 +112,27 @@ async function analyzeChangeRealtime(change, graph, getFileContent) {
             return `~ L${d.line}: ${d.old} → ${d.new}`;
         });
         diffSummary = `변경된 라인 (${change.diff.length}개 중 상위 30개):\n\`\`\`\n${diffLines.join("\n")}\n\`\`\``;
+        // Add structural signature changes
+        if (change.oldContent && change.newContent) {
+            const sigChanges = (0, context_extractor_1.diffSignatures)(change.oldContent, change.newContent, codeBlockLang);
+            if (sigChanges.length > 0) {
+                diffSummary += "\n\n### 구조적 변경 (시그니처 비교)";
+                for (const sc of sigChanges) {
+                    if (sc.type === "added") {
+                        diffSummary += `\n+ 추가: ${sc.newSignature}`;
+                    }
+                    else if (sc.type === "removed") {
+                        diffSummary += `\n- 삭제: ${sc.oldSignature}`;
+                    }
+                    else {
+                        diffSummary += `\n~ 변경: ${sc.oldSignature}\n  →     ${sc.newSignature}`;
+                    }
+                }
+            }
+        }
         if (change.newContent) {
-            diffSummary += `\n\n전체 수정 후 파일:\n\`\`\`${codeBlockLang}\n${change.newContent.split("\n").slice(0, 80).join("\n")}\n\`\`\``;
+            const smartNew = (0, context_extractor_1.buildSmartContext)(change.newContent, codeBlockLang);
+            diffSummary += `\n\n전체 수정 후 파일:\n\`\`\`${codeBlockLang}\n${smartNew}\n\`\`\``;
         }
     }
     const userPrompt = `## 파일 변경 감지: ${relPath}
@@ -134,19 +146,11 @@ ${connectedFiles.length > 0 ? `## 연결된 파일들 (${connectedFiles.length}
 
 이 변경이 프로젝트에 미치는 영향을 분석하세요.`;
     try {
-        const ai = getGenAI();
-        const model = ai.getGenerativeModel({ model: "gemini-2.5-flash" });
-        const result = await model.generateContent({
-            contents: [{ role: "user", parts: [{ text: userPrompt }] }],
-            systemInstruction: { role: "model", parts: [{ text: REALTIME_SYSTEM_PROMPT }] },
-        });
-        const text = result.response.text();
-        let jsonStr = text;
-        const jsonMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
-        if (jsonMatch)
-            jsonStr = jsonMatch[1];
-        jsonStr = jsonStr.trim();
-        const parsed = JSON.parse(jsonStr);
+        const provider = (0, provider_1.getAIProvider)();
+        if (!provider) {
+            throw new Error("No AI provider available (set GEMINI_KEY, OPENAI_KEY, or ANTHROPIC_KEY)");
+        }
+        const parsed = await provider.analyzeJSON(REALTIME_SYSTEM_PROMPT, userPrompt);
         const analysisMs = Date.now() - start;
         return {
             file: relPath,

package/dist/index.js

@@ -51,6 +51,7 @@ const plugin_1 = require("./languages/plugin");
 const analyze_impact_1 = require("./tools/analyze-impact");
 const gate_build_1 = require("./tools/gate-build");
 const analyzer_1 = require("./ai/analyzer");
+const provider_1 = require("./ai/provider");
 const server_1 = require("./web/server");
 const file_cache_1 = require("./watcher/file-cache");
 const validator_1 = require("./license/validator");
@@ -110,7 +111,7 @@ async function main() {
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
-    const server = new index_js_1.Server({ name: "syke", version: "0.4.0" }, { capabilities: { tools: {} } });
+    const server = new index_js_1.Server({ name: "syke", version: "1.3.0" }, { capabilities: { tools: {} } });
     // List tools
     server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         tools: [
@@ -190,7 +191,7 @@ async function main() {
             },
             {
                 name: "ai_analyze",
-                description: "Use Gemini AI to perform semantic analysis on a file. Reads the file's source code and its dependents to explain what might break when modified and how to safely make changes. Returns Korean analysis.",
+                description: "Use AI (Gemini/OpenAI/Claude) to perform semantic analysis on a file. Reads the file's source code and its dependents to explain what might break when modified and how to safely make changes. Returns Korean analysis.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -460,8 +461,16 @@ async function main() {
         }
     });
     // Pre-warm the graph (skip if no project root — e.g. Smithery scan)
-    console.error(`[syke] Starting SYKE MCP Server v0.4.0`);
+    console.error(`[syke] Starting SYKE MCP Server v1.3.0`);
     console.error(`[syke] License: ${licenseStatus.plan.toUpperCase()} (${licenseStatus.source})`);
+    // Log AI provider status
+    const aiProvider = (0, provider_1.getAIProvider)();
+    if (aiProvider) {
+        console.error(`[syke] AI Provider: ${(0, provider_1.getProviderName)()}`);
+    }
+    else {
+        console.error(`[syke] AI: disabled (set GEMINI_KEY, OPENAI_KEY, or ANTHROPIC_KEY)`);
+    }
     if (licenseStatus.plan === "pro") {
         console.error(`[syke] Pro activated for: ${licenseStatus.email || "unknown"}`);
     }
@@ -544,7 +553,7 @@ main().catch((err) => {
  * See: https://smithery.ai/docs/deploy#sandbox-server
  */
 function createSandboxServer() {
-    const sandboxServer = new index_js_1.Server({ name: "syke", version: "0.4.0" }, { capabilities: { tools: {} } });
+    const sandboxServer = new index_js_1.Server({ name: "syke", version: "1.3.0" }, { capabilities: { tools: {} } });
     sandboxServer.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
         tools: [
             {
@@ -579,7 +588,7 @@ function createSandboxServer() {
             },
             {
                 name: "ai_analyze",
-                description: "Pro: Gemini AI semantic analysis of a file and its dependents.",
+                description: "Pro: AI semantic analysis (Gemini/OpenAI/Claude) of a file and its dependents.",
                 inputSchema: { type: "object", properties: { file: { type: "string", description: "File to analyze" } }, required: ["file"] },
             },
             {

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@syke1/mcp-server",
-  "version": "1.2.0",
+  "version": "1.3.0",
+  "mcpName": "io.github.khalomsky/syke",
   "description": "AI code impact analysis MCP server — dependency graphs, cascade detection, and a mandatory build gate for AI coding agents",
   "main": "dist/index.js",
   "bin": {

package/smithery.yaml

@@ -13,6 +13,18 @@ startCommand:
         type: string
         default: ""
         description: Google Gemini API key for AI semantic analysis (Pro only, optional)
+      openaiKey:
+        type: string
+        default: ""
+        description: OpenAI API key for AI semantic analysis (Pro only, alternative to Gemini)
+      anthropicKey:
+        type: string
+        default: ""
+        description: Anthropic API key for AI semantic analysis (Pro only, alternative to Gemini)
+      aiProvider:
+        type: string
+        default: ""
+        description: Force a specific AI provider (gemini, openai, or anthropic). Auto-selects if empty.
   commandFunction:
     |-
-    config => ({ command: 'npx', args: ['-y', '@syke1/mcp-server@latest'], env: { SYKE_LICENSE_KEY: config.licenseKey || '', GEMINI_KEY: config.geminiKey || '', SYKE_NO_BROWSER: '1' } })
+    config => ({ command: 'npx', args: ['-y', '@syke1/mcp-server@latest'], env: { SYKE_LICENSE_KEY: config.licenseKey || '', GEMINI_KEY: config.geminiKey || '', OPENAI_KEY: config.openaiKey || '', ANTHROPIC_KEY: config.anthropicKey || '', SYKE_AI_PROVIDER: config.aiProvider || '', SYKE_NO_BROWSER: '1' } })