@shipstatic/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 shipstatic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,53 @@
+# @shipstatic/mcp
+
+MCP server for [Shipstatic](https://shipstatic.com) — deploy and manage static sites from AI agents.
+
+Works with Claude Code, Cursor, VS Code Copilot, and any MCP-compatible client.
+
+## Setup
+
+Add to your MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "shipstatic": {
+      "command": "npx",
+      "args": ["@shipstatic/mcp"],
+      "env": {
+        "SHIP_API_KEY": "ship-..."
+      }
+    }
+  }
+}
+```
+
+Get your API key at [my.shipstatic.com](https://my.shipstatic.com).
+
+## Tools
+
+### Deployments
+
+| Tool | Description |
+|------|-------------|
+| `deployments_upload` | Upload deployment from directory |
+| `deployments_list` | List all deployments |
+| `deployments_get` | Show deployment information |
+| `deployments_set` | Set deployment labels |
+| `deployments_remove` | Delete deployment permanently |
+
+### Domains
+
+| Tool | Description |
+|------|-------------|
+| `domains_set` | Create domain, link to deployment, or update labels |
+| `domains_list` | List all domains |
+| `domains_get` | Show domain information |
+| `domains_records` | Get required DNS records for a domain |
+| `domains_validate` | Check if domain name is valid and available |
+| `domains_verify` | Trigger DNS verification for external domain |
+| `domains_remove` | Delete domain permanently |
+
+## License
+
+MIT

package/dist/call.d.ts

@@ -0,0 +1,2 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function call<T>(fn: () => Promise<T>): Promise<CallToolResult>;

package/dist/call.js

@@ -0,0 +1,33 @@
+import { isShipError, ErrorType } from '@shipstatic/ship';
+export async function call(fn) {
+    try {
+        const result = await fn();
+        const text = result === undefined
+            ? 'Done.'
+            : JSON.stringify(result, null, 2);
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return handleError(error);
+    }
+}
+function handleError(error) {
+    if (isShipError(error)) {
+        let message = error.message;
+        if (error.isType(ErrorType.Authentication)) {
+            message += '\n\nHint: Set the SHIP_API_KEY environment variable in your MCP server configuration.';
+        }
+        if (error.isType(ErrorType.Validation) && error.details) {
+            message += `\n\nDetails: ${JSON.stringify(error.details)}`;
+        }
+        return {
+            content: [{ type: 'text', text: message }],
+            isError: true,
+        };
+    }
+    const fallback = error instanceof Error ? error.message : 'An unexpected error occurred';
+    return {
+        content: [{ type: 'text', text: fallback }],
+        isError: true,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+if (process.stdin.isTTY) {
+    console.error('Shipstatic MCP server v0.1.0');
+    console.error('This is a stdio server for MCP clients.\n');
+    console.error('Add to your MCP client config:\n');
+    console.error(JSON.stringify({
+        mcpServers: {
+            shipstatic: {
+                command: 'npx',
+                args: ['@shipstatic/mcp'],
+                env: { SHIP_API_KEY: 'ship-...' },
+            },
+        },
+    }, null, 2));
+    process.exit(0);
+}
+const server = createServer();
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+import Ship from '@shipstatic/ship';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function createServer(ship?: Ship): McpServer;

package/dist/server.js

@@ -0,0 +1,102 @@
+import Ship from '@shipstatic/ship';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { call } from './call.js';
+const OPEN_WORLD = { openWorldHint: true };
+const READ = { readOnlyHint: true, idempotentHint: true, ...OPEN_WORLD };
+const WRITE = { idempotentHint: true, ...OPEN_WORLD };
+const DESTRUCTIVE = { destructiveHint: true, idempotentHint: true, ...OPEN_WORLD };
+export function createServer(ship = new Ship()) {
+    const server = new McpServer({
+        name: 'shipstatic',
+        version: '0.1.0',
+    }, {
+        instructions: 'Deploy a static site to Shipstatic and link it to your domain. To deploy, call deployments_upload with the path to your build output directory. To set up a custom domain, first call domains_validate to check the name, then domains_set to link it to a deployment, then domains_records to get the required DNS records. After DNS is configured, call domains_verify to trigger verification.',
+    });
+    // Deployments
+    server.registerTool('deployments_upload', {
+        description: 'Upload deployment from directory',
+        annotations: OPEN_WORLD,
+        inputSchema: {
+            path: z.string().describe('Absolute path to directory or file to deploy'),
+            subdomain: z.string().optional().describe('Suggested subdomain'),
+            labels: z.array(z.string()).optional().describe('Labels'),
+        },
+    }, ({ path, subdomain, labels }) => call(() => ship.deployments.upload(path, { subdomain, labels, via: 'mcp' })));
+    server.registerTool('deployments_list', {
+        description: 'List all deployments',
+        annotations: READ,
+    }, () => call(() => ship.deployments.list()));
+    server.registerTool('deployments_get', {
+        description: 'Show deployment information',
+        annotations: READ,
+        inputSchema: {
+            deployment: z.string().describe('Deployment ID (e.g. "happy-cat-abc1234")'),
+        },
+    }, ({ deployment }) => call(() => ship.deployments.get(deployment)));
+    server.registerTool('deployments_set', {
+        description: 'Set deployment labels',
+        annotations: WRITE,
+        inputSchema: {
+            deployment: z.string().describe('Deployment ID'),
+            labels: z.array(z.string()).describe('New labels for the deployment'),
+        },
+    }, ({ deployment, labels }) => call(() => ship.deployments.set(deployment, { labels })));
+    server.registerTool('deployments_remove', {
+        description: 'Delete deployment permanently',
+        annotations: DESTRUCTIVE,
+        inputSchema: {
+            deployment: z.string().describe('Deployment ID to delete'),
+        },
+    }, ({ deployment }) => call(() => ship.deployments.remove(deployment)));
+    // Domains
+    server.registerTool('domains_set', {
+        description: 'Create domain, link to deployment, or update labels',
+        annotations: WRITE,
+        inputSchema: {
+            domain: z.string().describe('Domain name (e.g. "www.example.com" or "blog.example.com")'),
+            deployment: z.string().optional().describe('Deployment ID to link to this domain'),
+            labels: z.array(z.string()).optional().describe('Labels'),
+        },
+    }, ({ domain, deployment, labels }) => call(() => ship.domains.set(domain, { deployment, labels })));
+    server.registerTool('domains_list', {
+        description: 'List all domains',
+        annotations: READ,
+    }, () => call(() => ship.domains.list()));
+    server.registerTool('domains_get', {
+        description: 'Show domain information',
+        annotations: READ,
+        inputSchema: {
+            domain: z.string().describe('Domain name'),
+        },
+    }, ({ domain }) => call(() => ship.domains.get(domain)));
+    server.registerTool('domains_records', {
+        description: 'Get required DNS records for a domain',
+        annotations: READ,
+        inputSchema: {
+            domain: z.string().describe('Domain name'),
+        },
+    }, ({ domain }) => call(() => ship.domains.records(domain)));
+    server.registerTool('domains_validate', {
+        description: 'Check if domain name is valid and available',
+        annotations: READ,
+        inputSchema: {
+            domain: z.string().describe('Domain name to validate'),
+        },
+    }, ({ domain }) => call(() => ship.domains.validate(domain)));
+    server.registerTool('domains_verify', {
+        description: 'Trigger DNS verification for external domain',
+        annotations: WRITE,
+        inputSchema: {
+            domain: z.string().describe('Domain name'),
+        },
+    }, ({ domain }) => call(() => ship.domains.verify(domain)));
+    server.registerTool('domains_remove', {
+        description: 'Delete domain permanently',
+        annotations: DESTRUCTIVE,
+        inputSchema: {
+            domain: z.string().describe('Domain name to delete'),
+        },
+    }, ({ domain }) => call(() => ship.domains.remove(domain)));
+    return server;
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@shipstatic/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Shipstatic — deploy and manage static sites from AI agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "shipstatic-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "shipstatic",
+    "model-context-protocol",
+    "ai",
+    "deploy"
+  ],
+  "homepage": "https://github.com/shipstatic/mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shipstatic/mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shipstatic/mcp/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "author": "ShipStatic",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.0",
+    "@shipstatic/ship": "^0.7.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@shipstatic/types": "^0.7.1",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest"
+  }
+}