@arbotdev/metis-mcp 1.0.0

package/README.md

@@ -0,0 +1,114 @@
+# Metis MCP Server
+
+MCP (Model Context Protocol) server that exposes Metis code intelligence tools to Cursor/VS Code AI chat.
+
+## Installation
+
+```bash
+npm install -g @arbotdev/metis-mcp
+```
+
+Or use directly with npx (recommended for Cursor config):
+
+```bash
+npx @arbotdev/metis-mcp
+```
+
+## Configuration
+
+### 1. Get a JWT Token
+
+Contact your Metis administrator to get a JWT token for your repositories.
+
+### 2. Configure Cursor
+
+Add to `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "metis": {
+      "command": "npx",
+      "args": ["-y", "@arbotdev/metis-mcp@1.0.0"],
+      "env": {
+        "METIS_API_URL": "https://metis-api-13539721132.us-central1.run.app",
+        "METIS_API_TOKEN": "your-jwt-token-here"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Cursor
+
+Restart Cursor to load the MCP server.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `metis_plan_change` | Plan a code change with blast radius + AI explanation |
+| `metis_explain_impact` | Get blast radius / impact analysis for a symbol |
+| `metis_search` | Search for symbols in the codebase |
+| `metis_resolve` | Resolve symbol from file:line position |
+| `metis_get_snippet` | Get code snippet from a file |
+| `metis_doctor` | Check authentication and API connectivity |
+
+## Usage Examples
+
+In Cursor chat, ask:
+
+- "What will this change break?" → Uses `metis_plan_change`
+- "What calls this function?" → Uses `metis_explain_impact`
+- "Find the UserAuth class" → Uses `metis_search`
+- "Check my Metis connection" → Uses `metis_doctor`
+
+### Plan a refactor
+
+```
+I want to refactor the get_backend function to support multiple database backends. 
+What will this change break?
+```
+
+### Check impact
+
+```
+Show me the blast radius for the CloudBackend class.
+```
+
+### Find a symbol
+
+```
+Search for validate_token in the codebase.
+```
+
+### Verify setup
+
+```
+Run metis doctor to check my connection.
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `METIS_API_TOKEN` | **Yes** | - | JWT token for authentication |
+| `METIS_API_URL` | No | `https://metis-api-...` | Metis API base URL |
+
+## Troubleshooting
+
+### "Authentication Not Configured"
+
+The `METIS_API_TOKEN` environment variable is not set. Add it to your Cursor MCP config.
+
+### "REPO_NOT_ALLOWED"
+
+Your token doesn't have access to the requested repository. Check your `repo_allowlist` with `metis_doctor`.
+
+### "TOKEN_EXPIRED"
+
+Your JWT has expired. Contact your Metis administrator for a new token.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Metis MCP Server
+ *
+ * Exposes Metis code intelligence tools to Cursor/VS Code AI chat.
+ *
+ * Tools:
+ * - metis_plan_change: Plan a code change with blast radius + LLM explanation
+ * - metis_explain_impact: Get blast radius for a symbol
+ * - metis_search: Search for symbols in the codebase
+ * - metis_resolve: Resolve symbol from file:line position
+ * - metis_get_snippet: Get code snippet from a file
+ * - metis_doctor: Check authentication and API connectivity
+ *
+ * Environment:
+ * - METIS_API_URL: API base URL (default: production)
+ * - METIS_API_TOKEN: JWT token for authentication (REQUIRED)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,666 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * Metis MCP Server
+ *
+ * Exposes Metis code intelligence tools to Cursor/VS Code AI chat.
+ *
+ * Tools:
+ * - metis_plan_change: Plan a code change with blast radius + LLM explanation
+ * - metis_explain_impact: Get blast radius for a symbol
+ * - metis_search: Search for symbols in the codebase
+ * - metis_resolve: Resolve symbol from file:line position
+ * - metis_get_snippet: Get code snippet from a file
+ * - metis_doctor: Check authentication and API connectivity
+ *
+ * Environment:
+ * - METIS_API_URL: API base URL (default: production)
+ * - METIS_API_TOKEN: JWT token for authentication (REQUIRED)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+// Configuration
+const METIS_API_URL = process.env.METIS_API_URL || "https://metis-api-i5j6s4n2zq-uc.a.run.app";
+const METIS_API_TOKEN = process.env.METIS_API_TOKEN || "";
+// =============================================================================
+// Tool Definitions
+// =============================================================================
+const TOOLS = [
+    {
+        name: "metis_plan_change",
+        description: `Plan a code change and get blast radius analysis with AI explanation.
+    
+Use this when the user asks:
+- "What will this change break?"
+- "Plan this refactor"
+- "What's the impact of changing X?"
+- "Help me understand the blast radius"
+
+Returns structured impact analysis plus AI-generated explanation.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'owner/repo')"
+                },
+                symbol_id: {
+                    type: "string",
+                    description: "Symbol ID to analyze (e.g., 'owner/repo//path/file.py::module.ClassName')"
+                },
+                intent: {
+                    type: "string",
+                    description: "What the user is trying to change (1-2 sentences)"
+                },
+                depth: {
+                    type: "number",
+                    description: "Traversal depth (1-5, default: 3)",
+                    default: 3
+                },
+                min_confidence: {
+                    type: "number",
+                    description: "Minimum confidence for cross-repo edges (0-1, default: 0.85)",
+                    default: 0.85
+                }
+            },
+            required: ["repo", "symbol_id", "intent"]
+        }
+    },
+    {
+        name: "metis_explain_impact",
+        description: `Get blast radius / impact analysis for a symbol.
+    
+Use this when the user asks:
+- "What calls this function?"
+- "What depends on this?"
+- "Show me the blast radius"
+- "Who uses this class?"
+
+Returns callers, references, cross-repo impact, and risk assessment.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                symbol_id: {
+                    type: "string",
+                    description: "Symbol ID to analyze"
+                },
+                depth: {
+                    type: "number",
+                    description: "Traversal depth (1-5, default: 3)",
+                    default: 3
+                },
+                min_confidence: {
+                    type: "number",
+                    description: "Minimum confidence for cross-repo edges (0-1, default: 0.85)",
+                    default: 0.85
+                },
+                max_paths: {
+                    type: "number",
+                    description: "Maximum paths to return (default: 50)",
+                    default: 50
+                }
+            },
+            required: ["symbol_id"]
+        }
+    },
+    {
+        name: "metis_search",
+        description: `Search for symbols in the codebase.
+    
+Use this to find symbol IDs before calling other tools.
+Returns matching symbols with their IDs, types, and locations.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (function name, class name, etc.)"
+                },
+                repo: {
+                    type: "string",
+                    description: "Optional: filter to specific repo (e.g., 'owner/repo')"
+                },
+                limit: {
+                    type: "number",
+                    description: "Maximum results to return (default: 10)",
+                    default: 10
+                }
+            },
+            required: ["query"]
+        }
+    },
+    {
+        name: "metis_resolve",
+        description: `Resolve a symbol from file path and line number.
+    
+Use this when you know the file and line but need the symbol ID.`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'owner/repo')"
+                },
+                file_path: {
+                    type: "string",
+                    description: "Path to the file"
+                },
+                line: {
+                    type: "number",
+                    description: "Line number (1-indexed)"
+                },
+                symbol_name: {
+                    type: "string",
+                    description: "Optional: symbol name hint"
+                }
+            },
+            required: ["repo", "file_path", "line"]
+        }
+    },
+    {
+        name: "metis_get_snippet",
+        description: `Get a code snippet from a file in an indexed repository.
+    
+Use this when you need to see specific code:
+- Show code context around a symbol
+- Get a function or class definition
+- Retrieve code for inclusion in prompts`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (e.g., 'owner/repo')"
+                },
+                file_path: {
+                    type: "string",
+                    description: "Path to file within repo"
+                },
+                line_start: {
+                    type: "number",
+                    description: "Start line (1-indexed)"
+                },
+                line_end: {
+                    type: "number",
+                    description: "End line (1-indexed, inclusive)"
+                }
+            },
+            required: ["repo", "file_path", "line_start", "line_end"]
+        }
+    },
+    {
+        name: "metis_doctor",
+        description: `Check Metis API connectivity and authentication status.
+    
+Use this to verify:
+- API is reachable
+- Token is valid
+- What repos you have access to
+- What scopes are granted`,
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: []
+        }
+    }
+];
+// =============================================================================
+// API Helpers
+// =============================================================================
+function getAuthHeaders() {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (METIS_API_TOKEN) {
+        headers["Authorization"] = `Bearer ${METIS_API_TOKEN}`;
+    }
+    return headers;
+}
+function checkAuthConfigured() {
+    if (!METIS_API_TOKEN) {
+        return `## ❌ Authentication Not Configured
+
+METIS_API_TOKEN environment variable is not set.
+
+**To fix:**
+1. Generate a token: \`python scripts/mint_jwt.py --sub "your-name" --repos "owner/repo1,owner/repo2"\`
+2. Add to your Cursor MCP config (~/.cursor/mcp.json):
+
+\`\`\`json
+{
+  "mcpServers": {
+    "metis": {
+      "command": "npx",
+      "args": ["@arbotdev/metis-mcp"],
+      "env": {
+        "METIS_API_URL": "${METIS_API_URL}",
+        "METIS_API_TOKEN": "your-jwt-token-here"
+      }
+    }
+  }
+}
+\`\`\`
+
+3. Restart Cursor`;
+    }
+    return null;
+}
+async function fetchJson(url, options) {
+    // Dynamic import for node-fetch
+    const { default: fetch } = await Promise.resolve().then(() => __importStar(require("node-fetch")));
+    const headers = {
+        ...getAuthHeaders(),
+        ...options?.headers,
+    };
+    const response = await fetch(url, {
+        method: options?.method || "GET",
+        body: options?.body,
+        headers,
+    });
+    const text = await response.text();
+    let data = null;
+    try {
+        data = text ? JSON.parse(text) : null;
+    }
+    catch {
+        // Ignore parse errors
+    }
+    if (!response.ok) {
+        // Extract structured error if available
+        const errorCode = data?.detail?.error_code || data?.error_code || `HTTP_${response.status}`;
+        const errorMsg = data?.detail?.message || data?.message || data?.detail || text.slice(0, 200);
+        throw new Error(`${errorCode}: ${errorMsg}`);
+    }
+    return data;
+}
+async function handlePlanChange(args) {
+    const authError = checkAuthConfigured();
+    if (authError)
+        return authError;
+    const url = `${METIS_API_URL}/api/symbols/plan/change`;
+    const response = await fetchJson(url, {
+        method: "POST",
+        body: JSON.stringify({
+            repo: args.repo,
+            symbol_id: args.symbol_id,
+            intent: args.intent,
+            depth: args.depth || 3,
+            min_confidence: args.min_confidence || 0.85,
+            max_paths: 100,
+            include_inferred: true,
+            include_declared_only: false,
+            explain: true,
+        }),
+    });
+    // Format response for chat
+    const impact = response.impact || {};
+    const riskLevel = impact.overall_risk || "unknown";
+    const riskEmoji = riskLevel === "high" ? "🔴" : riskLevel === "medium" ? "🟡" : "🟢";
+    const fileDisplay = impact.symbol_file || "(path unavailable)";
+    let result = `## 🧭 Plan: \`${impact.symbol_name || args.symbol_id}\`\n\n`;
+    result += `**Location:** \`${impact.symbol_repo || args.repo}\` · \`${fileDisplay}\`\n`;
+    result += `**Risk Level:** ${riskEmoji} ${riskLevel.toUpperCase()}\n\n`;
+    result += `### Impact Summary\n`;
+    result += `- **Direct callers:** ${impact.direct_caller_count || 0}\n`;
+    result += `- **Direct references:** ${impact.direct_reference_count || 0}\n`;
+    result += `- **Transitive callers:** ${impact.transitive_caller_count || 0}\n`;
+    result += `- **Repos affected:** ${impact.total_repos_affected || 0}\n\n`;
+    // Risk flags
+    if (response.risk_flags?.length > 0) {
+        result += `### ⚠️ Risk Flags\n`;
+        for (const flag of response.risk_flags) {
+            result += `- **${flag.code}** (${flag.severity})\n`;
+        }
+        result += `\n`;
+    }
+    // Recommended steps
+    if (response.recommended_next_steps?.length > 0) {
+        result += `### ✅ Suggested Next Steps\n`;
+        for (const step of response.recommended_next_steps) {
+            result += `${step.priority}. ${step.type.replace(/_/g, " ").toLowerCase()}\n`;
+        }
+        result += `\n`;
+    }
+    // LLM explanation
+    if (response.explanation_markdown) {
+        result += `### 📝 AI Explanation\n`;
+        result += response.explanation_markdown + `\n\n`;
+    }
+    // "What Metis ran" footer (transparency)
+    result += `---\n\n`;
+    result += `<details>\n`;
+    result += `<summary>🔍 What Metis ran</summary>\n\n`;
+    result += `**Endpoint:** \`POST /api/symbols/plan/change\`\n\n`;
+    result += `**Parameters:**\n`;
+    result += "```json\n";
+    result += JSON.stringify({
+        repo: args.repo,
+        symbol_id: args.symbol_id,
+        intent: args.intent,
+        depth: args.depth || 3,
+        min_confidence: args.min_confidence || 0.85,
+        max_paths: 100,
+        explain: true
+    }, null, 2);
+    result += "\n```\n\n";
+    result += `**Request ID:** \`${response.request_id}\`\n`;
+    result += `**Plan ID:** \`${response.plan_id}\`\n\n`;
+    result += `</details>`;
+    return result;
+}
+async function handleExplainImpact(args) {
+    const authError = checkAuthConfigured();
+    if (authError)
+        return authError;
+    // Use POST endpoint to avoid URL encoding issues with symbol_id containing // and ::
+    const url = `${METIS_API_URL}/api/symbols/impact`;
+    const response = await fetchJson(url, {
+        method: "POST",
+        body: JSON.stringify({
+            symbol_id: args.symbol_id,
+            depth: args.depth || 3,
+            min_confidence: args.min_confidence || 0.85,
+            max_paths: args.max_paths || 50,
+            include_references: true,
+        }),
+    });
+    const riskLevel = response.overall_risk || "unknown";
+    const riskEmoji = riskLevel === "high" ? "🔴" : riskLevel === "medium" ? "🟡" : "🟢";
+    const fileDisplay = response.symbol_file || "(path unavailable)";
+    let result = `## 💥 Impact Analysis: \`${response.symbol_name}\`\n\n`;
+    result += `**Location:** \`${response.symbol_repo}\` · \`${fileDisplay}\`\n`;
+    result += `**Risk Level:** ${riskEmoji} ${riskLevel.toUpperCase()}\n\n`;
+    result += `### Summary\n`;
+    result += `- **Direct callers:** ${response.direct_caller_count || 0}\n`;
+    result += `- **Direct references:** ${response.direct_reference_count || 0}\n`;
+    result += `- **Transitive callers:** ${response.transitive_caller_count || 0}\n`;
+    result += `- **Transitive references:** ${response.transitive_reference_count || 0}\n`;
+    result += `- **Repos affected:** ${response.total_repos_affected || 0}\n`;
+    if (response.truncated) {
+        result += `- ⚠️ Results truncated (max ${response.max_paths_used} paths)\n`;
+    }
+    result += `\n`;
+    // Top callers
+    if (response.direct_callers?.length > 0) {
+        result += `### Top Callers\n`;
+        for (const caller of response.direct_callers.slice(0, 5)) {
+            const xrepo = caller.is_cross_repo ? " 🌐" : "";
+            result += `- \`${caller.name}\` in \`${caller.repo}\`${xrepo}\n`;
+        }
+        result += `\n`;
+    }
+    // Cross-repo impact
+    if (response.cross_repo_impact?.length > 0) {
+        result += `### 🌐 Cross-Repo Impact\n`;
+        for (const repo of response.cross_repo_impact.slice(0, 5)) {
+            result += `- **${repo.repo}**: ${repo.caller_count} callers, ${repo.reference_count} refs\n`;
+        }
+        result += `\n`;
+    }
+    // "What Metis ran" footer (transparency)
+    result += `---\n\n`;
+    result += `<details>\n`;
+    result += `<summary>🔍 What Metis ran</summary>\n\n`;
+    result += `**Endpoint:** \`POST /api/symbols/impact\`\n\n`;
+    result += `**Parameters:**\n`;
+    result += "```json\n";
+    result += JSON.stringify({
+        symbol_id: args.symbol_id,
+        depth: args.depth || 3,
+        min_confidence: args.min_confidence || 0.85,
+        max_paths: args.max_paths || 50,
+        include_references: true
+    }, null, 2);
+    result += "\n```\n\n";
+    result += `**Request ID:** \`${response.request_id || "N/A"}\`\n\n`;
+    result += `</details>`;
+    return result;
+}
+async function handleSearch(args) {
+    const authError = checkAuthConfigured();
+    if (authError)
+        return authError;
+    const params = new URLSearchParams({
+        q: args.query,
+        k: String(args.limit || 10),
+    });
+    if (args.repo) {
+        params.set("repo", args.repo);
+    }
+    const url = `${METIS_API_URL}/api/search/v2?${params}`;
+    const response = await fetchJson(url);
+    if (!response.candidates?.length) {
+        return `No symbols found matching "${args.query}"`;
+    }
+    let result = `## 🔍 Search Results: "${args.query}"\n\n`;
+    result += `Found ${response.candidates.length} symbol(s):\n\n`;
+    for (const item of response.candidates) {
+        result += `### \`${item.display_name || item.symbol_key}\`\n`;
+        result += `- **ID:** \`${item.symbol_key}\`\n`;
+        if (item.kind)
+            result += `- **Kind:** ${item.kind}\n`;
+        if (item.path)
+            result += `- **File:** ${item.path}\n`;
+        if (item.scores?.final)
+            result += `- **Score:** ${item.scores.final.toFixed(3)}\n`;
+        result += `\n`;
+    }
+    return result;
+}
+async function handleResolve(args) {
+    const authError = checkAuthConfigured();
+    if (authError)
+        return authError;
+    const url = `${METIS_API_URL}/api/symbols/resolve`;
+    const response = await fetchJson(url, {
+        method: "POST",
+        body: JSON.stringify({
+            repo: args.repo,
+            file_path: args.file_path,
+            line: args.line,
+            symbol_name: args.symbol_name,
+        }),
+    });
+    if (!response.found) {
+        return `No symbol found at ${args.file_path}:${args.line}`;
+    }
+    let result = `## ✅ Symbol Resolved\n\n`;
+    result += `- **ID:** \`${response.symbol_id}\`\n`;
+    if (response.name)
+        result += `- **Name:** ${response.name}\n`;
+    if (response.qualname)
+        result += `- **Qualified Name:** ${response.qualname}\n`;
+    if (response.kind)
+        result += `- **Kind:** ${response.kind}\n`;
+    return result;
+}
+async function handleSnippet(args) {
+    const authError = checkAuthConfigured();
+    if (authError)
+        return authError;
+    const url = `${METIS_API_URL}/api/snippet`;
+    const response = await fetchJson(url, {
+        method: "POST",
+        body: JSON.stringify({
+            repo: args.repo,
+            file_path: args.file_path,
+            line_start: args.line_start,
+            line_end: args.line_end,
+        }),
+    });
+    let result = `## 📄 Code Snippet\n\n`;
+    result += `**File:** \`${response.repo}/${response.file_path}\`\n`;
+    result += `**Lines:** ${response.line_start}-${response.line_end} (of ${response.total_lines})\n\n`;
+    if (response.signature) {
+        result += `**Signature:** \`${response.signature}\`\n\n`;
+    }
+    // Format snippet with line numbers
+    const lines = response.snippet.split('\n');
+    result += '```\n';
+    lines.forEach((line, idx) => {
+        const lineNum = response.line_start + idx;
+        result += `${lineNum.toString().padStart(4)} | ${line}\n`;
+    });
+    result += '```\n';
+    return result;
+}
+async function handleDoctor() {
+    let result = `## 🩺 Metis Doctor\n\n`;
+    // Check configuration
+    result += `### Configuration\n`;
+    result += `- **API URL:** \`${METIS_API_URL}\`\n`;
+    result += `- **Token configured:** ${METIS_API_TOKEN ? "✅ Yes" : "❌ No"}\n\n`;
+    if (!METIS_API_TOKEN) {
+        result += `### ❌ Authentication Required\n\n`;
+        result += `METIS_API_TOKEN environment variable is not set.\n\n`;
+        result += `**To fix:**\n`;
+        result += `1. Generate a token using \`scripts/mint_jwt.py\`\n`;
+        result += `2. Add \`METIS_API_TOKEN\` to your MCP config\n`;
+        result += `3. Restart Cursor\n`;
+        return result;
+    }
+    // Check API connectivity
+    result += `### API Connectivity\n`;
+    try {
+        const { default: fetch } = await Promise.resolve().then(() => __importStar(require("node-fetch")));
+        const healthResp = await fetch(`${METIS_API_URL}/health`, {
+            headers: getAuthHeaders(),
+        });
+        const health = await healthResp.json();
+        result += `- **Status:** ${health.status === "healthy" ? "✅ Healthy" : "⚠️ " + health.status}\n`;
+        result += `- **Mode:** ${health.mode || "unknown"}\n`;
+        result += `- **Neo4j:** ${health.neo4j_connected ? "✅ Connected" : "❌ Not connected"}\n\n`;
+    }
+    catch (e) {
+        result += `- **Status:** ❌ Unreachable\n`;
+        result += `- **Error:** ${e instanceof Error ? e.message : String(e)}\n\n`;
+        return result;
+    }
+    // Check authentication
+    result += `### Authentication\n`;
+    try {
+        const whoami = await fetchJson(`${METIS_API_URL}/api/whoami`);
+        result += `- **Subject:** ${whoami.sub}\n`;
+        result += `- **Token ID:** ${whoami.jti}\n`;
+        result += `- **Expires:** ${whoami.expires_at}\n`;
+        result += `- **Scopes:** ${whoami.scopes.join(", ")}\n`;
+        result += `- **Repos allowed:** ${whoami.repo_allowlist.length}\n\n`;
+        if (whoami.repo_allowlist.length <= 10) {
+            result += `**Allowed repositories:**\n`;
+            for (const repo of whoami.repo_allowlist) {
+                result += `- \`${repo}\`\n`;
+            }
+        }
+        else {
+            result += `**First 10 allowed repositories:**\n`;
+            for (const repo of whoami.repo_allowlist.slice(0, 10)) {
+                result += `- \`${repo}\`\n`;
+            }
+            result += `- ... and ${whoami.repo_allowlist.length - 10} more\n`;
+        }
+    }
+    catch (e) {
+        result += `- **Status:** ❌ Authentication failed\n`;
+        result += `- **Error:** ${e instanceof Error ? e.message : String(e)}\n`;
+    }
+    return result;
+}
+// =============================================================================
+// MCP Server
+// =============================================================================
+async function main() {
+    const server = new index_js_1.Server({
+        name: "metis-mcp-server",
+        version: "1.0.0",
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // List available tools
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: TOOLS,
+    }));
+    // Handle tool calls
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            let result;
+            switch (name) {
+                case "metis_plan_change":
+                    result = await handlePlanChange(args);
+                    break;
+                case "metis_explain_impact":
+                    result = await handleExplainImpact(args);
+                    break;
+                case "metis_search":
+                    result = await handleSearch(args);
+                    break;
+                case "metis_resolve":
+                    result = await handleResolve(args);
+                    break;
+                case "metis_get_snippet":
+                    result = await handleSnippet(args);
+                    break;
+                case "metis_doctor":
+                    result = await handleDoctor();
+                    break;
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+            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,
+            };
+        }
+    });
+    // Start server
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Metis MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@arbotdev/metis-mcp",
+  "version": "1.0.0",
+  "description": "Metis MCP Server - Code intelligence tools for Cursor/VS Code AI chat",
+  "main": "dist/index.js",
+  "bin": {
+    "metis-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "metis",
+    "mcp",
+    "cursor",
+    "vscode",
+    "code-intelligence",
+    "blast-radius",
+    "impact-analysis"
+  ],
+  "author": "arbotdev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/arbotdev/metis_real.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/arbotdev/metis_real/issues"
+  },
+  "homepage": "https://github.com/arbotdev/metis_real#readme",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "node-fetch": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/node-fetch": "^2.6.0",
+    "typescript": "^5.0.0",
+    "ts-node": "^10.9.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}