@depfixer/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,187 @@
+# @depfixer/mcp-server
+
+MCP (Model Context Protocol) server that exposes DepFixer dependency analysis tools to AI coding assistants. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.
+
+## What it does
+
+This MCP server gives your AI assistant the ability to:
+
+- **Analyze** a `package.json` for dependency conflicts, version mismatches, and health issues
+- **Check compatibility** of a specific package version against a framework version
+- **Plan migrations** from one framework version to another with before/after health scores
+
+## Quick Start
+
+### Claude Code
+
+Add to your project's `.claude/settings.json` (or global `~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "depfixer": {
+      "command": "npx",
+      "args": ["@depfixer/mcp-server"],
+      "env": {
+        "DEPFIXER_API_KEY": "dfx_live_YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "depfixer": {
+      "command": "npx",
+      "args": ["@depfixer/mcp-server"],
+      "env": {
+        "DEPFIXER_API_KEY": "dfx_live_YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to your Windsurf MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "depfixer": {
+      "command": "npx",
+      "args": ["@depfixer/mcp-server"],
+      "env": {
+        "DEPFIXER_API_KEY": "dfx_live_YOUR_KEY"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+### depfixer_analyze
+
+Analyze a `package.json` for dependency conflicts, version mismatches, and health issues.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `packageJson` | string | Yes | The contents of the package.json file as a JSON string |
+
+**Without API key (audit mode)**: Returns issues found but hides recommended fix versions.
+**With API key (full mode)**: Returns full analysis with fix recommendations and install commands.
+
+### depfixer_check_compatibility
+
+Check if a specific npm package version is compatible with a framework version. No API key required.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `packageName` | string | Yes | The npm package name (e.g., `@angular/material`) |
+| `packageVersion` | string | Yes | The package version to check (e.g., `17.0.0`) |
+| `framework` | string | Yes | The framework name (e.g., `angular`, `react`) |
+| `frameworkVersion` | string | Yes | The framework version (e.g., `16.2.0`) |
+
+### depfixer_migrate
+
+Plan a framework migration by analyzing current dependencies and projecting changes needed. Requires API key.
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `packageJson` | string | Yes | The contents of the package.json file as a JSON string |
+| `targetFramework` | string | Yes | The target framework name (e.g., `angular`, `react`) |
+| `targetVersion` | string | Yes | The target framework major version (e.g., `18`) |
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `DEPFIXER_API_KEY` | No | - | API key for full analysis and migration features |
+| `DEPFIXER_API_URL` | No | `https://api.depfixer.com/api/v1` | Custom API endpoint URL |
+
+### API Key
+
+- **Without API key**: The `depfixer_analyze` tool runs in audit mode (finds issues but does not show recommended versions). The `depfixer_check_compatibility` tool works without a key. The `depfixer_migrate` tool requires a key.
+- **With API key**: All tools are fully available with fix recommendations, migration plans, and install commands.
+
+Get your API key at: [https://app.depfixer.com/dashboard/api-keys](https://app.depfixer.com/dashboard/api-keys)
+
+## Local Development
+
+### Prerequisites
+
+- Node.js >= 18
+- npm
+
+### Setup
+
+```bash
+cd packages/mcp-server
+npm install
+npm run build
+```
+
+### Run locally
+
+```bash
+npm start
+```
+
+### Watch mode (auto-rebuild on changes)
+
+```bash
+npm run dev
+```
+
+### Test with MCP Inspector
+
+```bash
+npm run inspect
+```
+
+This opens the MCP Inspector UI where you can interactively test all tools.
+
+### Local config for Claude Code
+
+To test the local build instead of the published npm package:
+
+```json
+{
+  "mcpServers": {
+    "depfixer": {
+      "command": "node",
+      "args": ["D:/Mouheb/Project/dep-fixer-claude/packages/mcp-server/dist/index.js"],
+      "env": {
+        "DEPFIXER_API_URL": "http://localhost:3000/api/v1",
+        "DEPFIXER_API_KEY": "your-dev-key"
+      }
+    }
+  }
+}
+```
+
+## Architecture
+
+```
+src/
+  index.ts          # Entry point — stdio transport setup
+  server.ts         # MCP server creation and tool registration
+  api-client.ts     # HTTP client for DepFixer API
+  types.ts          # TypeScript interfaces
+  tools/
+    analyze.ts      # depfixer_analyze tool
+    compatibility.ts # depfixer_check_compatibility tool
+    migrate.ts      # depfixer_migrate tool
+```
+
+All logging uses `console.error()` since stdout is reserved for JSON-RPC communication with the MCP client.

package/dist/api-client.d.ts

@@ -0,0 +1,31 @@
+import { ApiClientConfig, AnalyzeResult, CompatibilityResult, MigrateResult } from './types.js';
+export declare class DepFixerApiClient {
+    private client;
+    private apiKey?;
+    constructor(config: ApiClientConfig);
+    /**
+     * Audit analysis (FREE, no auth required)
+     * Returns issues without recommended versions
+     */
+    analyzeAudit(packageJson: any): Promise<AnalyzeResult>;
+    /**
+     * CI analysis (requires API key)
+     * Returns full analysis with recommendations
+     */
+    analyzeCi(packageJson: any, framework?: string): Promise<AnalyzeResult>;
+    /**
+     * Migration analysis (requires API key)
+     * Returns migration plan with before/after scores
+     */
+    analyzeMigrate(packageJson: any, targetVersion: string, framework?: string): Promise<MigrateResult>;
+    /**
+     * Compatibility check (FREE, no auth required)
+     */
+    checkCompatibility(packageName: string, packageVersion: string, framework: string, frameworkVersion: string): Promise<CompatibilityResult>;
+    /**
+     * Framework detection (FREE, no auth required)
+     */
+    detectFramework(packageJson: any): Promise<any>;
+    private request;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhG,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,MAAM,EAAE,eAAe;IAYnC;;;OAGG;IACG,YAAY,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC;IAK5D;;;OAGG;IACG,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQ7E;;;OAGG;IACG,cAAc,CAAC,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAQzG;;OAEG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,mBAAmB,CAAC;IAW/B;;OAEG;IACG,eAAe,CAAC,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YAKvC,OAAO;CA4BtB"}

package/dist/api-client.js

@@ -0,0 +1,94 @@
+import axios, { AxiosError } from 'axios';
+export class DepFixerApiClient {
+    client;
+    apiKey;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.client = axios.create({
+            baseURL: config.baseUrl,
+            timeout: 60000, // 60s timeout for analysis
+            headers: {
+                'Content-Type': 'application/json',
+                'User-Agent': 'depfixer-mcp/1.0',
+            },
+        });
+    }
+    /**
+     * Audit analysis (FREE, no auth required)
+     * Returns issues without recommended versions
+     */
+    async analyzeAudit(packageJson) {
+        const response = await this.request('/cli/analyze/audit', { packageJson });
+        return response.data;
+    }
+    /**
+     * CI analysis (requires API key)
+     * Returns full analysis with recommendations
+     */
+    async analyzeCi(packageJson, framework) {
+        if (!this.apiKey) {
+            throw new Error('API key required for full analysis. Set DEPFIXER_API_KEY environment variable.');
+        }
+        const response = await this.request('/cli/analyze/ci', { packageJson, framework }, true);
+        return response.data;
+    }
+    /**
+     * Migration analysis (requires API key)
+     * Returns migration plan with before/after scores
+     */
+    async analyzeMigrate(packageJson, targetVersion, framework) {
+        if (!this.apiKey) {
+            throw new Error('API key required for migration analysis. Set DEPFIXER_API_KEY environment variable.');
+        }
+        const response = await this.request('/cli/analyze/migrate', { packageJson, targetVersion, framework }, true);
+        return response.data;
+    }
+    /**
+     * Compatibility check (FREE, no auth required)
+     */
+    async checkCompatibility(packageName, packageVersion, framework, frameworkVersion) {
+        const response = await this.request('/compatibility/check-exact', {
+            packageName,
+            packageVersion,
+            framework,
+            frameworkVersion,
+        });
+        // This endpoint returns {success, compatible, reason} at top level (no nested data)
+        return response;
+    }
+    /**
+     * Framework detection (FREE, no auth required)
+     */
+    async detectFramework(packageJson) {
+        const response = await this.request('/cli/detect-framework', { packageJson });
+        return response.data;
+    }
+    async request(endpoint, data, requiresAuth = false) {
+        try {
+            const headers = {};
+            if (requiresAuth && this.apiKey) {
+                headers['Authorization'] = `Bearer ${this.apiKey}`;
+            }
+            const response = await this.client.post(endpoint, data, { headers });
+            return response.data;
+        }
+        catch (error) {
+            if (error instanceof AxiosError) {
+                const status = error.response?.status;
+                const message = error.response?.data?.message || error.message;
+                if (status === 401) {
+                    throw new Error(`Authentication failed: ${message}. Check your DEPFIXER_API_KEY.`);
+                }
+                if (status === 429) {
+                    throw new Error(`Rate limit exceeded: ${message}. Try again later.`);
+                }
+                if (status === 403) {
+                    throw new Error(`Access denied: ${message}`);
+                }
+                throw new Error(`API error (${status}): ${message}`);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('[depfixer-mcp] Server started on stdio');
+}
+main().catch((error) => {
+    console.error('[depfixer-mcp] Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(): McpServer;
+//# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBpE,wBAAgB,YAAY,IAAI,SAAS,CAyDxC"}

package/dist/server.js

@@ -0,0 +1,43 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DepFixerApiClient } from './api-client.js';
+import { analyzeToolName, analyzeToolDescription, analyzeToolSchema, handleAnalyze, } from './tools/analyze.js';
+import { compatibilityToolName, compatibilityToolDescription, compatibilityToolSchema, handleCompatibility, } from './tools/compatibility.js';
+import { migrateToolName, migrateToolDescription, migrateToolSchema, handleMigrate, } from './tools/migrate.js';
+export function createServer() {
+    const apiUrl = process.env.DEPFIXER_API_URL || 'https://api.depfixer.com/api/v1';
+    const apiKey = process.env.DEPFIXER_API_KEY;
+    const hasApiKey = !!apiKey;
+    const client = new DepFixerApiClient({
+        baseUrl: apiUrl,
+        apiKey,
+    });
+    const server = new McpServer({
+        name: 'depfixer',
+        version: '1.0.0',
+    });
+    // Register analyze tool
+    server.tool(analyzeToolName, analyzeToolDescription, analyzeToolSchema, async (args) => {
+        const result = await handleAnalyze(client, hasApiKey, args);
+        return { content: [{ type: 'text', text: result }] };
+    });
+    // Register compatibility tool
+    server.tool(compatibilityToolName, compatibilityToolDescription, compatibilityToolSchema, async (args) => {
+        const result = await handleCompatibility(client, args);
+        return { content: [{ type: 'text', text: result }] };
+    });
+    // Register migrate tool
+    server.tool(migrateToolName, migrateToolDescription, migrateToolSchema, async (args) => {
+        const result = await handleMigrate(client, hasApiKey, args);
+        return { content: [{ type: 'text', text: result }] };
+    });
+    // Log mode to stderr (stdout reserved for JSON-RPC)
+    if (hasApiKey) {
+        console.error('[depfixer-mcp] Running with API key — full analysis + migration available');
+    }
+    else {
+        console.error('[depfixer-mcp] Running without API key — audit mode only (no fix recommendations)');
+        console.error('[depfixer-mcp] Set DEPFIXER_API_KEY for full features: https://app.depfixer.com/dashboard/api-keys');
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,iCAAiC,CAAC;IACjF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAE3B,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC;QACnC,OAAO,EAAE,MAAM;QACf,MAAM;KACP,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC,CACF,CAAC;IAEF,8BAA8B;IAC9B,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC,CACF,CAAC;IAEF,wBAAwB;IACxB,MAAM,CAAC,IAAI,CACT,eAAe,EACf,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC,CACF,CAAC;IAEF,oDAAoD;IACpD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC7F,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,mFAAmF,CAAC,CAAC;QACnG,OAAO,CAAC,KAAK,CAAC,oGAAoG,CAAC,CAAC;IACtH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/analyze.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import { DepFixerApiClient } from '../api-client.js';
+export declare const analyzeToolName = "depfixer_analyze";
+export declare const analyzeToolDescription = "Analyze a package.json for dependency conflicts, version mismatches, and health issues.\n\nWith API key: Returns full analysis with fix recommendations and recommended versions.\nWithout API key: Returns issues found but hides recommended versions (audit mode).\n\nInput: The raw content of a package.json file as a JSON string.\nOutput: Health score (0-100), issue summary by severity, and detailed conflict list.";
+export declare const analyzeToolSchema: {
+    packageJson: z.ZodString;
+};
+export declare function handleAnalyze(client: DepFixerApiClient, hasApiKey: boolean, args: {
+    packageJson: string;
+}): Promise<string>;
+//# sourceMappingURL=analyze.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/tools/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAElD,eAAO,MAAM,sBAAsB,maAMkD,CAAC;AAEtF,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC5B,OAAO,CAAC,MAAM,CAAC,CAyEjB"}

package/dist/tools/analyze.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+export const analyzeToolName = 'depfixer_analyze';
+export const analyzeToolDescription = `Analyze a package.json for dependency conflicts, version mismatches, and health issues.
+
+With API key: Returns full analysis with fix recommendations and recommended versions.
+Without API key: Returns issues found but hides recommended versions (audit mode).
+
+Input: The raw content of a package.json file as a JSON string.
+Output: Health score (0-100), issue summary by severity, and detailed conflict list.`;
+export const analyzeToolSchema = {
+    packageJson: z.string().describe('The contents of the package.json file as a JSON string'),
+};
+export async function handleAnalyze(client, hasApiKey, args) {
+    let parsed;
+    try {
+        parsed = JSON.parse(args.packageJson);
+    }
+    catch {
+        return 'Error: Invalid JSON. Please provide valid package.json content.';
+    }
+    try {
+        let result;
+        let mode;
+        if (hasApiKey) {
+            result = await client.analyzeCi(parsed);
+            mode = 'full';
+        }
+        else {
+            result = await client.analyzeAudit(parsed);
+            mode = 'audit';
+        }
+        const { summary, healthScore, totalPackages, conflicts, framework } = result;
+        const totalIssues = summary.critical + summary.high + summary.medium + summary.low;
+        let output = `## Dependency Analysis (${mode} mode)\n\n`;
+        output += `**Health Score**: ${healthScore}/100\n`;
+        output += `**Total Packages**: ${totalPackages}\n`;
+        if (framework) {
+            output += `**Framework**: ${framework.name} ${framework.version || ''}\n`;
+        }
+        output += `**Issues Found**: ${totalIssues}\n\n`;
+        if (totalIssues > 0) {
+            output += `### Issues by Severity\n`;
+            if (summary.critical > 0)
+                output += `- Critical: ${summary.critical}\n`;
+            if (summary.high > 0)
+                output += `- High: ${summary.high}\n`;
+            if (summary.medium > 0)
+                output += `- Medium: ${summary.medium}\n`;
+            if (summary.low > 0)
+                output += `- Low: ${summary.low}\n`;
+            output += `\n`;
+        }
+        if (conflicts && conflicts.length > 0) {
+            output += `### Conflicts\n\n`;
+            for (const conflict of conflicts) {
+                output += `**${conflict.package}**\n`;
+                if (conflict.issue || conflict.description) {
+                    output += `  Issue: ${conflict.issue || conflict.description}\n`;
+                }
+                if (conflict.currentVersion)
+                    output += `  Current: ${conflict.currentVersion}\n`;
+                if (conflict.recommendedVersion)
+                    output += `  Recommended: ${conflict.recommendedVersion}\n`;
+                if (conflict.severity)
+                    output += `  Severity: ${conflict.severity}\n`;
+                output += `\n`;
+            }
+        }
+        // Fix commands
+        if (mode === 'full') {
+            const fixable = conflicts?.filter((c) => c.recommendedVersion) || [];
+            if (fixable.length > 0) {
+                output += `### Fix Commands\n\n`;
+                output += `\`\`\`bash\nnpm install`;
+                for (const c of fixable) {
+                    output += ` ${c.package}@${c.recommendedVersion}`;
+                }
+                output += `\n\`\`\`\n`;
+            }
+        }
+        else {
+            output += `\n> **Note**: Running in audit mode (no API key). Set DEPFIXER_API_KEY for full analysis with fix recommendations.\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        return `Error analyzing package.json: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+//# sourceMappingURL=analyze.js.map

package/dist/tools/analyze.js.map

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

package/dist/tools/compatibility.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import { DepFixerApiClient } from '../api-client.js';
+export declare const compatibilityToolName = "depfixer_check_compatibility";
+export declare const compatibilityToolDescription = "Check if a specific npm package version is compatible with a framework version.\n\nNo API key required. Use this to verify if a package works with your framework before installing.\n\nExample: Check if @angular/material@17.0.0 is compatible with Angular 16.";
+export declare const compatibilityToolSchema: {
+    packageName: z.ZodString;
+    packageVersion: z.ZodString;
+    framework: z.ZodString;
+    frameworkVersion: z.ZodString;
+};
+export declare function handleCompatibility(client: DepFixerApiClient, args: {
+    packageName: string;
+    packageVersion: string;
+    framework: string;
+    frameworkVersion: string;
+}): Promise<string>;
+//# sourceMappingURL=compatibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/tools/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE,eAAO,MAAM,4BAA4B,sQAIiC,CAAC;AAE3E,eAAO,MAAM,uBAAuB;;;;;CAKnC,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,MAAM,CAAC,CA6BjB"}

package/dist/tools/compatibility.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export const compatibilityToolName = 'depfixer_check_compatibility';
+export const compatibilityToolDescription = `Check if a specific npm package version is compatible with a framework version.
+
+No API key required. Use this to verify if a package works with your framework before installing.
+
+Example: Check if @angular/material@17.0.0 is compatible with Angular 16.`;
+export const compatibilityToolSchema = {
+    packageName: z.string().describe('The npm package name (e.g., "@angular/material")'),
+    packageVersion: z.string().describe('The package version to check (e.g., "17.0.0")'),
+    framework: z.string().describe('The framework name (e.g., "angular", "react")'),
+    frameworkVersion: z.string().describe('The framework version (e.g., "16.2.0")'),
+};
+export async function handleCompatibility(client, args) {
+    try {
+        const result = await client.checkCompatibility(args.packageName, args.packageVersion, args.framework, args.frameworkVersion);
+        let output = `## Compatibility Check\n\n`;
+        output += `**Package**: ${args.packageName}@${args.packageVersion}\n`;
+        output += `**Framework**: ${args.framework} ${args.frameworkVersion}\n\n`;
+        if (result.compatible) {
+            output += `**Result**: Compatible\n`;
+        }
+        else {
+            output += `**Result**: Not Compatible\n`;
+            if (result.reason) {
+                output += `**Reason**: ${result.reason}\n`;
+            }
+            if (result.recommendedVersion) {
+                output += `**Recommended Version**: ${args.packageName}@${result.recommendedVersion}\n`;
+            }
+        }
+        return output;
+    }
+    catch (error) {
+        return `Error checking compatibility: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/tools/compatibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.js","sourceRoot":"","sources":["../../src/tools/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,8BAA8B,CAAC;AAEpE,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;0EAI8B,CAAC;AAE3E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACpF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACpF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC/E,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CAChF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAyB,EACzB,IAKC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAC5C,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,gBAAgB,CACtB,CAAC;QAEF,IAAI,MAAM,GAAG,4BAA4B,CAAC;QAC1C,MAAM,IAAI,gBAAgB,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC;QACtE,MAAM,IAAI,kBAAkB,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,gBAAgB,MAAM,CAAC;QAE1E,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,IAAI,0BAA0B,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,8BAA8B,CAAC;YACzC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,MAAM,IAAI,eAAe,MAAM,CAAC,MAAM,IAAI,CAAC;YAC7C,CAAC;YACD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC9B,MAAM,IAAI,4BAA4B,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,kBAAkB,IAAI,CAAC;YAC1F,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACnG,CAAC;AACH,CAAC"}

package/dist/tools/migrate.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import { DepFixerApiClient } from '../api-client.js';
+export declare const migrateToolName = "depfixer_migrate";
+export declare const migrateToolDescription = "Plan a framework migration by analyzing current dependencies and projecting changes needed for the target version.\n\nRequires API key (DEPFIXER_API_KEY). Returns health score before/after, packages to update, breaking changes, and fix commands.\n\nExample: Migrate an Angular 16 project to Angular 18.";
+export declare const migrateToolSchema: {
+    packageJson: z.ZodString;
+    targetFramework: z.ZodString;
+    targetVersion: z.ZodString;
+};
+export declare function handleMigrate(client: DepFixerApiClient, hasApiKey: boolean, args: {
+    packageJson: string;
+    targetFramework: string;
+    targetVersion: string;
+}): Promise<string>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/tools/migrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAElD,eAAO,MAAM,sBAAsB,mTAImB,CAAC;AAEvD,eAAO,MAAM,iBAAiB;;;;CAI7B,CAAC;AAEF,wBAAsB,aAAa,CACjC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,MAAM,CAAC,CA+DjB"}

package/dist/tools/migrate.js

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+export const migrateToolName = 'depfixer_migrate';
+export const migrateToolDescription = `Plan a framework migration by analyzing current dependencies and projecting changes needed for the target version.
+
+Requires API key (DEPFIXER_API_KEY). Returns health score before/after, packages to update, breaking changes, and fix commands.
+
+Example: Migrate an Angular 16 project to Angular 18.`;
+export const migrateToolSchema = {
+    packageJson: z.string().describe('The contents of the package.json file as a JSON string'),
+    targetFramework: z.string().describe('The target framework name (e.g., "angular", "react")'),
+    targetVersion: z.string().describe('The target framework major version (e.g., "18", "19.0.0")'),
+};
+export async function handleMigrate(client, hasApiKey, args) {
+    if (!hasApiKey) {
+        return `## Migration Analysis\n\n**Error**: API key required for migration analysis.\n\nSet the \`DEPFIXER_API_KEY\` environment variable in your MCP server configuration.\n\nGet your API key at: https://app.depfixer.com/dashboard/api-keys`;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(args.packageJson);
+    }
+    catch {
+        return 'Error: Invalid JSON. Please provide valid package.json content.';
+    }
+    try {
+        const result = await client.analyzeMigrate(parsed, args.targetVersion, args.targetFramework);
+        let output = `## Migration Analysis\n\n`;
+        if (result.framework) {
+            output += `**Framework**: ${result.framework.name} → ${args.targetVersion}\n`;
+        }
+        output += `**Target**: ${args.targetFramework} ${args.targetVersion}\n\n`;
+        if (result.healthScore) {
+            output += `### Health Score\n`;
+            output += `- **Before**: ${result.healthScore.before}/100\n`;
+            output += `- **After**: ${result.healthScore.after}/100\n`;
+            const improvement = result.healthScore.after - result.healthScore.before;
+            if (improvement > 0) {
+                output += `- **Improvement**: +${improvement} points\n`;
+            }
+            output += `\n`;
+        }
+        if (result.packagesToUpdate && result.packagesToUpdate.length > 0) {
+            output += `### Packages to Update (${result.packagesToUpdate.length})\n\n`;
+            for (const pkg of result.packagesToUpdate) {
+                output += `- **${pkg.package}**: ${pkg.currentVersion} → ${pkg.targetVersion}`;
+                if (pkg.reason)
+                    output += ` (${pkg.reason})`;
+                output += `\n`;
+            }
+            output += `\n`;
+        }
+        if (result.breakingChanges && result.breakingChanges.length > 0) {
+            output += `### Breaking Changes\n\n`;
+            for (const change of result.breakingChanges) {
+                output += `- ${change}\n`;
+            }
+            output += `\n`;
+        }
+        if (result.commands && result.commands.length > 0) {
+            output += `### Commands\n\n`;
+            output += `\`\`\`bash\n`;
+            for (const cmd of result.commands) {
+                output += `${cmd}\n`;
+            }
+            output += `\`\`\`\n`;
+        }
+        return output;
+    }
+    catch (error) {
+        return `Error analyzing migration: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+//# sourceMappingURL=migrate.js.map

package/dist/tools/migrate.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+export interface AnalyzeResult {
+    mode: string;
+    healthScore: number;
+    totalPackages: number;
+    summary: {
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+    };
+    conflicts: ConflictItem[];
+    framework?: {
+        name: string;
+        version: string;
+    };
+    analysisId?: string;
+}
+export interface ConflictItem {
+    package: string;
+    currentVersion?: string;
+    recommendedVersion?: string;
+    issue?: string;
+    description?: string;
+    severity?: string;
+    type?: string;
+}
+export interface CompatibilityResult {
+    compatible: boolean;
+    reason?: string;
+    recommendedVersion?: string;
+    details?: any;
+}
+export interface MigrateResult {
+    framework?: {
+        name: string;
+        version: string;
+    };
+    targetVersion: string;
+    healthScore: {
+        before: number;
+        after: number;
+    };
+    packagesToUpdate: PackageUpdate[];
+    breakingChanges?: string[];
+    commands?: string[];
+}
+export interface PackageUpdate {
+    package: string;
+    currentVersion: string;
+    targetVersion: string;
+    reason?: string;
+}
+export interface ApiClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,gBAAgB,EAAE,aAAa,EAAE,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@depfixer/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for DepFixer dependency analysis - integrates with Claude Code, Cursor, Windsurf",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "depfixer-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "axios": "^1.7.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "depfixer",
+    "dependency-analysis",
+    "claude-code",
+    "cursor",
+    "windsurf"
+  ],
+  "license": "MIT"
+}