@reverse-craft/ai-tools 1.0.0 → 1.0.1

package/README.md

@@ -1,12 +1,13 @@
 # @reverse-craft/ai-tools
 
-AI-powered code analysis tools for smart-fs. Provides LLM-driven functionality including JSVMP (JavaScript Virtual Machine Protection) dispatcher detection.
+MCP server for AI-powered JSVMP detection. Provides LLM-driven code analysis tools for identifying JavaScript Virtual Machine Protection patterns.
 
 ## Features
 
+- **MCP Server** - Model Context Protocol server for AI assistant integration
 - **JSVMP Detection** - Detect VM protection patterns using LLM analysis
-- **LLM Configuration** - Flexible OpenAI-compatible API configuration
-- **Code Formatting** - Format code for LLM analysis with source map coordinates
+- **Multiple Pattern Types** - Identifies dispatchers, instruction arrays, stack operations
+- **Confidence Levels** - Results include ultra_high, high, medium, low confidence ratings
 
 ## Installation
 
@@ -24,106 +25,115 @@ export OPENAI_API_KEY=your-api-key
 
 # Optional (defaults shown)
 export OPENAI_BASE_URL=https://api.openai.com/v1
-export OPENAI_MODEL=gpt-4
+export OPENAI_MODEL=gpt-4o-mini
 ```
 
-## Usage
+## MCP Server Usage
 
-### JSVMP Dispatcher Detection
+### Running the Server
 
-```typescript
-import { findJsvmpDispatcher } from '@reverse-craft/ai-tools';
+```bash
+# Via npx
+npx @reverse-craft/ai-tools
+
+# Or if installed globally
+ai-tools-mcp
+```
 
-const result = await findJsvmpDispatcher(
-  './obfuscated.js',
-  1,      // startLine
-  500,    // endLine
-  { charLimit: 300 }
-);
+### MCP Configuration
 
