{"id":30872306,"url":"https://github.com/alexpota/deploy-mcp","last_synced_at":"2026-02-12T21:15:04.490Z","repository":{"id":308013592,"uuid":"1030972354","full_name":"alexpota/deploy-mcp","owner":"alexpota","description":"Universal deployment tracker for AI assistants - check deployment status without leaving your AI chat","archived":false,"fork":false,"pushed_at":"2026-01-26T17:53:50.000Z","size":9290,"stargazers_count":3,"open_issues_count":3,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-27T09:10:43.244Z","etag":null,"topics":["ai","ci-cd","claude","cloudflare-deployment","cloudflare-pages","deployment","deployment-monitor","deployment-status","deployment-tracking","mcp","netlify","netlify-deployment","real-time-monitoring","vercel","vercel-deployment","webhook-integration"],"latest_commit_sha":null,"homepage":"https://deploy-mcp.io","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexpota.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-02T18:18:50.000Z","updated_at":"2026-01-09T10:41:29.000Z","dependencies_parsed_at":"2025-09-07T22:32:03.123Z","dependency_job_id":"42197c18-2512-46ff-a531-63829478abbf","html_url":"https://github.com/alexpota/deploy-mcp","commit_stats":null,"previous_names":["alexpota/deploy-mcp"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/alexpota/deploy-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpota%2Fdeploy-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpota%2Fdeploy-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpota%2Fdeploy-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpota%2Fdeploy-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexpota","download_url":"https://codeload.github.com/alexpota/deploy-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexpota%2Fdeploy-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29379666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T19:05:20.189Z","status":"ssl_error","status_checked_at":"2026-02-12T19:01:44.216Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ci-cd","claude","cloudflare-deployment","cloudflare-pages","deployment","deployment-monitor","deployment-status","deployment-tracking","mcp","netlify","netlify-deployment","real-time-monitoring","vercel","vercel-deployment","webhook-integration"],"created_at":"2025-09-07T22:06:12.561Z","updated_at":"2026-02-12T21:15:04.456Z","avatar_url":"https://github.com/alexpota.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n\n# deploy-mcp\n\n**Universal Deployment Tracker for AI Assistants**\n\nTrack deployments across all platforms directly in your AI conversation.  \nNo more context-switching. No more dashboard hunting.\n\n[![npm version](https://img.shields.io/npm/v/deploy-mcp.svg?style=for-the-badge\u0026color=ff6b6b)](https://www.npmjs.com/package/deploy-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/deploy-mcp.svg?style=for-the-badge\u0026color=00d2d3)](https://www.npmjs.com/package/deploy-mcp)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=for-the-badge)](https://github.com/alexpota/deploy-mcp/blob/main/LICENSE)\n[![Website](https://img.shields.io/badge/website-deploy--mcp.io-ff8e53?style=for-the-badge)](https://deploy-mcp.io)\n\n\u003c/div\u003e\n\n---\n\n## Demo\n\n\u003cdiv align=\"center\"\u003e\n  \n  \u003ckbd\u003e\n    \u003ca href=\"./assets/demo.gif\"\u003e\n      \u003cimg src=\"./assets/demo-preview.png\" alt=\"Click to watch full demo\" width=\"600\" /\u003e\n    \u003c/a\u003e\n  \u003c/kbd\u003e\n  \n  \u003cbr /\u003e\u003cbr /\u003e\n  \n  \u003csub\u003e**[Watch Full Demo](./assets/demo.gif)** · **[Live Badge Demo](https://mcp-netlify-demo.netlify.app/)**\u003c/sub\u003e\n  \n\u003c/div\u003e\n\n---\n\n## Quick Start\n─────────────────────────\n\n**Get started in under 30 seconds:**\n\n```bash\nnpx deploy-mcp\n```\n\nThat's it! The server is now running and ready to be configured in your AI assistant.\n\n## Supported Platforms\n─────────────────────────\n\ndeploy-mcp supports multiple deployment platforms simultaneously. Configure as many as you need:\n\n| Platform | Status | Token Required | Features |\n|----------|--------|---------------|----------|\n| **Vercel** | ✅ Ready | `VERCEL_TOKEN` | Status, Logs, History, Real-time Monitoring |\n| **Netlify** | ✅ Ready | `NETLIFY_TOKEN` | Status, Logs, History, Real-time Monitoring |\n| **Cloudflare Pages** | ✅ Ready | `CLOUDFLARE_TOKEN` | Status, Logs, History, Real-time Monitoring |\n| **GitHub Pages** | 🚧 Coming Soon | `GITHUB_TOKEN` | - |\n\n### Multi-Platform Configuration\n\nYou can use **multiple platforms simultaneously** by providing tokens for each platform you want to track:\n\n```json\n{\n  \"mcpServers\": {\n    \"deploy-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"deploy-mcp\"],\n      \"env\": {\n        \"VERCEL_TOKEN\": \"your-vercel-token\",\n        \"NETLIFY_TOKEN\": \"your-netlify-token\",\n        \"CLOUDFLARE_TOKEN\": \"accountId:globalApiKey\"\n        // Add more platform tokens as needed\n      }\n    }\n  }\n}\n```\n\n## Platform Configuration\n─────────────────────────\n\n### Vercel\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSetup Instructions\u003c/strong\u003e\u003c/summary\u003e\n\n1. **Get your API token:**\n   - Go to [vercel.com/account/tokens](https://vercel.com/account/tokens)\n   - Click \"Create Token\"\n   - Give it a descriptive name (e.g., \"deploy-mcp\")\n   - Copy the token\n\n2. **Add to your AI assistant configuration:**\n   ```json\n   {\n     \"env\": {\n       \"VERCEL_TOKEN\": \"your-vercel-token\"\n     }\n   }\n   ```\n\n3. **Available commands:**\n   - `\"Check my Vercel deployment for project-name\"`\n   - `\"What's the status of my latest Vercel deployment?\"`\n   - `\"Show me Vercel deployment logs\"`\n   - `\"Watch my Vercel deployment progress\"`\n   - `\"List all my Vercel projects\"`\n   - `\"Show last 5 deployments for project-name\"`\n\n4. **Required permissions:** Read access to deployments and projects\n\n\u003c/details\u003e\n\n### Netlify\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSetup Instructions\u003c/strong\u003e\u003c/summary\u003e\n\n1. **Get your API token:**\n   - Go to [app.netlify.com/user/applications](https://app.netlify.com/user/applications)\n   - Under \"Personal access tokens\", click \"New access token\"\n   - Give it a descriptive name (e.g., \"deploy-mcp\")\n   - Copy the token\n\n2. **Add to your AI assistant configuration:**\n   ```json\n   {\n     \"env\": {\n       \"NETLIFY_TOKEN\": \"your-netlify-token\"\n     }\n   }\n   ```\n\n3. **Available commands:**\n   - `\"Check my Netlify deployment for site-name\"`\n   - `\"What's the status of my latest Netlify deployment?\"`\n   - `\"Show me Netlify deployment logs\"`\n   - `\"Watch my Netlify deployment progress\"`\n   - `\"List all my Netlify sites\"`\n   - `\"Show deployment history for site-name\"`\n\n4. **Required permissions:** Read access to sites and deploys\n\n\u003c/details\u003e\n\n### Cloudflare Pages\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eSetup Instructions\u003c/strong\u003e\u003c/summary\u003e\n\n1. **Get your API token:**\n   - Go to [dash.cloudflare.com/profile/api-tokens](https://dash.cloudflare.com/profile/api-tokens)\n   - Click \"Create Token\"\n   - Use \"Custom token\" with these permissions:\n     - **Zone:Zone:Read**\n     - **Zone:Page Rules:Read**\n     - **Account:Cloudflare Pages:Edit**\n   - Or use your Global API Key (format: `accountId:globalApiKey`)\n   - Copy the token\n\n2. **Add to your AI assistant configuration:**\n   ```json\n   {\n     \"env\": {\n       \"CLOUDFLARE_TOKEN\": \"your-cloudflare-token-or-accountId:globalApiKey\"\n     }\n   }\n   ```\n\n3. **Available commands:**\n   - `\"Check my Cloudflare Pages deployment for project-name\"`\n   - `\"What's the status of my latest Cloudflare Pages deployment?\"`\n   - `\"Show me Cloudflare Pages deployment logs\"`\n   - `\"Watch my Cloudflare Pages deployment progress\"`\n   - `\"List all my Cloudflare Pages projects\"`\n   - `\"Show deployment history for project-name\"`\n\n4. **Token formats supported:**\n   - **API Token**: `your-api-token` (requires `CLOUDFLARE_ACCOUNT_ID` env var)\n   - **Global API Key**: `accountId:globalApiKey` (all-in-one format)\n\n5. **Required permissions:** Account access to Cloudflare Pages\n\n\u003c/details\u003e\n\n## AI Assistant Configuration\n─────────────────────────\n\ndeploy-mcp works with any MCP-compatible AI assistant. Here's how to set it up:\n\n### Claude Desktop\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/summary\u003e\n\n**File location:**\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`  \n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`  \n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n**Configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"deploy-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"deploy-mcp\"],\n      \"env\": {\n        \"VERCEL_TOKEN\": \"your-vercel-token\",\n        \"NETLIFY_TOKEN\": \"your-netlify-token\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### VS Code\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/summary\u003e\n\n**File location:**\n- Workspace: `.vscode/mcp.json`\n- Global: `~/.vscode/mcp.json`\n\n**Requirements:** GitHub Copilot subscription with MCP enabled\n\n**Configuration:** Same as Claude Desktop\n\n\u003c/details\u003e\n\n### Cursor AI\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/summary\u003e\n\n**File location:** `~/.cursor/mcp.json`\n\n**Setup:** Navigate to Cursor Settings → MCP\n\n**Configuration:** Same as Claude Desktop\n\n\u003c/details\u003e\n\n### Windsurf IDE\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/summary\u003e\n\n**File location:** `~/.codeium/windsurf/mcp_config.json`\n\n**Setup:** Settings → Advanced Settings → Cascade\n\n**Configuration:** Same as Claude Desktop\n\n\u003c/details\u003e\n\n### Continue.dev\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/summary\u003e\n\n**File location:** `~/.continue/config.json`\n\n**Configuration (different structure):**\n```json\n{\n  \"experimental\": {\n    \"modelContextProtocolServer\": {\n      \"transport\": {\n        \"type\": \"stdio\",\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"deploy-mcp\"]\n      },\n      \"env\": {\n        \"VERCEL_TOKEN\": \"your-vercel-token\",\n        \"NETLIFY_TOKEN\": \"your-netlify-token\"\n      }\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n### Cline (VS Code Extension)\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eConfiguration\u003c/strong\u003e\u003c/summary\u003e\n\n**Natural language setup:**\n- Ask: *\"Add the deploy-mcp tool to check deployments\"*\n\n**Manual setup:**\n- MCP Servers icon → Advanced MCP Settings\n\n**Configuration:** Same as Claude Desktop\n\n\u003c/details\u003e\n\n## Deployment Status Badges\n─────────────────────────\n\nGet live deployment status badges for your repositories:\n\n### Badge Format\n\nThe deploy-mcp.io endpoint returns JSON data for shields.io. Use the shields.io endpoint wrapper:\n\n```markdown\n![Platform Deployment](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/{username}/{repository}/{platform})\n```\n\n### Examples by Platform\n\n#### Vercel Badge\n```markdown\n![Vercel](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/vercel)\n```\n\n#### Netlify Badge\n```markdown\n![Netlify](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/netlify)\n```\n\n#### Multiple Badges\n```markdown\n![Vercel](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/vercel)\n![Netlify](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/netlify)\n```\n\n### Webhook Configuration\n\nFor real-time badge updates, configure webhooks:\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eVercel Webhooks\u003c/strong\u003e (Pro/Enterprise only)\u003c/summary\u003e\n\n1. Go to your Vercel team settings\n2. Navigate to \"Webhooks\" section\n3. Click \"Create Webhook\"\n4. Configure:\n   - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/vercel`\n   - **Events**: Deployment Created, Ready, Error\n   - **Projects**: Select specific or all\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eNetlify Webhooks\u003c/strong\u003e\u003c/summary\u003e\n\n1. Go to Site Settings → Build \u0026 deploy → Deploy notifications\n2. Add notification → Outgoing webhook\n3. Configure:\n   - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/netlify`\n   - **Events**: Deploy started, succeeded, failed\n\n\u003c/details\u003e\n\n**Note:** Badges require public repositories. Private repo support coming soon.\n\n## Available Tools\n─────────────────────────\n\ndeploy-mcp provides these tools to your AI assistant:\n\n### Core Tools\n\n| Tool | Description | Example Command |\n|------|-------------|-----------------|\n| `check_deployment_status` | Get latest deployment status or history | *\"Check my deployment status\"* / *\"Show last 5 deployments\"* |\n| `watch_deployment` | Monitor deployment in real-time | *\"Watch my deployment progress\"* |\n| `compare_deployments` | Compare recent deployments | *\"Compare my last 2 deployments\"* |\n| `get_deployment_logs` | Fetch deployment logs | *\"Show me deployment logs\"* |\n| `list_projects` | List all available projects | *\"List my Vercel projects\"* / *\"Show all Netlify sites\"* |\n\n### Platform-Specific Usage\n\nCommands work across all configured platforms:\n\n```\n\"Check my Vercel deployment for my-app\"\n\"Show last 10 deployments for my-app on Vercel\"\n\"List all my Vercel projects\"\n\"Check my Netlify deployment for my-site\"\n\"Show me logs for deployment abc123 on Vercel\"\n\"Watch my Netlify deployment progress\"\n\"Show all my Netlify sites\"\n```\n\n### New Features\n\n#### List Projects\nDiscover all your projects/sites across platforms:\n```\n\"List my Vercel projects\"\n\"Show all Netlify sites\"\n\"What projects do I have on Vercel?\"\n```\n\n#### Deployment History\nView multiple recent deployments at once:\n```\n\"Show last 5 deployments for my-app\"\n\"Get deployment history for my-site\"\n\"Check last 10 deployments on Vercel\"\n```\n\nThe AI will automatically use the correct platform based on:\n1. Explicit platform mention in your command\n2. Project/site name matching\n3. Available tokens in configuration\n\n## Security\n─────────────────────────\n\n- **Local tokens only** - Your API tokens stay on your machine\n- **No telemetry** - We don't track usage or collect data\n- **Open source** - Fully auditable codebase\n- **Minimal permissions** - Only read access required\n\n## Advanced Configuration\n─────────────────────────\n\n### Environment Variables\n\nYou can also set tokens via environment variables:\n\n```bash\nexport VERCEL_TOKEN=\"your-vercel-token\"\nexport NETLIFY_TOKEN=\"your-netlify-token\"\nnpx deploy-mcp\n```\n\n### Custom Installation\n\nFor production use, install globally:\n\n```bash\nnpm install -g deploy-mcp\ndeploy-mcp\n```\n\n## Contributing\n─────────────────────────\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n### Adding New Platforms\n\n1. Implement the `BaseAdapter` interface\n2. Add platform-specific API client\n3. Update configuration documentation\n4. Add tests\n\n## License\n─────────────────────────\n\nApache 2.0 - See [LICENSE](LICENSE) for details.\n\n## Links\n─────────────────────────\n\n- [Website](https://deploy-mcp.io)\n- [npm Package](https://www.npmjs.com/package/deploy-mcp)\n- [GitHub Repository](https://github.com/alexpota/deploy-mcp)\n- [Report Issues](https://github.com/alexpota/deploy-mcp/issues)\n\n---\n\n\u003cdiv align=\"center\"\u003e\nMade with ❤️ for developers who love AI-assisted coding\n\u003c/div\u003e","funding_links":[],"categories":["📦 Other","پیاده‌سازی‌های سرور","Ueberwachung"],"sub_categories":["💻 \u003ca name=\"developer-tools\"\u003e\u003c/a\u003eابزارهای توسعه‌دهنده"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpota%2Fdeploy-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexpota%2Fdeploy-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexpota%2Fdeploy-mcp/lists"}