deploy-mcp 0.4.0 → 0.5.1

package/README.md

@@ -16,34 +16,22 @@ No more context-switching. No more dashboard hunting.
 ---
 
 ## Demo
-─────────────────────────
 
-### Your conversation:
-```
-User: "Check my latest Vercel deployment"
-```
+<div align="center">
+  
+  <kbd>
+    <a href="./assets/demo.gif">
+      <img src="./assets/demo-preview.png" alt="Click to watch full demo" width="600" />
+    </a>
+  </kbd>
+  
+  <br /><br />
+  
+  <sub>**[Watch Full Demo](./assets/demo.gif)** · **[Live Badge Demo](https://mcp-netlify-demo.netlify.app/)**</sub>
+  
+</div>
 
-### AI Assistant's Response:
-
-> ## Deployment Status
-> 
-> ### Current Status
-> **Project:** my-app  
-> **Platform:** Vercel  
-> **Status:** ✅ Success  
-> **URL:** https://my-app.vercel.app  
-> **Duration:** 45s  
-> **Deployed:** 2 hours ago  
-> 
-> ### Commit Info
-> **SHA:** `abc123ef`  
-> **Message:** Update homepage hero section  
-> **Author:** John Doe  
-> 
-> Everything looks good - your deployment is live and running successfully!
-
-**Just ask your AI**: *"What's the status of my latest deployment?"*  
-Get instant answers without leaving your conversation.
+---
 
 ## Quick Start
 ─────────────────────────
@@ -116,6 +104,8 @@ You can use **multiple platforms simultaneously** by providing tokens for each p
    - `"What's the status of my latest Vercel deployment?"`
    - `"Show me Vercel deployment logs"`
    - `"Watch my Vercel deployment progress"`
+   - `"List all my Vercel projects"`
+   - `"Show last 5 deployments for project-name"`
 
 4. **Required permissions:** Read access to deployments and projects
 
@@ -146,6 +136,8 @@ You can use **multiple platforms simultaneously** by providing tokens for each p
    - `"What's the status of my latest Netlify deployment?"`
    - `"Show me Netlify deployment logs"`
    - `"Watch my Netlify deployment progress"`
+   - `"List all my Netlify sites"`
+   - `"Show deployment history for site-name"`
 
 4. **Required permissions:** Read access to sites and deploys
 
@@ -338,10 +330,11 @@ deploy-mcp provides these tools to your AI assistant:
 
 | Tool | Description | Example Command |
 |------|-------------|-----------------|
-| `check_deployment_status` | Get latest deployment status | *"Check my deployment status"* |
+| `check_deployment_status` | Get latest deployment status or history | *"Check my deployment status"* / *"Show last 5 deployments"* |
 | `watch_deployment` | Monitor deployment in real-time | *"Watch my deployment progress"* |
 | `compare_deployments` | Compare recent deployments | *"Compare my last 2 deployments"* |
 | `get_deployment_logs` | Fetch deployment logs | *"Show me deployment logs"* |
+| `list_projects` | List all available projects | *"List my Vercel projects"* / *"Show all Netlify sites"* |
 
 ### Platform-Specific Usage
 
@@ -349,9 +342,30 @@ Commands work across all configured platforms:
 
 ```
 "Check my Vercel deployment for my-app"
+"Show last 10 deployments for my-app on Vercel"
+"List all my Vercel projects"
 "Check my Netlify deployment for my-site"
 "Show me logs for deployment abc123 on Vercel"
 "Watch my Netlify deployment progress"
+"Show all my Netlify sites"
+```
+
+### New Features
+
+#### List Projects
+Discover all your projects/sites across platforms:
+```
+"List my Vercel projects"
+"Show all Netlify sites"
+"What projects do I have on Vercel?"
+```
+
+#### Deployment History
+View multiple recent deployments at once:
+```
+"Show last 5 deployments for my-app"
+"Get deployment history for my-site"
+"Check last 10 deployments on Vercel"
 ```
 
 The AI will automatically use the correct platform based on:

package/dist/{chunk-V4XY4X6P.js → chunk-YU5SU5ZI.js}

@@ -4,7 +4,8 @@ var SUPPORTED_PLATFORMS = ["vercel", "netlify"];
 var checkDeploymentStatusSchema = z.object({
   platform: z.enum(SUPPORTED_PLATFORMS).describe("The deployment platform"),
   project: z.string().describe("The project name or ID"),
-  token: z.string().optional().describe("API token for authentication (optional if set in environment)")
+  token: z.string().optional().describe("API token for authentication (optional if set in environment)"),
+  limit: z.number().min(1).max(20).default(1).describe("Number of recent deployments to return (default: 1, max: 20)")
 });
 var watchDeploymentSchema = z.object({
   platform: z.enum(SUPPORTED_PLATFORMS).describe("The deployment platform"),
@@ -42,6 +43,11 @@ var getDeploymentLogsSchema = z.object({
   filter: z.enum(["error", "warning", "all"]).default("error").describe("Filter logs by type (default: error)"),
   token: z.string().optional().describe("API token for authentication (optional if set in environment)")
 });
+var listProjectsSchema = z.object({
+  platform: z.enum(SUPPORTED_PLATFORMS).describe("The deployment platform"),
+  limit: z.number().min(1).max(100).default(20).describe("Maximum number of projects to return (default: 20, max: 100)"),
+  token: z.string().optional().describe("API token for authentication (optional if set in environment)")
+});
 var tools = [
   {
     name: "check_deployment_status",
@@ -61,6 +67,13 @@ var tools = [
         token: {
           type: "string",
           description: "API token for authentication (optional if set in environment)"
+        },
+        limit: {
+          type: "number",
+          minimum: 1,
+          maximum: 20,
+          default: 1,
+          description: "Number of recent deployments to return (default: 1, max: 20)"
         }
       },
       required: ["platform", "project"]
@@ -176,6 +189,32 @@ var tools = [
       },
       required: ["platform", "deploymentId"]
     }
+  },
+  {
+    name: "list_projects",
+    description: "List all available projects/sites on a platform that you have access to",
+    inputSchema: {
+      type: "object",
+      properties: {
+        platform: {
+          type: "string",
+          enum: ["vercel", "netlify"],
+          description: "The deployment platform"
+        },
+        limit: {
+          type: "number",
+          minimum: 1,
+          maximum: 100,
+          default: 20,
+          description: "Maximum number of projects to return (default: 20, max: 100)"
+        },
+        token: {
+          type: "string",
+          description: "API token for authentication (optional if set in environment)"
+        }
+      },
+      required: ["platform"]
+    }
   }
 ];
 
@@ -317,7 +356,7 @@ var API_CONFIG = {
   DEFAULT_DEPLOYMENT_LIMIT: 10,
   SINGLE_DEPLOYMENT_LIMIT: 1
 };
-var PLATFORM_NAMES = {
+var PLATFORM = {
   VERCEL: "vercel",
   NETLIFY: "netlify",
   RAILWAY: "railway",
@@ -336,6 +375,23 @@ var VERCEL_STATES = {
   INITIALIZING: "INITIALIZING",
   QUEUED: "QUEUED"
 };
+var NETLIFY_STATES = {
+  NEW: "new",
+  PENDING_REVIEW: "pending_review",
+  ACCEPTED: "accepted",
+  REJECTED: "rejected",
+  ENQUEUED: "enqueued",
+  BUILDING: "building",
+  UPLOADING: "uploading",
+  UPLOADED: "uploaded",
+  PREPARING: "preparing",
+  PREPARED: "prepared",
+  PROCESSING: "processing",
+  PROCESSED: "processed",
+  READY: "ready",
+  ERROR: "error",
+  RETRYING: "retrying"
+};
 var ADAPTER_ERRORS = {
   TOKEN_REQUIRED: "Vercel token required. Set VERCEL_TOKEN environment variable or pass token parameter.",
   FETCH_DEPLOYMENT_FAILED: "Failed to fetch deployment status from Vercel",
@@ -573,6 +629,12 @@ var VercelEndpoints = {
     method: "GET",
     docsUrl: "https://vercel.com/docs/rest-api/endpoints/user#get-the-authenticated-user",
     description: "Get authenticated user information"
+  },
+  listProjects: {
+    path: "/v10/projects",
+    method: "GET",
+    docsUrl: "https://vercel.com/docs/rest-api/reference/endpoints/projects/retrieve-a-list-of-projects",
+    description: "List all projects for authenticated user or team"
   }
 };
 
@@ -673,6 +735,23 @@ var VercelAPI = class extends BaseAPIClient {
       );
     }
   }
+  async listProjects(token, limit = 20) {
+    try {
+      return await this.request(
+        this.endpoints.listProjects,
+        {
+          searchParams: { limit: limit.toString() },
+          headers: {
+            Authorization: `Bearer ${token}`
+          },
+          token
+          // Pass token for rate limiting
+        }
+      );
+    } catch (error) {
+      throw this.handleApiError(error, "Failed to fetch projects list");
+    }
+  }
   handleApiError(error, context) {
     if (error instanceof Error) {
       const message = error.message.toLowerCase();
@@ -718,7 +797,7 @@ var VercelAPI = class extends BaseAPIClient {
 
 // src/adapters/vercel/index.ts
 var VercelAdapter = class extends BaseAdapter {
-  name = PLATFORM_NAMES.VERCEL;
+  name = PLATFORM.VERCEL;
   api;
   constructor(config) {
     super();
@@ -744,7 +823,7 @@ var VercelAdapter = class extends BaseAdapter {
         return {
           status: ADAPTER_ERRORS.UNKNOWN_STATUS,
           projectName: project,
-          platform: PLATFORM_NAMES.VERCEL
+          platform: PLATFORM.VERCEL
         };
       }
       return this.transformDeployment(data.deployments[0]);
@@ -770,7 +849,7 @@ var VercelAdapter = class extends BaseAdapter {
       status,
       url: deployment.url ? `https://${deployment.url}` : void 0,
       projectName: deployment.name,
-      platform: PLATFORM_NAMES.VERCEL,
+      platform: PLATFORM.VERCEL,
       timestamp: this.formatTimestamp(deployment.createdAt),
       duration: deployment.ready ? this.calculateDuration(deployment.createdAt, deployment.ready) : void 0,
       environment: deployment.target || ENVIRONMENT_TYPES.PRODUCTION,
@@ -809,6 +888,14 @@ var VercelAdapter = class extends BaseAdapter {
   async getDeploymentStatus(project, token) {
     return this.getLatestDeployment(project, token);
   }
+  async listProjects(token, limit = 20) {
+    const response = await this.api.listProjects(token, limit);
+    return response.projects.map((project) => ({
+      id: project.id,
+      name: project.name,
+      url: project.latestDeployments?.[0]?.url ? `https://${project.latestDeployments[0].url}` : void 0
+    }));
+  }
 };
 
 // src/adapters/netlify/endpoints.ts
@@ -883,15 +970,6 @@ var NetlifyAPI = class extends BaseAPIClient {
     this.siteCache.set(siteNameOrId, site.id);
     return site.id;
   }
-  async listSites(token) {
-    const options = {
-      headers: {
-        Authorization: `Bearer ${token}`
-      },
-      token
-    };
-    return this.request(this.endpoints.listSites, options);
-  }
   async listDeploys(siteNameOrId, token, limit = 10) {
     const siteId = await this.getSiteId(siteNameOrId, token);
     const endpoint = {
@@ -942,11 +1020,23 @@ var NetlifyAPI = class extends BaseAPIClient {
     };
     return this.request(this.endpoints.getUser, options);
   }
+  async listSites(token, limit = 20) {
+    const options = {
+      headers: {
+        Authorization: `Bearer ${token}`
+      },
+      searchParams: {
+        per_page: limit.toString()
+      },
+      token
+    };
+    return this.request(this.endpoints.listSites, options);
+  }
 };
 
 // src/adapters/netlify/index.ts
 var NetlifyAdapter = class extends BaseAdapter {
-  name = "netlify";
+  name = PLATFORM.NETLIFY;
   api;
   constructor() {
     super();
@@ -1090,6 +1180,14 @@ var NetlifyAdapter = class extends BaseAdapter {
       );
     }
   }
+  async listProjects(token, limit = 20) {
+    const sites = await this.api.listSites(token, limit);
+    return sites.map((site) => ({
+      id: site.id,
+      name: site.name,
+      url: site.ssl_url || site.url || void 0
+    }));
+  }
 };
 
 // src/core/deployment-intelligence.ts
@@ -1798,6 +1896,37 @@ ${status.commit ? `### Commit Info
     }
     return formatted;
   }
+  static formatMultipleStatuses(statuses) {
+    const display = `## Deployment History
+
+### Recent Deployments (${statuses.length})
+
+${statuses.map((status, index) => {
+      const statusIcon = status.status === "success" ? "\u2705" : status.status === "building" ? "\u{1F504}" : status.status === "failed" ? "\u274C" : "\u2753";
+      return `**${index + 1}. ${statusIcon} ${status.projectName}**  
+   Status: ${status.status}  
+   Environment: ${status.environment || "production"}  
+   ${status.url ? `URL: ${status.url}  ` : ""}  
+   Time: ${status.timestamp}  
+   ${status.duration ? `Duration: ${status.duration}s  ` : ""}  
+   ${status.commit ? `Commit: \`${status.commit.sha?.slice(0, 7) || "N/A"}\` ${status.commit.message || ""}` : ""}`;
+    }).join("\n\n")}
+`;
+    return {
+      version: "1.0",
+      tool: "check_deployment_status",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      display,
+      data: {
+        count: statuses.length,
+        deployments: statuses
+      },
+      highlights: {
+        status: `${statuses.length} deployments`,
+        url: statuses[0]?.url
+      }
+    };
+  }
 };
 
 // src/core/mcp-handler.ts
@@ -1876,6 +2005,8 @@ var MCPHandler = class {
         return this.compareDeployments(args);
       case "get_deployment_logs":
         return this.getDeploymentLogs(args);
+      case "list_projects":
+        return this.listProjects(args);
       default:
         throw new Error(`Unknown tool: ${tool}`);
     }
@@ -1911,12 +2042,32 @@ var MCPHandler = class {
       throw new Error(`Unsupported platform: ${validated.platform}`);
     }
     try {
-      const status = await adapter.getLatestDeployment(
-        validated.project,
-        validated.token
-      );
-      const formattedStatus = this.formatResponse(status, validated.platform);
-      return ResponseFormatter.formatStatus(formattedStatus);
+      if (validated.limit === 1) {
+        const status = await adapter.getLatestDeployment(
+          validated.project,
+          validated.token
+        );
+        const formattedStatus = this.formatResponse(status, validated.platform);
+        return ResponseFormatter.formatStatus(formattedStatus);
+      } else {
+        const deployments = await adapter.getRecentDeployments(
+          validated.project,
+          validated.token || process.env[`${validated.platform.toUpperCase()}_TOKEN`] || "",
+          validated.limit
+        );
+        if (deployments.length === 0) {
+          return ResponseFormatter.formatStatus({
+            status: "unknown",
+            projectName: validated.project,
+            platform: validated.platform,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+        }
+        const statuses = deployments.map(
+          (d) => this.formatDeploymentStatus(d, validated.platform)
+        );
+        return ResponseFormatter.formatMultipleStatuses(statuses);
+      }
     } catch (error) {
       console.error(`Error checking deployment status:`, error);
       throw new Error(
@@ -1924,6 +2075,69 @@ var MCPHandler = class {
       );
     }
   }
+  formatDeploymentStatus(deployment, platform) {
+    if (platform === PLATFORM.VERCEL) {
+      return {
+        id: deployment.uid,
+        status: this.mapVercelState(deployment.state),
+        url: deployment.url ? `https://${deployment.url}` : void 0,
+        projectName: deployment.name,
+        platform,
+        timestamp: new Date(deployment.createdAt).toISOString(),
+        duration: deployment.ready ? Math.floor((deployment.ready - deployment.createdAt) / 1e3) : void 0,
+        environment: deployment.target || "production",
+        commit: deployment.meta ? {
+          sha: deployment.meta.githubCommitSha,
+          message: deployment.meta.githubCommitMessage,
+          author: deployment.meta.githubCommitAuthorName
+        } : void 0
+      };
+    } else if (platform === PLATFORM.NETLIFY) {
+      return {
+        id: deployment.id,
+        status: this.mapNetlifyState(deployment.state),
+        url: deployment.ssl_url || deployment.url,
+        projectName: deployment.name,
+        platform,
+        timestamp: deployment.created_at,
+        duration: deployment.deploy_time,
+        environment: deployment.context || "production",
+        commit: deployment.commit_ref ? {
+          sha: deployment.commit_ref,
+          message: deployment.title,
+          author: deployment.committer
+        } : void 0
+      };
+    }
+    return deployment;
+  }
+  mapVercelState(state) {
+    switch (state) {
+      case VERCEL_STATES.READY:
+        return "success";
+      case VERCEL_STATES.ERROR:
+      case VERCEL_STATES.CANCELED:
+        return "failed";
+      case VERCEL_STATES.BUILDING:
+      case VERCEL_STATES.INITIALIZING:
+      case VERCEL_STATES.QUEUED:
+        return "building";
+      default:
+        return "unknown";
+    }
+  }
+  mapNetlifyState(state) {
+    switch (state) {
+      case NETLIFY_STATES.READY:
+      case NETLIFY_STATES.PROCESSED:
+        return "success";
+      case NETLIFY_STATES.ERROR:
+      case NETLIFY_STATES.REJECTED:
+        return "failed";
+      default:
+        return "building";
+    }
+  }
   formatResponse(status, platform) {
     return {
       ...status,
@@ -1997,6 +2211,69 @@ ${messages.join("\n\n")}
   schemaToJsonSchema(zodSchema) {
     return JSON.parse(JSON.stringify(zodSchema));
   }
+  async listProjects(args) {
+    const validated = listProjectsSchema.parse(args);
+    const adapter = this.adapters.get(validated.platform);
+    if (!adapter) {
+      throw new Error(`Unsupported platform: ${validated.platform}`);
+    }
+    const tokenEnvKey = `${validated.platform.toUpperCase()}_TOKEN`;
+    const token = validated.token || process.env[tokenEnvKey];
+    if (!token) {
+      throw new Error(
+        `Authentication required. Please provide a token or set ${tokenEnvKey} environment variable.`
+      );
+    }
+    try {
+      const projects = await adapter.listProjects(token, validated.limit);
+      const display = `## Projects on ${validated.platform}
+
+### Found ${projects.length} project${projects.length !== 1 ? "s" : ""}
+
+${projects.map((p, i) => {
+        const safeName = p.name.replace(/[<>"'&]/g, "");
+        return `**${i + 1}. ${safeName}**  
+   ID: \`${p.id}\`  
+   ${p.url ? `URL: ${p.url}` : "URL: Not deployed yet"}`;
+      }).join("\n\n")}
+
+${projects.length === validated.limit ? `
+*Showing first ${validated.limit} projects. Use a higher limit to see more.*` : ""}`;
+      return {
+        version: "1.0",
+        tool: "list_projects",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        display,
+        data: {
+          platform: validated.platform,
+          count: projects.length,
+          projects: projects.map((p) => ({
+            id: p.id,
+            name: p.name,
+            url: p.url
+          }))
+        },
+        highlights: {
+          status: `${projects.length} projects found`
+        }
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : "Unknown error";
+      if (message.includes("401") || message.includes("unauthorized")) {
+        throw new Error(
+          `Authentication failed. Please check your ${validated.platform} token.`
+        );
+      }
+      if (message.includes("429") || message.includes("rate limit")) {
+        throw new Error(
+          `Rate limit exceeded for ${validated.platform}. Please try again later.`
+        );
+      }
+      throw new Error(
+        `Failed to list projects on ${validated.platform}: ${message}`
+      );
+    }
+  }
 };
 
 export {

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   NetlifyAdapter,
   VercelAdapter,
   tools
-} from "./chunk-V4XY4X6P.js";
+} from "./chunk-YU5SU5ZI.js";
 
 // src/index.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";

package/dist/worker.js

@@ -1,7 +1,7 @@
 import {
   MCPHandler,
   VercelAdapter
-} from "./chunk-V4XY4X6P.js";
+} from "./chunk-YU5SU5ZI.js";
 
 // src/utils/github.ts
 async function validateRepository(user, repo) {
@@ -786,7 +786,7 @@ var landingPageHTML = `<!DOCTYPE html>
       <div class="tools-grid">
         <div class="tool">
           <div class="tool-name">check_deployment_status</div>
-          <div class="tool-desc">Get the latest deployment status for any project</div>
+          <div class="tool-desc">Get latest deployment status or view deployment history</div>
         </div>
 
         <div class="tool">
@@ -803,6 +803,11 @@ var landingPageHTML = `<!DOCTYPE html>
           <div class="tool-name">get_deployment_logs</div>
           <div class="tool-desc">Fetch and analyze deployment logs with error detection</div>
         </div>
+
+        <div class="tool">
+          <div class="tool-name">list_projects</div>
+          <div class="tool-desc">Discover all your projects and sites across platforms</div>
+        </div>
       </div>
     </section>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deploy-mcp",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Universal deployment tracker for AI assistants",
   "keywords": [
     "mcp",