@velixir/mcp 0.1.0

package/README.md

@@ -0,0 +1,56 @@
+# @velixir/mcp
+
+Deploy web apps in **any language** to [Velixir](https://velixir.net), the European cloud, straight from your AI agent. One tool, `deploy`: point it at a source directory, and it packs the code, builds it with no Dockerfile, and returns a live URL plus a claim link the human opens to keep the app on a free, card-free account. No Velixir account is needed to deploy.
+
+## Why
+
+The agent generated a real backend. Now it has to run somewhere. Velixir runs real apps in Node, Python, Go, Ruby, PHP, Java, Elixir, Rust, .NET, and more, with managed Postgres and Valkey, in the EU, with no egress fees. This server lets an agent one-shot deploy the app it just built, then hand the user a link to keep it.
+
+## Use it
+
+Zero install, run with npx:
+
+```bash
+npx -y @velixir/mcp
+```
+
+### Claude Desktop / Claude Code
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "velixir": {
+      "command": "npx",
+      "args": ["-y", "@velixir/mcp"]
+    }
+  }
+}
+```
+
+### Cursor / Cline / Windsurf
+
+Point the editor's MCP settings at the same command (`npx -y @velixir/mcp`).
+
+## The `deploy` tool
+
+| Input | Required | Description |
+| --- | --- | --- |
+| `directory` | yes | Absolute path to the app's source directory. |
+| `name` | no | Short name for the app; becomes part of the URL. |
+| `language` | no | node, python, go, ruby, php, java, elixir, rust, dotnet, deno, fsharp. Auto-detected if omitted. |
+
+It returns the live URL, a claim URL (give this to the user), when the claim window closes, and a status URL to poll.
+
+`node_modules`, `.git`, build output, and caches are skipped automatically. Nixpacks reinstalls dependencies and builds from source.
+
+## Config
+
+| Env var | Default | Description |
+| --- | --- | --- |
+| `VELIXIR_API_URL` | `https://velixir.net` | Override for staging or self-host. |
+
+## Requirements
+
+Node.js 18 or newer.

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@velixir/mcp",
+  "version": "0.1.0",
+  "description": "Deploy web apps in any language to Velixir (the European cloud) straight from your AI agent. One tool: point it at a directory, get back a live URL and a claim link.",
+  "type": "module",
+  "bin": {
+    "velixir-mcp": "src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "velixir",
+    "deploy",
+    "paas",
+    "agent"
+  ],
+  "license": "MIT",
+  "homepage": "https://velixir.ai",
+  "publishConfig": { "access": "public" },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.0",
+    "tar": "^7.4.3",
+    "zod": "^3.23.8"
+  }
+}

package/src/index.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+// Velixir MCP server. Exposes one tool, `deploy`, that packs a source directory,
+// posts it to Velixir's account-less deploy endpoint (POST /api/v1/deploy), and
+// returns a live URL plus a single-use claim link the human opens to keep the app
+// on a free, card-free account. No Velixir account is needed to deploy.
+//
+// Zero setup: run with `npx -y @velixir/mcp`. Point VELIXIR_API_URL at a different
+// host for staging/self-host (default https://velixir.net).
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { create as tarCreate } from "tar";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+
+const API_URL = (process.env.VELIXIR_API_URL || "https://velixir.net").replace(/\/+$/, "");
+
+// Directory names never worth uploading: build output, dependencies, VCS, caches.
+// Nixpacks reinstalls dependencies and rebuilds from source, so shipping these
+// would only bloat the upload.
+const IGNORED_DIRS = new Set([
+  "node_modules", ".git", ".hg", ".svn", ".next", ".nuxt", "dist", "build",
+  "out", ".turbo", ".cache", ".parcel-cache", "target", "bin", "obj",
+  ".venv", "venv", "__pycache__", ".pytest_cache", ".gradle", ".idea", ".vs",
+]);
+
+async function tarballOf(dir) {
+  const stream = tarCreate(
+    {
+      gzip: true,
+      cwd: dir,
+      portable: true,
+      filter: (entryPath) => {
+        const segments = entryPath.split(/[\\/]/).filter(Boolean);
+        return !segments.some((seg) => IGNORED_DIRS.has(seg));
+      },
+    },
+    ["."],
+  );
+  const chunks = [];
+  for await (const chunk of stream) chunks.push(chunk);
+  return Buffer.concat(chunks);
+}
+
+const server = new McpServer({ name: "velixir", version: "0.1.0" });
+
+server.tool(
+  "deploy",
+  "Deploy a web app in ANY language (Node, Python, Go, Ruby, PHP, Java, Elixir, Rust, .NET, and more) to Velixir, the European cloud. Packs the given source directory, builds it with no Dockerfile, and runs it in the EU. Returns a live URL plus a claim link the human opens to keep the app on a free, card-free account. No Velixir account is needed to deploy. Use this when the user wants to publish, host, or deploy an app you generated.",
+  {
+    directory: z
+      .string()
+      .describe("Absolute path to the app's source directory to deploy (the folder that contains its package.json / requirements.txt / go.mod / etc)."),
+    name: z
+      .string()
+      .optional()
+      .describe("A short name for the app; becomes part of the URL. Letters and numbers work best."),
+    language: z
+      .string()
+      .optional()
+      .describe("Primary language (node, python, go, ruby, php, java, elixir, rust, dotnet, deno, fsharp). Auto-detected from the source if omitted."),
+  },
+  async ({ directory, name, language }) => {
+    const dir = path.resolve(directory);
+    const stat = await fs.stat(dir).catch(() => null);
+    if (!stat || !stat.isDirectory()) {
+      return { isError: true, content: [{ type: "text", text: `Not a directory: ${dir}` }] };
+    }
+
+    let tar;
+    try {
+      tar = await tarballOf(dir);
+    } catch (err) {
+      return { isError: true, content: [{ type: "text", text: `Could not package the source: ${err?.message ?? err}` }] };
+    }
+
+    const form = new FormData();
+    form.append("source", new Blob([tar], { type: "application/gzip" }), "source.tar.gz");
+    if (name) form.append("name", name);
+    if (language) form.append("language", language);
+
+    let res, body;
+    try {
+      res = await fetch(`${API_URL}/api/v1/deploy`, { method: "POST", body: form });
+      body = await res.text();
+    } catch (err) {
+      return { isError: true, content: [{ type: "text", text: `Could not reach Velixir at ${API_URL}: ${err?.message ?? err}` }] };
+    }
+
+    if (!res.ok) {
+      return { isError: true, content: [{ type: "text", text: `Deploy failed (HTTP ${res.status}): ${body}` }] };
+    }
+
+    let data;
+    try { data = JSON.parse(body); } catch { data = {}; }
+
+    const lines = [
+      "Your app is building on Velixir now.",
+      data.app_url ? `Live URL: ${data.app_url}` : null,
+      data.claim_url
+        ? `Claim URL: ${data.claim_url}\n(Give this to the user. Opening it keeps the app on a free, card-free Velixir account; unclaimed apps are removed after a short window.)`
+        : null,
+      data.claim_expires_at ? `Claim before: ${data.claim_expires_at}` : null,
+      data.status_url ? `Deployment status: ${data.status_url}` : null,
+    ].filter(Boolean);
+
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+  },
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);