-if (result.success) {
-  console.log(result.formattedOutput);
-  // Detected regions with confidence levels
-  for (const region of result.result.regions) {
-    console.log(`[${region.confidence}] Lines ${region.start}-${region.end}: ${region.type}`);
+Add to your MCP client configuration (e.g., Claude Desktop, Kiro):
+
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "npx",
+      "args": ["@reverse-craft/ai-tools"],
+      "env": {
+        "OPENAI_API_KEY": "your-api-key"
+      }
+    }
   }
 }
 ```
 
-### LLM Configuration
-
-```typescript
-import { getLLMConfig, isLLMConfigured, createLLMClient } from '@reverse-craft/ai-tools';
-
-// Check if LLM is configured
-if (isLLMConfigured()) {
-  const config = getLLMConfig();
-  const client = createLLMClient(config);
+Or with a local installation:
+
+```json
+{
+  "mcpServers": {
+    "ai-tools": {
+      "command": "node",
+      "args": ["/path/to/ai-tools/dist/server.js"],
+      "env": {
+        "OPENAI_API_KEY": "your-api-key"
+      }
+    }
+  }
 }
 ```
 
-### Code Formatting for Analysis
+## MCP Tools
 
-```typescript
-import { formatCodeForAnalysis } from '@reverse-craft/ai-tools';
+### find_jsvmp_dispatcher
 
-const formatted = await formatCodeForAnalysis(
-  './app.min.js',
-  1,      // startLine
-  100,    // endLine
-  300     // charLimit
-);
+Detect JSVMP (JavaScript Virtual Machine Protection) patterns in code using LLM analysis.
 
-console.log(formatted.content);
-// Output: "LineNo SourceLoc Code" format
-```
+**Parameters:**
 
-## API
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| filePath | string | Yes | Path to the JavaScript file to analyze |
+| startLine | number | Yes | Start line number (1-based) |
+| endLine | number | Yes | End line number (1-based) |
+| charLimit | number | No | Character limit for string truncation (default: 300) |
 
-### Types
+**Detection Types:**
 
-```typescript
-// Detection types
-type DetectionType = 
-  | "If-Else Dispatcher" 
-  | "Switch Dispatcher" 
-  | "Instruction Array" 
-  | "Stack Operation";
+- **If-Else Dispatcher** - Nested if-else chains for instruction dispatch
+- **Switch Dispatcher** - Large switch statements (>20 cases) for opcode handling
+- **Instruction Array** - Arrays storing bytecode instructions
+- **Stack Operation** - Virtual stack push/pop patterns
 
-type ConfidenceLevel = "ultra_high" | "high" | "medium" | "low";
+**Confidence Levels:**
 
-interface DetectionRegion {
-  start: number;
-  end: number;
-  type: DetectionType;
-  confidence: ConfidenceLevel;
-  description: string;
-}
+- `ultra_high` - Multiple JSVMP features present (loop + dispatcher + stack)
+- `high` - Clear dispatcher structure (>20 cases or >10 nesting levels)
+- `medium` - Partial JSVMP features
+- `low` - Possible but uncertain patterns
 
-interface JsvmpDetectionResult {
-  success: boolean;
-  filePath: string;
-  startLine: number;
-  endLine: number;
-  result?: DetectionResult;
-  formattedOutput?: string;
-  error?: string;
-}
+**Example Response:**
+
+```
+=== JSVMP Dispatcher Detection Result ===
+File: ./obfuscated.js (1-500)
+
+Summary: 检测到典型的 JSVMP 保护结构，包含主分发器和栈操作
+
+Detected Regions:
+[ultra_high] Lines 45-280: Switch Dispatcher
+  大型 switch 语句包含 47 个 case，典型的 JSVMP 指令分发器
+
+[high] Lines 12-44: Stack Operation
+  虚拟栈初始化和操作，使用数组索引进行 push/pop
 ```
 
-### Functions
+## What is JSVMP?
+
+JSVMP (JavaScript Virtual Machine Protection) is a code protection technique that:
+
+1. Converts JavaScript source code to custom bytecode
+2. Implements a virtual machine to execute the bytecode
+3. Uses dispatchers (switch/if-else) to handle different opcodes
+4. Maintains a virtual stack for operand storage
 
-- `findJsvmpDispatcher(filePath, startLine, endLine, options?)` - Detect JSVMP patterns
-- `formatCodeForAnalysis(filePath, startLine, endLine, charLimit?)` - Format code for LLM
-- `parseDetectionResult(jsonString)` - Parse LLM response
-- `getLLMConfig()` - Get LLM configuration from environment
-- `isLLMConfigured()` - Check if LLM is configured
-- `createLLMClient(config)` - Create LLM client instance
+This makes reverse engineering significantly harder as the original logic is hidden behind VM interpretation.
 
 ## Related Packages
 
-- **[@reverse-craft/smart-fs](https://github.com/reverse-craft/smart-fs)** - Core library
-- **[@reverse-craft/smart-fs-mcp](https://github.com/reverse-craft/smart-fs-mcp)** - MCP server
+- **[@reverse-craft/smart-fs](https://github.com/reverse-craft/smart-fs)** - Core library for code processing
+- **[@reverse-craft/smart-fs-mcp](https://github.com/reverse-craft/smart-fs-mcp)** - MCP server for smart-fs
 
 ## License
 

package/dist/index.d.ts

@@ -1,11 +1,16 @@
 /**
- * AI Tools - AI-powered code analysis tools
+ * AI Tools - MCP server for AI-powered JSVMP detection
  *
- * This package provides LLM-driven functionality for code analysis,
+ * This package provides an MCP server with LLM-driven functionality for code analysis,
  * including JSVMP (JavaScript Virtual Machine Protection) detection.
  *
+ * Run as MCP server: npx @reverse-craft/ai-tools
+ *
  * @packageDocumentation
  */
 export { type LLMConfig, type LLMClient, getLLMConfig, isLLMConfigured, createLLMClient, } from './llmConfig.js';
 export { type FormattedCode, type DetectionType, type ConfidenceLevel, type DetectionRegion, type DetectionResult, type JsvmpDetectionOptions, type JsvmpDetectionResult, formatCodeForAnalysis, parseDetectionResult, findJsvmpDispatcher, } from './jsvmpDetector.js';
+export { tools } from './tools/index.js';
+export { findJsvmpDispatcherTool, FindJsvmpDispatcherInputSchema } from './tools/findJsvmpDispatcherTool.js';
+export { ToolDefinition, defineTool } from './tools/ToolDefinition.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,oCAAoC,CAAC;AAC7G,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z as z2 } from "zod";
+
+// src/tools/findJsvmpDispatcherTool.ts
+import { z } from "zod";
+
+// src/tools/ToolDefinition.ts
+function defineTool(definition) {
+  return definition;
+}
+
+// src/jsvmpDetector.ts
+import { SourceMapConsumer } from "source-map-js";
+import { ensureBeautified, truncateCodeHighPerf } from "@reverse-craft/smart-fs";
+import { existsSync } from "fs";
+
+// src/llmConfig.ts
+function getLLMConfig() {
+  const apiKey = process.env.OPENAI_API_KEY;
+  if (!apiKey) {
+    return null;
+  }
+  const baseUrl = process.env.OPENAI_BASE_URL || "https://api.openai.com/v1";
+  const model = process.env.OPENAI_MODEL || "gpt-4o-mini";
+  return {
+    apiKey,
+    baseUrl,
+    model
+  };
+}
+function buildJSVMPSystemPrompt() {
+  return `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 JavaScript \u9006\u5411\u5DE5\u7A0B\u4E13\u5BB6\uFF0C\u4E13\u95E8\u8BC6\u522B JSVMP\uFF08JavaScript Virtual Machine Protection\uFF09\u4FDD\u62A4\u4EE3\u7801\u3002
+
+JSVMP \u662F\u4E00\u79CD\u4EE3\u7801\u4FDD\u62A4\u6280\u672F\uFF0C\u5C06 JavaScript \u4EE3\u7801\u8F6C\u6362\u4E3A\u5B57\u8282\u7801\uFF0C\u5E76\u901A\u8FC7\u865A\u62DF\u673A\u6267\u884C\u3002\u5178\u578B\u7279\u5F81\u5305\u62EC\uFF1A
+
+1. **\u865A\u62DF\u6808\uFF08Virtual Stack\uFF09**\uFF1A\u4E2D\u592E\u6570\u7EC4\u7528\u4E8E\u5B58\u50A8\u64CD\u4F5C\u6570\u548C\u7ED3\u679C
+2. **\u5206\u53D1\u5668\uFF08Dispatcher\uFF09**\uFF1A\u5927\u578B switch \u8BED\u53E5\u6216\u5D4C\u5957 if-else \u94FE\uFF0C\u6839\u636E\u6307\u4EE4\u7801\u6267\u884C\u4E0D\u540C\u64CD\u4F5C
+3. **\u6307\u4EE4\u6570\u7EC4\uFF08Instruction Array\uFF09**\uFF1A\u5B58\u50A8\u5B57\u8282\u7801\u6307\u4EE4\u7684\u6570\u7EC4
+4. **\u4E3B\u5FAA\u73AF\uFF08Main Loop\uFF09**\uFF1Awhile \u5FAA\u73AF\u6301\u7EED\u6267\u884C\u6307\u4EE4
+
+\u68C0\u6D4B\u89C4\u5219\uFF1A
+
+**Ultra High \u7F6E\u4FE1\u5EA6**\uFF1A
+- \u540C\u65F6\u51FA\u73B0\uFF1A\u4E3B\u5FAA\u73AF + \u5206\u53D1\u5668 + \u6808\u64CD\u4F5C
+- \u5206\u53D1\u5668\u6709 >20 \u4E2A case \u6216 >10 \u5C42\u5D4C\u5957
+- \u660E\u786E\u7684\u6808\u64CD\u4F5C\u6A21\u5F0F\uFF08push/pop/\u6570\u7EC4\u7D22\u5F15\uFF09
+
+**High \u7F6E\u4FE1\u5EA6**\uFF1A
+- \u72EC\u7ACB\u7684\u5927\u578B\u5206\u53D1\u5668\u7ED3\u6784\uFF08>20 case \u7684 switch \u6216 >10 \u5C42\u5D4C\u5957\u7684 if-else\uFF09
+- \u660E\u786E\u7684\u6307\u4EE4\u6570\u7EC4\u548C\u7A0B\u5E8F\u8BA1\u6570\u5668\u6A21\u5F0F
+
+**Medium \u7F6E\u4FE1\u5EA6**\uFF1A
+- \u5B64\u7ACB\u7684\u6808\u64CD\u4F5C\u6216\u53EF\u7591\u7684 while \u5FAA\u73AF
+- \u90E8\u5206 JSVMP \u7279\u5F81\u4F46\u4E0D\u5B8C\u6574
+
+**Low \u7F6E\u4FE1\u5EA6**\uFF1A
+- \u901A\u7528\u6DF7\u6DC6\u6A21\u5F0F
+- \u53EF\u80FD\u76F8\u5173\u4F46\u4E0D\u786E\u5B9A\u7684\u7ED3\u6784
+
+\u8BF7\u5206\u6790\u63D0\u4F9B\u7684\u4EE3\u7801\uFF0C\u8BC6\u522B JSVMP \u76F8\u5173\u533A\u57DF\u3002\u8FD4\u56DE JSON \u683C\u5F0F\uFF1A
+
+{
+  "summary": "\u5206\u6790\u6458\u8981\uFF08\u4E2D\u6587\uFF09",
+  "regions": [
+    {
+      "start": \u8D77\u59CB\u884C\u53F7,
+      "end": \u7ED3\u675F\u884C\u53F7,
+      "type": "If-Else Dispatcher" | "Switch Dispatcher" | "Instruction Array" | "Stack Operation",
+      "confidence": "ultra_high" | "high" | "medium" | "low",
+      "description": "\u8BE6\u7EC6\u63CF\u8FF0\uFF08\u4E2D\u6587\uFF09"
+    }
+  ]
+}
+
+\u5982\u679C\u6CA1\u6709\u68C0\u6D4B\u5230 JSVMP \u7279\u5F81\uFF0C\u8FD4\u56DE\u7A7A\u7684 regions \u6570\u7EC4\u3002`;
+}
+function createLLMClient(config) {
+  return {
+    async analyzeJSVMP(formattedCode) {
+      const systemPrompt = buildJSVMPSystemPrompt();
+      const requestBody = {
+        model: config.model,
+        messages: [
+          {
+            role: "system",
+            content: systemPrompt
+          },
+          {
+            role: "user",
+            content: `\u8BF7\u5206\u6790\u4EE5\u4E0B\u4EE3\u7801\uFF0C\u8BC6\u522B JSVMP \u4FDD\u62A4\u7ED3\u6784\uFF1A
+
+${formattedCode}`
+          }
+        ],
+        temperature: 0.1,
+        response_format: { type: "json_object" }
+      };
+      try {
+        const response = await fetch(`${config.baseUrl}/chat/completions`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${config.apiKey}`
+          },
+          body: JSON.stringify(requestBody)
+        });
+        if (!response.ok) {
+          const errorText = await response.text();
+          throw new Error(`API \u8BF7\u6C42\u5931\u8D25 (${response.status}): ${errorText}`);
+        }
+        const data = await response.json();
+        if (!data.choices || !data.choices[0] || !data.choices[0].message) {
+          throw new Error("API \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF1A\u7F3A\u5C11 choices \u6216 message \u5B57\u6BB5");
+        }
+        const content = data.choices[0].message.content;
+        if (typeof content !== "string") {
+          throw new Error("API \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF1Amessage.content \u4E0D\u662F\u5B57\u7B26\u4E32");
+        }
+        return content;
+      } catch (error) {
+        if (error instanceof Error) {
+          throw new Error(`LLM \u8BF7\u6C42\u5931\u8D25: ${error.message}`);
+        }
+        throw new Error(`LLM \u8BF7\u6C42\u5931\u8D25: ${String(error)}`);
+      }
+    }
+  };
+}
+
+// src/jsvmpDetector.ts
+function formatSourcePosition(line, column) {
+  if (line !== null && column !== null) {
+    return `L${line}:${column}`;
+  }
+  return "";
+}
+function formatCodeLine(lineNumber, sourcePos, code) {
+  const lineNumStr = String(lineNumber).padStart(5, " ");
+  const srcPosPadded = sourcePos ? sourcePos.padEnd(10, " ") : "          ";
+  return `${lineNumStr} ${srcPosPadded} ${code}`;
+}
+async function formatCodeForAnalysis(filePath, startLine, endLine, charLimit = 300) {
+  const beautifyResult = await ensureBeautified(filePath);
+  const { code, rawMap } = beautifyResult;
+  const truncatedCode = truncateCodeHighPerf(code, charLimit);
+  const lines = truncatedCode.split("\n");
+  const totalLines = lines.length;
+  const effectiveStartLine = Math.max(1, Math.min(totalLines, startLine));
+  const effectiveEndLine = Math.max(effectiveStartLine, Math.min(totalLines, endLine));
+  const formattedLines = [];
+  let consumer = null;
+  if (rawMap && rawMap.sources && rawMap.names && rawMap.mappings) {
+    consumer = new SourceMapConsumer({
+      version: String(rawMap.version),
+      sources: rawMap.sources,
+      names: rawMap.names,
+      mappings: rawMap.mappings,
+      file: rawMap.file,
+      sourceRoot: rawMap.sourceRoot
+    });
+  }
+  for (let lineNum = effectiveStartLine; lineNum <= effectiveEndLine; lineNum++) {
+    const lineIndex = lineNum - 1;
+    const lineContent = lines[lineIndex] ?? "";
+    let sourcePos = "";
+    if (consumer) {
+      const originalPos = consumer.originalPositionFor({
+        line: lineNum,
+        column: 0
+      });
+      sourcePos = formatSourcePosition(originalPos.line, originalPos.column);
+    }
+    formattedLines.push(formatCodeLine(lineNum, sourcePos, lineContent));
+  }
+  return {
+    content: formattedLines.join("\n"),
+    totalLines,
+    startLine: effectiveStartLine,
+    endLine: effectiveEndLine
+  };
+}
+var VALID_DETECTION_TYPES = [
+  "If-Else Dispatcher",
+  "Switch Dispatcher",
+  "Instruction Array",
+  "Stack Operation"
+];
+var VALID_CONFIDENCE_LEVELS = [
+  "ultra_high",
+  "high",
+  "medium",
+  "low"
+];
+function isValidDetectionType(value) {
+  return VALID_DETECTION_TYPES.includes(value);
+}
+function isValidConfidenceLevel(value) {
+  return VALID_CONFIDENCE_LEVELS.includes(value);
+}
+function parseDetectionResult(jsonString) {
+  let parsed;
+  try {
+    parsed = JSON.parse(jsonString);
+  } catch (error) {
+    throw new Error(`\u65E0\u6CD5\u89E3\u6790 LLM \u54CD\u5E94: ${error instanceof Error ? error.message : String(error)}`);
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new Error("LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0C\u671F\u671B\u5BF9\u8C61\u7C7B\u578B");
+  }
+  const obj = parsed;
+  if (typeof obj.summary !== "string") {
+    throw new Error("LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0C\u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: summary");
+  }
+  if (!Array.isArray(obj.regions)) {
+    throw new Error("LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0C\u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: regions");
+  }
+  const validatedRegions = [];
+  for (let i = 0; i < obj.regions.length; i++) {
+    const region = obj.regions[i];
+    if (typeof region !== "object" || region === null) {
+      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u4E0D\u662F\u5BF9\u8C61`);
+    }
+    if (typeof region.start !== "number") {
+      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: start`);
+    }
+    if (typeof region.end !== "number") {
+      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: end`);
+    }
+    if (typeof region.type !== "string") {
+      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: type`);
+    }
+    if (typeof region.confidence !== "string") {
+      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: confidence`);
+    }
+    if (typeof region.description !== "string") {
+      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: description`);
+    }
+    if (!isValidDetectionType(region.type)) {
+      throw new Error(
+        `LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}].type \u503C\u65E0\u6548: "${region.type}". \u6709\u6548\u503C: ${VALID_DETECTION_TYPES.join(", ")}`
+      );
+    }
+    if (!isValidConfidenceLevel(region.confidence)) {
+      throw new Error(
+        `LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}].confidence \u503C\u65E0\u6548: "${region.confidence}". \u6709\u6548\u503C: ${VALID_CONFIDENCE_LEVELS.join(", ")}`
+      );
+    }
+    validatedRegions.push({
+      start: region.start,
+      end: region.end,
+      type: region.type,
+      confidence: region.confidence,
+      description: region.description
+    });
+  }
+  return {
+    summary: obj.summary,
+    regions: validatedRegions
+  };
+}
+function formatDetectionResultOutput(result, filePath, startLine, endLine) {
+  const lines = [];
+  lines.push("=== JSVMP Dispatcher Detection Result ===");
+  lines.push(`File: ${filePath} (${startLine}-${endLine})`);
+  lines.push("");
+  lines.push(`Summary: ${result.summary}`);
+  lines.push("");
+  if (result.regions.length > 0) {
+    lines.push("Detected Regions:");
+    for (const region of result.regions) {
+      lines.push(`[${region.confidence}] Lines ${region.start}-${region.end}: ${region.type}`);
+      lines.push(`  ${region.description}`);
+      lines.push("");
+    }
+  } else {
+    lines.push("No JSVMP dispatcher patterns detected.");
+  }
+  return lines.join("\n");
+}
+async function findJsvmpDispatcher(filePath, startLine, endLine, options) {
+  const charLimit = options?.charLimit ?? 300;
+  const config = getLLMConfig();
+  if (!config) {
+    return {
+      success: false,
+      filePath,
+      startLine,
+      endLine,
+      error: "\u672A\u914D\u7F6E LLM\u3002\u8BF7\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF OPENAI_API_KEY \u4EE5\u542F\u7528 JSVMP dispatcher \u68C0\u6D4B\u529F\u80FD\u3002"
+    };
+  }
+  if (!existsSync(filePath)) {
+    return {
+      success: false,
+      filePath,
+      startLine,
+      endLine,
+      error: `\u6587\u4EF6\u4E0D\u5B58\u5728: ${filePath}`
+    };
+  }
+  try {
+    const formattedCode = await formatCodeForAnalysis(
+      filePath,
+      startLine,
+      endLine,
+      charLimit
+    );
+    const client = createLLMClient(config);
+    const llmResponse = await client.analyzeJSVMP(formattedCode.content);
+    const result = parseDetectionResult(llmResponse);
+    const formattedOutput = formatDetectionResultOutput(result, filePath, startLine, endLine);
+    return {
+      success: true,
+      filePath,
+      startLine: formattedCode.startLine,
+      endLine: formattedCode.endLine,
+      result,
+      formattedOutput
+    };
+  } catch (error) {
+    return {
+      success: false,
+      filePath,
+      startLine,
+      endLine,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+
+// src/tools/findJsvmpDispatcherTool.ts
+var FindJsvmpDispatcherInputSchema = {
+  filePath: z.string().describe("Path to the JavaScript file to analyze"),
+  startLine: z.number().int().positive().describe("Start line number (1-based)"),
+  endLine: z.number().int().positive().describe("End line number (1-based)"),
+  charLimit: z.number().int().positive().optional().describe("Character limit for string truncation (default: 300)")
+};
+var findJsvmpDispatcherTool = defineTool({
+  name: "find_jsvmp_dispatcher",
+  description: `Detect JSVMP (JavaScript Virtual Machine Protection) patterns in code using LLM analysis.
+
+JSVMP is a code protection technique that converts JavaScript to bytecode executed by a virtual machine. This tool identifies:
+- If-Else Dispatchers: Nested if-else chains for instruction dispatch
+- Switch Dispatchers: Large switch statements (>20 cases) for opcode handling
+- Instruction Arrays: Arrays storing bytecode instructions
+- Stack Operations: Virtual stack push/pop patterns
+
+Returns detection results with confidence levels (ultra_high, high, medium, low) and detailed descriptions.
+
+Requires OPENAI_API_KEY environment variable. Optional: OPENAI_BASE_URL, OPENAI_MODEL.`,
+  schema: FindJsvmpDispatcherInputSchema,
+  handler: async (params) => {
+    const { filePath, startLine, endLine, charLimit } = params;
+    if (endLine < startLine) {
+      throw new Error("endLine must be >= startLine");
+    }
+    const result = await findJsvmpDispatcher(filePath, startLine, endLine, {
+      charLimit: charLimit ?? 300
+    });
+    if (!result.success) {
+      throw new Error(result.error ?? "Detection failed");
+    }
+    return result.formattedOutput ?? "No output generated";
+  }
+});
+
+// src/tools/index.ts
+var tools = [
+  findJsvmpDispatcherTool
+];
+
+// src/server.ts
+var server = new McpServer({
+  name: "ai-tools-mcp",
+  version: "1.0.0"
+});
+function registerTool(tool) {
+  const zodSchema = z2.object(tool.schema);
+  server.registerTool(
+    tool.name,
+    {
+      description: tool.description,
+      inputSchema: tool.schema
+    },
+    async (params, _extra) => {
+      try {
+        const validatedParams = zodSchema.parse(params);
+        const result = await tool.handler(validatedParams);
+        return {
+          content: [{ type: "text", text: result }]
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `Error: ${message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+for (const tool of tools) {
+  registerTool(tool);
+}
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("AI Tools MCP Server running on stdio");
+}
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/server.ts", "../src/tools/findJsvmpDispatcherTool.ts", "../src/tools/ToolDefinition.ts", "../src/jsvmpDetector.ts", "../src/llmConfig.ts", "../src/tools/index.ts"],
+  "sourcesContent": ["import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport { tools } from './tools/index.js';\n\n// Create MCP Server instance\nconst server = new McpServer({\n  name: 'ai-tools-mcp',\n  version: '1.0.0',\n});\n\n/**\n * Register a tool with the MCP server.\n */\nfunction registerTool(tool: {\n  name: string;\n  description: string;\n  schema: z.ZodRawShape;\n  handler: (params: Record<string, unknown>) => Promise<string>;\n}): void {\n  const zodSchema = z.object(tool.schema);\n\n  server.registerTool(\n    tool.name,\n    {\n      description: tool.description,\n      inputSchema: tool.schema,\n    },\n    async (params, _extra) => {\n      try {\n        const validatedParams = zodSchema.parse(params);\n        const result = await tool.handler(validatedParams as Record<string, unknown>);\n\n        return {\n          content: [{ type: 'text' as const, text: result }],\n        };\n      } catch (error) {\n        const message = error instanceof Error ? error.message : String(error);\n        return {\n          content: [{ type: 'text' as const, text: `Error: ${message}` }],\n          isError: true,\n        };\n      }\n    }\n  );\n}\n\n// Register all tools\nfor (const tool of tools) {\n  registerTool(tool as unknown as {\n    name: string;\n    description: string;\n    schema: z.ZodRawShape;\n    handler: (params: Record<string, unknown>) => Promise<string>;\n  });\n}\n\n// Main entry point\nasync function main() {\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  console.error('AI Tools MCP Server running on stdio');\n}\n\nmain().catch((error) => {\n  console.error('Fatal error:', error);\n  process.exit(1);\n});\n", "import { z } from 'zod';\nimport { defineTool } from './ToolDefinition.js';\nimport { findJsvmpDispatcher } from '../jsvmpDetector.js';\n\n/**\n * Input schema for find_jsvmp_dispatcher tool\n */\nexport const FindJsvmpDispatcherInputSchema = {\n  filePath: z.string().describe('Path to the JavaScript file to analyze'),\n  startLine: z.number().int().positive().describe('Start line number (1-based)'),\n  endLine: z.number().int().positive().describe('End line number (1-based)'),\n  charLimit: z.number().int().positive().optional().describe('Character limit for string truncation (default: 300)'),\n};\n\n/**\n * MCP Tool: find_jsvmp_dispatcher\n * \n * Uses LLM to detect JSVMP (JavaScript Virtual Machine Protection) patterns in code.\n * \n * JSVMP is a code protection technique that converts JavaScript to bytecode\n * executed by a virtual machine. This tool identifies:\n * - If-Else Dispatchers\n * - Switch Dispatchers  \n * - Instruction Arrays\n * - Stack Operations\n * \n * Requires OPENAI_API_KEY environment variable to be set.\n */\nexport const findJsvmpDispatcherTool = defineTool({\n  name: 'find_jsvmp_dispatcher',\n  description: `Detect JSVMP (JavaScript Virtual Machine Protection) patterns in code using LLM analysis.\n\nJSVMP is a code protection technique that converts JavaScript to bytecode executed by a virtual machine. This tool identifies:\n- If-Else Dispatchers: Nested if-else chains for instruction dispatch\n- Switch Dispatchers: Large switch statements (>20 cases) for opcode handling\n- Instruction Arrays: Arrays storing bytecode instructions\n- Stack Operations: Virtual stack push/pop patterns\n\nReturns detection results with confidence levels (ultra_high, high, medium, low) and detailed descriptions.\n\nRequires OPENAI_API_KEY environment variable. Optional: OPENAI_BASE_URL, OPENAI_MODEL.`,\n  schema: FindJsvmpDispatcherInputSchema,\n  handler: async (params): Promise<string> => {\n    const { filePath, startLine, endLine, charLimit } = params;\n\n    // Validate endLine >= startLine\n    if (endLine < startLine) {\n      throw new Error('endLine must be >= startLine');\n    }\n\n    const result = await findJsvmpDispatcher(filePath, startLine, endLine, {\n      charLimit: charLimit ?? 300,\n    });\n\n    if (!result.success) {\n      throw new Error(result.error ?? 'Detection failed');\n    }\n\n    return result.formattedOutput ?? 'No output generated';\n  },\n});\n", "import { z } from 'zod';\n\n/**\n * Tool definition interface for MCP tools.\n * Each tool has a name, description, schema (Zod raw shape), and async handler.\n */\nexport interface ToolDefinition<TSchema extends z.ZodRawShape = z.ZodRawShape> {\n  /** Unique tool name (e.g., 'find_jsvmp_dispatcher') */\n  name: string;\n  /** Human-readable description of what the tool does */\n  description: string;\n  /** Zod schema object defining input parameters */\n  schema: TSchema;\n  /** Async handler function that processes the tool request */\n  handler: (params: z.infer<z.ZodObject<TSchema>>) => Promise<string>;\n}\n\n/**\n * Helper function to create a type-safe tool definition.\n * Validates the tool definition structure at compile time.\n * \n * @param definition - The tool definition object\n * @returns The same definition with proper typing\n */\nexport function defineTool<TSchema extends z.ZodRawShape>(\n  definition: ToolDefinition<TSchema>\n): ToolDefinition<TSchema> {\n  return definition;\n}\n", "/**\n * JSVMP Detector Module\n * AI-powered detection of JSVMP (JavaScript Virtual Machine Protection) patterns\n */\n\nimport { SourceMapConsumer } from 'source-map-js';\nimport { ensureBeautified, truncateCodeHighPerf } from '@reverse-craft/smart-fs';\nimport { existsSync } from 'fs';\nimport { getLLMConfig, createLLMClient } from './llmConfig.js';\n\n/**\n * Formatted code result interface\n */\nexport interface FormattedCode {\n  content: string;      // \u683C\u5F0F\u5316\u540E\u7684\u4EE3\u7801\u5B57\u7B26\u4E32\n  totalLines: number;   // \u603B\u884C\u6570\n  startLine: number;    // \u5B9E\u9645\u8D77\u59CB\u884C\n  endLine: number;      // \u5B9E\u9645\u7ED3\u675F\u884C\n}\n\n/**\n * Detection type for JSVMP patterns\n */\nexport type DetectionType = \n  | \"If-Else Dispatcher\" \n  | \"Switch Dispatcher\" \n  | \"Instruction Array\" \n  | \"Stack Operation\";\n\n/**\n * Confidence level for detection results\n */\nexport type ConfidenceLevel = \"ultra_high\" | \"high\" | \"medium\" | \"low\";\n\n/**\n * A detected region in the code\n */\nexport interface DetectionRegion {\n  start: number;           // \u8D77\u59CB\u884C\u53F7\n  end: number;             // \u7ED3\u675F\u884C\u53F7\n  type: DetectionType;     // \u68C0\u6D4B\u7C7B\u578B\n  confidence: ConfidenceLevel;  // \u7F6E\u4FE1\u5EA6\n  description: string;     // \u63CF\u8FF0\uFF08\u4E2D\u6587\uFF09\n}\n\n/**\n * Complete detection result from LLM analysis\n */\nexport interface DetectionResult {\n  summary: string;         // \u5206\u6790\u6458\u8981\uFF08\u4E2D\u6587\uFF09\n  regions: DetectionRegion[];\n}\n\n/**\n * Options for JSVMP detection\n */\nexport interface JsvmpDetectionOptions {\n  charLimit?: number;\n}\n\n/**\n * Result from findJsvmpDispatcher function\n */\nexport interface JsvmpDetectionResult {\n  success: boolean;\n  filePath: string;\n  startLine: number;\n  endLine: number;\n  result?: DetectionResult;\n  formattedOutput?: string;\n  error?: string;\n}\n\n/**\n * Format source position as \"L{line}:{column}\" or empty placeholder\n */\nfunction formatSourcePosition(line: number | null, column: number | null): string {\n  if (line !== null && column !== null) {\n    return `L${line}:${column}`;\n  }\n  return '';\n}\n\n/**\n * Format a single code line with line number, source coordinates, and content\n * Format: \"LineNo SourceLoc Code\"\n */\nfunction formatCodeLine(lineNumber: number, sourcePos: string, code: string): string {\n  const lineNumStr = String(lineNumber).padStart(5, ' ');\n  const srcPosPadded = sourcePos ? sourcePos.padEnd(10, ' ') : '          ';\n  return `${lineNumStr} ${srcPosPadded} ${code}`;\n}\n\n/**\n * \u683C\u5F0F\u5316\u4EE3\u7801\u4E3A LLM \u5206\u6790\u683C\u5F0F\n * \u683C\u5F0F: \"LineNo SourceLoc Code\"\n * \n * \u5904\u7406\u6D41\u7A0B\uFF1A\n * 1. \u8C03\u7528 ensureBeautified \u7F8E\u5316\u4EE3\u7801\n * 2. \u8C03\u7528 truncateCodeHighPerf \u622A\u65AD\u957F\u5B57\u7B26\u4E32\n * 3. \u4F7F\u7528 SourceMapConsumer \u83B7\u53D6\u539F\u59CB\u5750\u6807\n * 4. \u683C\u5F0F\u5316\u4E3A \"LineNo SourceLoc Code\" \u683C\u5F0F\n * \n * @param filePath - Path to the JavaScript file\n * @param startLine - Start line number (1-based)\n * @param endLine - End line number (1-based)\n * @param charLimit - Character limit for string truncation (default 300)\n * @returns FormattedCode object with formatted content and metadata\n */\nexport async function formatCodeForAnalysis(\n  filePath: string,\n  startLine: number,\n  endLine: number,\n  charLimit: number = 300\n): Promise<FormattedCode> {\n  // Step 1: Beautify the file and get source map\n  const beautifyResult = await ensureBeautified(filePath);\n  const { code, rawMap } = beautifyResult;\n\n  // Step 2: Truncate long strings\n  const truncatedCode = truncateCodeHighPerf(code, charLimit);\n\n  // Split into lines\n  const lines = truncatedCode.split('\\n');\n  const totalLines = lines.length;\n\n  // Step 3: Adjust line range boundaries\n  const effectiveStartLine = Math.max(1, Math.min(totalLines, startLine));\n  const effectiveEndLine = Math.max(effectiveStartLine, Math.min(totalLines, endLine));\n\n  // Step 4: Format each line with \"LineNo SourceLoc Code\" format\n  const formattedLines: string[] = [];\n\n  // Create source map consumer if available\n  let consumer: SourceMapConsumer | null = null;\n  if (rawMap && rawMap.sources && rawMap.names && rawMap.mappings) {\n    consumer = new SourceMapConsumer({\n      version: String(rawMap.version),\n      sources: rawMap.sources,\n      names: rawMap.names,\n      mappings: rawMap.mappings,\n      file: rawMap.file,\n      sourceRoot: rawMap.sourceRoot,\n    });\n  }\n\n  for (let lineNum = effectiveStartLine; lineNum <= effectiveEndLine; lineNum++) {\n    const lineIndex = lineNum - 1;\n    const lineContent = lines[lineIndex] ?? '';\n\n    // Get original position from source map if available\n    let sourcePos = '';\n    if (consumer) {\n      const originalPos = consumer.originalPositionFor({\n        line: lineNum,\n        column: 0,\n      });\n      sourcePos = formatSourcePosition(originalPos.line, originalPos.column);\n    }\n    \n    formattedLines.push(formatCodeLine(lineNum, sourcePos, lineContent));\n  }\n\n  return {\n    content: formattedLines.join('\\n'),\n    totalLines,\n    startLine: effectiveStartLine,\n    endLine: effectiveEndLine,\n  };\n}\n\n/**\n * Valid detection types for validation\n */\nconst VALID_DETECTION_TYPES: DetectionType[] = [\n  \"If-Else Dispatcher\",\n  \"Switch Dispatcher\",\n  \"Instruction Array\",\n  \"Stack Operation\"\n];\n\n/**\n * Valid confidence levels for validation\n */\nconst VALID_CONFIDENCE_LEVELS: ConfidenceLevel[] = [\n  \"ultra_high\",\n  \"high\",\n  \"medium\",\n  \"low\"\n];\n\n/**\n * Check if a value is a valid DetectionType\n */\nfunction isValidDetectionType(value: unknown): value is DetectionType {\n  return VALID_DETECTION_TYPES.includes(value as DetectionType);\n}\n\n/**\n * Check if a value is a valid ConfidenceLevel\n */\nfunction isValidConfidenceLevel(value: unknown): value is ConfidenceLevel {\n  return VALID_CONFIDENCE_LEVELS.includes(value as ConfidenceLevel);\n}\n\n/**\n * Parse and validate LLM detection result from JSON string\n * \n * Validates:\n * - JSON is parseable\n * - Required fields exist: summary, regions\n * - Each region has required fields: start, end, type, confidence, description\n * - Enum values are valid\n * \n * @param jsonString - JSON string from LLM response\n * @returns Parsed and validated DetectionResult\n * @throws Error if JSON is invalid or structure doesn't match expected format\n */\nexport function parseDetectionResult(jsonString: string): DetectionResult {\n  // Parse JSON\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(jsonString);\n  } catch (error) {\n    throw new Error(`\u65E0\u6CD5\u89E3\u6790 LLM \u54CD\u5E94: ${error instanceof Error ? error.message : String(error)}`);\n  }\n\n  // Validate required top-level fields\n  if (typeof parsed !== 'object' || parsed === null) {\n    throw new Error('LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0C\u671F\u671B\u5BF9\u8C61\u7C7B\u578B');\n  }\n\n  const obj = parsed as Record<string, unknown>;\n\n  if (typeof obj.summary !== 'string') {\n    throw new Error('LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0C\u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: summary');\n  }\n\n  if (!Array.isArray(obj.regions)) {\n    throw new Error('LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0C\u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: regions');\n  }\n\n  // Validate each region\n  const validatedRegions: DetectionRegion[] = [];\n\n  for (let i = 0; i < obj.regions.length; i++) {\n    const region = obj.regions[i] as Record<string, unknown>;\n\n    // Check region is an object\n    if (typeof region !== 'object' || region === null) {\n      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u4E0D\u662F\u5BF9\u8C61`);\n    }\n\n    // Validate required fields exist and have correct types\n    if (typeof region.start !== 'number') {\n      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: start`);\n    }\n\n    if (typeof region.end !== 'number') {\n      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: end`);\n    }\n\n    if (typeof region.type !== 'string') {\n      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: type`);\n    }\n\n    if (typeof region.confidence !== 'string') {\n      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: confidence`);\n    }\n\n    if (typeof region.description !== 'string') {\n      throw new Error(`LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}] \u7F3A\u5C11\u5FC5\u9700\u5B57\u6BB5: description`);\n    }\n\n    // Validate enum values\n    if (!isValidDetectionType(region.type)) {\n      throw new Error(\n        `LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}].type \u503C\u65E0\u6548: \"${region.type}\". ` +\n        `\u6709\u6548\u503C: ${VALID_DETECTION_TYPES.join(', ')}`\n      );\n    }\n\n    if (!isValidConfidenceLevel(region.confidence)) {\n      throw new Error(\n        `LLM \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF0Cregions[${i}].confidence \u503C\u65E0\u6548: \"${region.confidence}\". ` +\n        `\u6709\u6548\u503C: ${VALID_CONFIDENCE_LEVELS.join(', ')}`\n      );\n    }\n\n    validatedRegions.push({\n      start: region.start,\n      end: region.end,\n      type: region.type,\n      confidence: region.confidence,\n      description: region.description,\n    });\n  }\n\n  return {\n    summary: obj.summary,\n    regions: validatedRegions,\n  };\n}\n\n/**\n * Format detection result for display\n */\nfunction formatDetectionResultOutput(\n  result: DetectionResult,\n  filePath: string,\n  startLine: number,\n  endLine: number\n): string {\n  const lines: string[] = [];\n  \n  lines.push('=== JSVMP Dispatcher Detection Result ===');\n  lines.push(`File: ${filePath} (${startLine}-${endLine})`);\n  lines.push('');\n  lines.push(`Summary: ${result.summary}`);\n  lines.push('');\n  \n  if (result.regions.length > 0) {\n    lines.push('Detected Regions:');\n    for (const region of result.regions) {\n      lines.push(`[${region.confidence}] Lines ${region.start}-${region.end}: ${region.type}`);\n      lines.push(`  ${region.description}`);\n      lines.push('');\n    }\n  } else {\n    lines.push('No JSVMP dispatcher patterns detected.');\n  }\n  \n  return lines.join('\\n');\n}\n\n/**\n * Find JSVMP dispatcher patterns in JavaScript code using LLM analysis\n * \n * @param filePath - Path to the JavaScript file to analyze\n * @param startLine - Start line number (1-based)\n * @param endLine - End line number (1-based)\n * @param options - Optional configuration\n * @returns JsvmpDetectionResult with detection results or error\n */\nexport async function findJsvmpDispatcher(\n  filePath: string,\n  startLine: number,\n  endLine: number,\n  options?: JsvmpDetectionOptions\n): Promise<JsvmpDetectionResult> {\n  const charLimit = options?.charLimit ?? 300;\n  \n  // Check LLM configuration\n  const config = getLLMConfig();\n  if (!config) {\n    return {\n      success: false,\n      filePath,\n      startLine,\n      endLine,\n      error: '\u672A\u914D\u7F6E LLM\u3002\u8BF7\u8BBE\u7F6E\u73AF\u5883\u53D8\u91CF OPENAI_API_KEY \u4EE5\u542F\u7528 JSVMP dispatcher \u68C0\u6D4B\u529F\u80FD\u3002'\n    };\n  }\n  \n  // Check file exists\n  if (!existsSync(filePath)) {\n    return {\n      success: false,\n      filePath,\n      startLine,\n      endLine,\n      error: `\u6587\u4EF6\u4E0D\u5B58\u5728: ${filePath}`\n    };\n  }\n  \n  try {\n    // Format code for analysis\n    const formattedCode = await formatCodeForAnalysis(\n      filePath,\n      startLine,\n      endLine,\n      charLimit\n    );\n    \n    // Create LLM client and analyze\n    const client = createLLMClient(config);\n    const llmResponse = await client.analyzeJSVMP(formattedCode.content);\n    \n    // Parse detection result\n    const result = parseDetectionResult(llmResponse);\n    \n    // Format output\n    const formattedOutput = formatDetectionResultOutput(result, filePath, startLine, endLine);\n    \n    return {\n      success: true,\n      filePath,\n      startLine: formattedCode.startLine,\n      endLine: formattedCode.endLine,\n      result,\n      formattedOutput\n    };\n    \n  } catch (error) {\n    return {\n      success: false,\n      filePath,\n      startLine,\n      endLine,\n      error: error instanceof Error ? error.message : String(error)\n    };\n  }\n}\n", "/**\n * LLM Configuration Module\n * Handles reading and validating LLM configuration from environment variables\n */\n\nexport interface LLMConfig {\n  apiKey: string;\n  baseUrl: string;\n  model: string;\n}\n\n/**\n * \u4ECE\u73AF\u5883\u53D8\u91CF\u8BFB\u53D6 LLM \u914D\u7F6E\n * @returns LLMConfig | null (null \u8868\u793A\u672A\u914D\u7F6E)\n */\nexport function getLLMConfig(): LLMConfig | null {\n  const apiKey = process.env.OPENAI_API_KEY;\n  \n  // API Key is required\n  if (!apiKey) {\n    return null;\n  }\n  \n  // Use defaults for optional configuration\n  const baseUrl = process.env.OPENAI_BASE_URL || \"https://api.openai.com/v1\";\n  const model = process.env.OPENAI_MODEL || \"gpt-4o-mini\";\n  \n  return {\n    apiKey,\n    baseUrl,\n    model\n  };\n}\n\n/**\n * \u68C0\u67E5 LLM \u662F\u5426\u5DF2\u914D\u7F6E\n */\nexport function isLLMConfigured(): boolean {\n  return getLLMConfig() !== null;\n}\n\n/**\n * LLM Client Interface\n */\nexport interface LLMClient {\n  /**\n   * \u53D1\u9001 JSVMP \u68C0\u6D4B\u8BF7\u6C42\u5230 LLM\n   * @param formattedCode \u683C\u5F0F\u5316\u540E\u7684\u4EE3\u7801\n   * @returns LLM \u8FD4\u56DE\u7684\u539F\u59CB JSON \u5B57\u7B26\u4E32\n   */\n  analyzeJSVMP(formattedCode: string): Promise<string>;\n}\n\n/**\n * \u6784\u5EFA JSVMP \u68C0\u6D4B\u7CFB\u7EDF\u63D0\u793A\u8BCD\n */\nfunction buildJSVMPSystemPrompt(): string {\n  return `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 JavaScript \u9006\u5411\u5DE5\u7A0B\u4E13\u5BB6\uFF0C\u4E13\u95E8\u8BC6\u522B JSVMP\uFF08JavaScript Virtual Machine Protection\uFF09\u4FDD\u62A4\u4EE3\u7801\u3002\n\nJSVMP \u662F\u4E00\u79CD\u4EE3\u7801\u4FDD\u62A4\u6280\u672F\uFF0C\u5C06 JavaScript \u4EE3\u7801\u8F6C\u6362\u4E3A\u5B57\u8282\u7801\uFF0C\u5E76\u901A\u8FC7\u865A\u62DF\u673A\u6267\u884C\u3002\u5178\u578B\u7279\u5F81\u5305\u62EC\uFF1A\n\n1. **\u865A\u62DF\u6808\uFF08Virtual Stack\uFF09**\uFF1A\u4E2D\u592E\u6570\u7EC4\u7528\u4E8E\u5B58\u50A8\u64CD\u4F5C\u6570\u548C\u7ED3\u679C\n2. **\u5206\u53D1\u5668\uFF08Dispatcher\uFF09**\uFF1A\u5927\u578B switch \u8BED\u53E5\u6216\u5D4C\u5957 if-else \u94FE\uFF0C\u6839\u636E\u6307\u4EE4\u7801\u6267\u884C\u4E0D\u540C\u64CD\u4F5C\n3. **\u6307\u4EE4\u6570\u7EC4\uFF08Instruction Array\uFF09**\uFF1A\u5B58\u50A8\u5B57\u8282\u7801\u6307\u4EE4\u7684\u6570\u7EC4\n4. **\u4E3B\u5FAA\u73AF\uFF08Main Loop\uFF09**\uFF1Awhile \u5FAA\u73AF\u6301\u7EED\u6267\u884C\u6307\u4EE4\n\n\u68C0\u6D4B\u89C4\u5219\uFF1A\n\n**Ultra High \u7F6E\u4FE1\u5EA6**\uFF1A\n- \u540C\u65F6\u51FA\u73B0\uFF1A\u4E3B\u5FAA\u73AF + \u5206\u53D1\u5668 + \u6808\u64CD\u4F5C\n- \u5206\u53D1\u5668\u6709 >20 \u4E2A case \u6216 >10 \u5C42\u5D4C\u5957\n- \u660E\u786E\u7684\u6808\u64CD\u4F5C\u6A21\u5F0F\uFF08push/pop/\u6570\u7EC4\u7D22\u5F15\uFF09\n\n**High \u7F6E\u4FE1\u5EA6**\uFF1A\n- \u72EC\u7ACB\u7684\u5927\u578B\u5206\u53D1\u5668\u7ED3\u6784\uFF08>20 case \u7684 switch \u6216 >10 \u5C42\u5D4C\u5957\u7684 if-else\uFF09\n- \u660E\u786E\u7684\u6307\u4EE4\u6570\u7EC4\u548C\u7A0B\u5E8F\u8BA1\u6570\u5668\u6A21\u5F0F\n\n**Medium \u7F6E\u4FE1\u5EA6**\uFF1A\n- \u5B64\u7ACB\u7684\u6808\u64CD\u4F5C\u6216\u53EF\u7591\u7684 while \u5FAA\u73AF\n- \u90E8\u5206 JSVMP \u7279\u5F81\u4F46\u4E0D\u5B8C\u6574\n\n**Low \u7F6E\u4FE1\u5EA6**\uFF1A\n- \u901A\u7528\u6DF7\u6DC6\u6A21\u5F0F\n- \u53EF\u80FD\u76F8\u5173\u4F46\u4E0D\u786E\u5B9A\u7684\u7ED3\u6784\n\n\u8BF7\u5206\u6790\u63D0\u4F9B\u7684\u4EE3\u7801\uFF0C\u8BC6\u522B JSVMP \u76F8\u5173\u533A\u57DF\u3002\u8FD4\u56DE JSON \u683C\u5F0F\uFF1A\n\n{\n  \"summary\": \"\u5206\u6790\u6458\u8981\uFF08\u4E2D\u6587\uFF09\",\n  \"regions\": [\n    {\n      \"start\": \u8D77\u59CB\u884C\u53F7,\n      \"end\": \u7ED3\u675F\u884C\u53F7,\n      \"type\": \"If-Else Dispatcher\" | \"Switch Dispatcher\" | \"Instruction Array\" | \"Stack Operation\",\n      \"confidence\": \"ultra_high\" | \"high\" | \"medium\" | \"low\",\n      \"description\": \"\u8BE6\u7EC6\u63CF\u8FF0\uFF08\u4E2D\u6587\uFF09\"\n    }\n  ]\n}\n\n\u5982\u679C\u6CA1\u6709\u68C0\u6D4B\u5230 JSVMP \u7279\u5F81\uFF0C\u8FD4\u56DE\u7A7A\u7684 regions \u6570\u7EC4\u3002`;\n}\n\n/**\n * \u521B\u5EFA LLM \u5BA2\u6237\u7AEF\u5B9E\u4F8B\n */\nexport function createLLMClient(config: LLMConfig): LLMClient {\n  return {\n    async analyzeJSVMP(formattedCode: string): Promise<string> {\n      const systemPrompt = buildJSVMPSystemPrompt();\n      \n      const requestBody = {\n        model: config.model,\n        messages: [\n          {\n            role: \"system\",\n            content: systemPrompt\n          },\n          {\n            role: \"user\",\n            content: `\u8BF7\u5206\u6790\u4EE5\u4E0B\u4EE3\u7801\uFF0C\u8BC6\u522B JSVMP \u4FDD\u62A4\u7ED3\u6784\uFF1A\\n\\n${formattedCode}`\n          }\n        ],\n        temperature: 0.1,\n        response_format: { type: \"json_object\" }\n      };\n      \n      try {\n        const response = await fetch(`${config.baseUrl}/chat/completions`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            \"Authorization\": `Bearer ${config.apiKey}`\n          },\n          body: JSON.stringify(requestBody)\n        });\n        \n        if (!response.ok) {\n          const errorText = await response.text();\n          throw new Error(`API \u8BF7\u6C42\u5931\u8D25 (${response.status}): ${errorText}`);\n        }\n        \n        const data = await response.json();\n        \n        if (!data.choices || !data.choices[0] || !data.choices[0].message) {\n          throw new Error(\"API \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF1A\u7F3A\u5C11 choices \u6216 message \u5B57\u6BB5\");\n        }\n        \n        const content = data.choices[0].message.content;\n        \n        if (typeof content !== \"string\") {\n          throw new Error(\"API \u54CD\u5E94\u683C\u5F0F\u65E0\u6548\uFF1Amessage.content \u4E0D\u662F\u5B57\u7B26\u4E32\");\n        }\n        \n        return content;\n      } catch (error) {\n        if (error instanceof Error) {\n          throw new Error(`LLM \u8BF7\u6C42\u5931\u8D25: ${error.message}`);\n        }\n        throw new Error(`LLM \u8BF7\u6C42\u5931\u8D25: ${String(error)}`);\n      }\n    }\n  };\n}\n", "/**\n * Tool aggregation module\n * Collects all tool definitions and exports them as a unified array.\n */\n\nimport { findJsvmpDispatcherTool, FindJsvmpDispatcherInputSchema } from './findJsvmpDispatcherTool.js';\n\n/**\n * Array of all available MCP tool definitions.\n * To add a new tool:\n * 1. Create a new tool module in src/tools/\n * 2. Import it here\n * 3. Add it to this array\n */\nexport const tools = [\n  findJsvmpDispatcherTool,\n] as const;\n\n// Re-export ToolDefinition interface and defineTool helper\nexport { ToolDefinition, defineTool } from './ToolDefinition.js';\n\n// Re-export tool and input schema\nexport { findJsvmpDispatcherTool, FindJsvmpDispatcherInputSchema };\n"],
+  "mappings": "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",
+  "names": ["z", "z"]
+}

package/dist/tools/ToolDefinition.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * Tool definition interface for MCP tools.
+ * Each tool has a name, description, schema (Zod raw shape), and async handler.
+ */
+export interface ToolDefinition<TSchema extends z.ZodRawShape = z.ZodRawShape> {
+    /** Unique tool name (e.g., 'find_jsvmp_dispatcher') */
+    name: string;
+    /** Human-readable description of what the tool does */
+    description: string;
+    /** Zod schema object defining input parameters */
+    schema: TSchema;
+    /** Async handler function that processes the tool request */
+    handler: (params: z.infer<z.ZodObject<TSchema>>) => Promise<string>;
+}
+/**
+ * Helper function to create a type-safe tool definition.
+ * Validates the tool definition structure at compile time.
+ *
+ * @param definition - The tool definition object
+ * @returns The same definition with proper typing
+ */
+export declare function defineTool<TSchema extends z.ZodRawShape>(definition: ToolDefinition<TSchema>): ToolDefinition<TSchema>;
+//# sourceMappingURL=ToolDefinition.d.ts.map

package/dist/tools/ToolDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolDefinition.d.ts","sourceRoot":"","sources":["../../src/tools/ToolDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;IAC3E,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,WAAW,EACtD,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,GAClC,cAAc,CAAC,OAAO,CAAC,CAEzB"}

package/dist/tools/findJsvmpDispatcher.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+/**
+ * Input schema for find_jsvmp_dispatcher tool
+ */
+export declare const FindJsvmpDispatcherInputSchema: {
+    filePath: z.ZodString;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+    charLimit: z.ZodOptional<z.ZodNumber>;
+};
+/**
+ * MCP Tool: find_jsvmp_dispatcher
+ *
+ * Uses LLM to detect JSVMP (JavaScript Virtual Machine Protection) patterns in code.
+ *
+ * JSVMP is a code protection technique that converts JavaScript to bytecode
+ * executed by a virtual machine. This tool identifies:
+ * - If-Else Dispatchers
+ * - Switch Dispatchers
+ * - Instruction Arrays
+ * - Stack Operations
+ *
+ * Requires OPENAI_API_KEY environment variable to be set.
+ */
+export declare const findJsvmpDispatcherTool: {
+    name: string;
+    description: string;
+    schema: {
+        filePath: z.ZodString;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+        charLimit: z.ZodOptional<z.ZodNumber>;
+    };
+    handler: (params: {
+        filePath: string;
+        startLine: number;
+        endLine: number;
+        charLimit?: number;
+    }) => Promise<string>;
+};
+//# sourceMappingURL=findJsvmpDispatcher.d.ts.map

package/dist/tools/findJsvmpDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findJsvmpDispatcher.d.ts","sourceRoot":"","sources":["../../src/tools/findJsvmpDispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;CAK1C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;sBAcV;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,KAAG,OAAO,CAAC,MAAM,CAAC;CAapB,CAAC"}

package/dist/tools/findJsvmpDispatcherTool.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+/**
+ * Input schema for find_jsvmp_dispatcher tool
+ */
+export declare const FindJsvmpDispatcherInputSchema: {
+    filePath: z.ZodString;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+    charLimit: z.ZodOptional<z.ZodNumber>;
+};
+/**
+ * MCP Tool: find_jsvmp_dispatcher
+ *
+ * Uses LLM to detect JSVMP (JavaScript Virtual Machine Protection) patterns in code.
+ *
+ * JSVMP is a code protection technique that converts JavaScript to bytecode
+ * executed by a virtual machine. This tool identifies:
+ * - If-Else Dispatchers
+ * - Switch Dispatchers
+ * - Instruction Arrays
+ * - Stack Operations
+ *
+ * Requires OPENAI_API_KEY environment variable to be set.
+ */
+export declare const findJsvmpDispatcherTool: import("./ToolDefinition.js").ToolDefinition<{
+    filePath: z.ZodString;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+    charLimit: z.ZodOptional<z.ZodNumber>;
+}>;
+//# sourceMappingURL=findJsvmpDispatcherTool.d.ts.map

package/dist/tools/findJsvmpDispatcherTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findJsvmpDispatcherTool.d.ts","sourceRoot":"","sources":["../../src/tools/findJsvmpDispatcherTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;CAK1C,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;;;;;EAgClC,CAAC"}

package/dist/tools/findJsvmpDispatcherTool.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Property-based tests for findJsvmpDispatcherTool
+ *
+ * Tests the MCP tool's input validation and response format properties.
+ */
+export {};
+//# sourceMappingURL=findJsvmpDispatcherTool.test.d.ts.map

package/dist/tools/findJsvmpDispatcherTool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findJsvmpDispatcherTool.test.d.ts","sourceRoot":"","sources":["../../src/tools/findJsvmpDispatcherTool.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tool aggregation module
+ * Collects all tool definitions and exports them as a unified array.
+ */
+import { findJsvmpDispatcherTool, FindJsvmpDispatcherInputSchema } from './findJsvmpDispatcherTool.js';
+/**
+ * Array of all available MCP tool definitions.
+ * To add a new tool:
+ * 1. Create a new tool module in src/tools/
+ * 2. Import it here
+ * 3. Add it to this array
+ */
+export declare const tools: readonly [import("./ToolDefinition.js").ToolDefinition<{
+    filePath: import("zod").ZodString;
+    startLine: import("zod").ZodNumber;
+    endLine: import("zod").ZodNumber;
+    charLimit: import("zod").ZodOptional<import("zod").ZodNumber>;
+}>];
+export { ToolDefinition, defineTool } from './ToolDefinition.js';
+export { findJsvmpDispatcherTool, FindJsvmpDispatcherInputSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAEvG;;;;;;GAMG;AACH,eAAO,MAAM,KAAK;;;;;GAER,CAAC;AAGX,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,CAAC"}

package/package.json

@@ -1,23 +1,22 @@
 {
   "name": "@reverse-craft/ai-tools",
-  "version": "1.0.0",
-  "description": "AI-powered code analysis tools - LLM-driven functionality for smart-fs",
+  "version": "1.0.1",
+  "description": "MCP server for AI-powered JSVMP detection - provides LLM-driven code analysis tools",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
+  "main": "dist/server.js",
+  "bin": {
+    "ai-tools-mcp": "./dist/server.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "node build.js",
     "build:types": "tsc --emitDeclarationOnly",
+    "start": "node dist/server.js",
     "test": "vitest --run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
+    "mcp",
+    "model-context-protocol",
     "ai",
     "llm",
     "openai",
@@ -44,7 +43,9 @@
     "node": ">=18"
   },
   "dependencies": {
-    "source-map-js": "^1.2.1"
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "source-map-js": "^1.2.1",
+    "zod": "^4.2.1"
   },
   "peerDependencies": {
     "@reverse-craft/smart-fs": "^2.0.0"
@@ -52,6 +53,8 @@
   "devDependencies": {
     "@reverse-craft/smart-fs": "^2.0.0",
     "@types/node": "^22.15.29",
+    "esbuild": "^0.27.2",
+    "fast-check": "^4.5.2",
     "typescript": "^5.8.3",
     "vitest": "^4.0.16"
   }