@testledger/mcp 0.0.1 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
 # Test Reporter MCP Server
 
-MCP (Model Context Protocol) server for [Test Ledger](https://testledger.dev) that enables Claude Code to analyze flaky tests, find failure patterns, and suggest fixes.
+MCP (Model Context Protocol) server for [Test Ledger](https://testledger.dev) that enables Claude Code to analyze flaky tests, find failure patterns, suggest fixes and more.
 
 ## Installation
 
@@ -25,7 +25,7 @@ Add this to your Claude Code MCP config:
       "command": "npx",
       "args": ["-y", "@testledger/mcp"],
       "env": {
-        "TEST_REPORTER_API_KEY": "your-api-key-here"
+        "TEST_LEDGER_API_KEY": "your-api-key-here"
       }
     }
   }
@@ -42,7 +42,7 @@ Once configured, you can ask Claude Code things like:
 
 - "Why is `checkout.spec.js` flaky?"
 - "What tests have been failing the most this week?"
-- "Find all tests with timeout errors"
+- "Show me recent test failures"
 - "Are there any tests that always fail together?"
 
 ### With the /fix-flaky-test command
@@ -71,21 +71,19 @@ The MCP server provides these tools to Claude:
 | Tool | Description |
 |------|-------------|
 | `get_test_history` | Pass/fail/flaky statistics for a test |
-| `get_test_errors` | Error messages and stacktraces, grouped by frequency |
 | `get_failure_patterns` | Time-of-day, browser, and version patterns |
 | `get_correlated_failures` | Tests that fail together (shared setup issues) |
 | `get_flaky_tests` | Project-wide flaky test leaderboard |
 | `get_recent_failures` | Recent failures for quick triage |
 | `get_test_trend` | Failure rate over time |
-| `search_errors` | Full-text search across all errors |
 
 ## Configuration Options
 
 | Environment Variable | Required | Description |
-|---------------------|----------|-------------|
-| `TEST_REPORTER_API_KEY` | Yes | Your API key from the dashboard |
-| `TEST_REPORTER_API_URL` | No | Custom API URL (default: `https://app-api.testledger.dev`) |
-| `TEST_REPORTER_PROJECT_ID` | No | Default project ID to use for queries |
+|--------------------------|-----|------------------------------------------------------------|
+| `TEST_LEDGER_API_KEY`    | Yes | Your API key from the dashboard                            |
+| `TEST_LEDGER_API_URL`    | No  | Custom API URL (default: `https://app-api.testledger.dev`) |
+| `TEST_LEDGER_PROJECT_ID` | No  | Default project ID to use for queries                      |
 
 ### Example with all options
 
@@ -96,8 +94,8 @@ The MCP server provides these tools to Claude:
       "command": "npx",
       "args": ["-y", "@testledger/mcp"],
       "env": {
-        "TEST_REPORTER_API_KEY": "tr_live_abc123",
-        "TEST_REPORTER_PROJECT_ID": "42"
+        "TEST_LEDGER_API_KEY": "tr_live_abc123",
+        "TEST_LEDGER_PROJECT_ID": "42"
       }
     }
   }

package/dist/index.js

@@ -3,33 +3,49 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 // Configuration from environment
-const API_BASE_URL = process.env.TEST_REPORTER_API_URL;
-const API_KEY = process.env.TEST_REPORTER_API_KEY || "";
-const DEFAULT_PROJECT_ID = process.env.TEST_REPORTER_PROJECT_ID;
-// Helper to make API calls
+const API_BASE_URL = process.env.TEST_LEDGER_API_URL;
+const API_KEY = process.env.TEST_LEDGER_API_KEY || "";
+const DEFAULT_PROJECT_ID = process.env.TEST_LEDGER_PROJECT_ID;
+// API request timeout (25s to stay under 30s gateway limit)
+const API_TIMEOUT_MS = 25000;
+// Helper to make API calls with timeout
 async function apiCall(endpoint, params = {}) {
-    const url = new URL(endpoint, API_BASE_URL);
-    // Inject default project ID if not provided
-    if (DEFAULT_PROJECT_ID && !params.project_id) {
-        params.project_id = DEFAULT_PROJECT_ID;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), API_TIMEOUT_MS);
+    try {
+        const url = new URL(endpoint, API_BASE_URL);
+        // Inject default project ID if not provided
+        if (DEFAULT_PROJECT_ID && !params.project_id) {
+            params.project_id = DEFAULT_PROJECT_ID;
+        }
+        // Add query params
+        Object.entries(params).forEach(([key, value]) => {
+            if (value !== undefined && value !== null) {
+                url.searchParams.append(key, String(value));
+            }
+        });
+        const response = await fetch(url.toString(), {
+            headers: {
+                "Authorization": `Bearer ${API_KEY}`,
+                "Content-Type": "application/json",
+            },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`API error ${response.status}: ${error}`);
+        }
+        return response.json();
     }
-    // Add query params
-    Object.entries(params).forEach(([key, value]) => {
-        if (value !== undefined && value !== null) {
-            url.searchParams.append(key, String(value));
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            throw new Error(`Request timeout after ${API_TIMEOUT_MS / 1000}s. Try reducing 'days' or 'limit' parameters.`);
         }
-    });
-    const response = await fetch(url.toString(), {
-        headers: {
-            "Authorization": `Bearer ${API_KEY}`,
-            "Content-Type": "application/json",
-        },
-    });
-    if (!response.ok) {
-        const error = await response.text();
-        throw new Error(`API error ${response.status}: ${error}`);
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
     }
-    return response.json();
 }
 // Define the tools
 const tools = [
@@ -60,38 +76,6 @@ const tools = [
             required: ["spec_file"],
         },
     },
-    {
-        name: "get_test_errors",
-        description: "Get error messages and stacktraces for a test's failures, grouped by unique error. Use this to see what errors are occurring and how often.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                spec_file: {
-                    type: "string",
-                    description: "The spec file path",
-                },
-                test_title: {
-                    type: "string",
-                    description: "Specific test title (optional)",
-                },
-                project_id: {
-                    type: "number",
-                    description: "Project ID to filter by (optional)",
-                },
-                days: {
-                    type: "number",
-                    description: "Days to look back (default: 30)",
-                    default: 30,
-                },
-                limit: {
-                    type: "number",
-                    description: "Maximum number of unique errors to return (default: 20)",
-                    default: 20,
-                },
-            },
-            required: ["spec_file"],
-        },
-    },
     {
         name: "get_failure_patterns",
         description: "Analyze when and how tests fail to identify patterns. Returns failure rates by hour, day of week, version, browser/site, and duration analysis.",
@@ -153,7 +137,7 @@ const tools = [
     },
     {
         name: "get_flaky_tests",
-        description: "Get a list of flaky tests (tests that fail then pass on retry) across the project, sorted by flakiness rate.",
+        description: "Get a list of flaky tests (tests that fail then pass on retry) across the project, sorted by flakiness rate. Note: This scans all tests - use smaller 'days' values for faster results.",
         inputSchema: {
             type: "object",
             properties: {
@@ -163,8 +147,8 @@ const tools = [
                 },
                 days: {
                     type: "number",
-                    description: "Days to look back (default: 30)",
-                    default: 30,
+                    description: "Days to look back (default: 3). Use smaller values for faster results.",
+                    default: 3,
                 },
                 min_flaky_rate: {
                     type: "number",
@@ -173,15 +157,15 @@ const tools = [
                 },
                 limit: {
                     type: "number",
-                    description: "Maximum results to return (default: 50)",
-                    default: 50,
+                    description: "Maximum results to return (default: 20)",
+                    default: 20,
                 },
             },
         },
     },
     {
         name: "get_recent_failures",
-        description: "Get the most recent test failures for quick triage. Useful for seeing what's currently broken.",
+        description: "Get the most recent test failures for quick triage. Useful for seeing what's currently broken. For faster results, provide a spec_file filter.",
         inputSchema: {
             type: "object",
             properties: {
@@ -191,7 +175,7 @@ const tools = [
                 },
                 spec_file: {
                     type: "string",
-                    description: "Filter by spec file (optional)",
+                    description: "Filter by spec file (recommended for faster results)",
                 },
                 hours: {
                     type: "number",
@@ -200,8 +184,8 @@ const tools = [
                 },
                 limit: {
                     type: "number",
-                    description: "Maximum results (default: 50)",
-                    default: 50,
+                    description: "Maximum results (default: 20)",
+                    default: 20,
                 },
             },
         },
@@ -239,34 +223,6 @@ const tools = [
             required: ["spec_file"],
         },
     },
-    {
-        name: "search_errors",
-        description: "Full-text search across error messages and stacktraces. Use this to find all tests affected by a specific type of error.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                query: {
-                    type: "string",
-                    description: "Search term (e.g., 'timeout', 'element not found', 'ECONNREFUSED')",
-                },
-                project_id: {
-                    type: "number",
-                    description: "Project ID to filter by (optional)",
-                },
-                days: {
-                    type: "number",
-                    description: "Days to look back (default: 30)",
-                    default: 30,
-                },
-                limit: {
-                    type: "number",
-                    description: "Maximum results (default: 50)",
-                    default: 50,
-                },
-            },
-            required: ["query"],
-        },
-    },
 ];
 // Create the server
 const server = new Server({
@@ -288,28 +244,22 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         let result;
         switch (name) {
             case "get_test_history":
-                result = await apiCall("/api/tests/history", args);
-                break;
-            case "get_test_errors":
-                result = await apiCall("/api/tests/errors", args);
+                result = await apiCall("/tests/history", args);
                 break;
             case "get_failure_patterns":
-                result = await apiCall("/api/tests/patterns", args);
+                result = await apiCall("/tests/patterns", args);
                 break;
             case "get_correlated_failures":
-                result = await apiCall("/api/tests/correlations", args);
+                result = await apiCall("/tests/correlations", args);
                 break;
             case "get_flaky_tests":
-                result = await apiCall("/api/tests/flaky", args);
+                result = await apiCall("/tests/flaky", args);
                 break;
             case "get_recent_failures":
-                result = await apiCall("/api/tests/recent-failures", args);
+                result = await apiCall("/tests/recent-failures", args);
                 break;
             case "get_test_trend":
-                result = await apiCall("/api/tests/trend", args);
-                break;
-            case "search_errors":
-                result = await apiCall("/api/tests/search-errors", args);
+                result = await apiCall("/tests/trend", args);
                 break;
             default:
                 throw new Error(`Unknown tool: ${name}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testledger/mcp",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "MCP server for Test Ledger - analyze flaky tests with Claude Code",
   "type": "module",
   "main": "dist/index.js",