vp0-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VP0
+
+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,61 @@
+# vp0-mcp
+
+A free [Model Context Protocol](https://modelcontextprotocol.io) server for **VP0** — search and import iOS app design starters (Expo React Native) straight into your AI builder, with no copy-pasting and no API key.
+
+Once added, you can just say:
+
+> "Find a fitness dashboard design on VP0 and build it in my app."
+
+…and your AI tool will search VP0, pull the complete source + dependencies + integration steps, and scaffold it into your Expo project.
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `search_vp0_designs(query, limit?)` | Search the free VP0 library; returns matching designs (name, slug, import link). |
+| `get_vp0_design(slug)` | Fetch one design's complete manifest — inline source files, dependencies, the exact `npx expo install` command, and step-by-step `aiInstructions`. |
+
+Only approved, public designs are exposed (the same surface as `https://vp0.com/source/:slug`). The design link is the key — there is no secret API key.
+
+## Install
+
+**Claude Code**
+```bash
+claude mcp add vp0 -- npx -y vp0-mcp
+```
+
+**Cursor / Windsurf** — add to your MCP config (`~/.cursor/mcp.json` or the editor's MCP settings):
+```json
+{
+  "mcpServers": {
+    "vp0": { "command": "npx", "args": ["-y", "vp0-mcp"] }
+  }
+}
+```
+
+Point at a different backend (e.g. local dev) with `VP0_API_URL`:
+```json
+{
+  "mcpServers": {
+    "vp0": { "command": "npx", "args": ["-y", "vp0-mcp"], "env": { "VP0_API_URL": "http://localhost:3000" } }
+  }
+}
+```
+
+## Publishing (maintainers)
+
+```bash
+cd mcp
+npm login          # one-time
+npm publish        # prepublishOnly runs the build; publishConfig makes it public
+```
+
+## Develop
+
+```bash
+npm install
+npm run build      # tsc → dist/
+npm start          # runs the stdio server
+```
+
+VP0 is a free, forever-free library for the future of vibe-coded mobile apps.

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/**
+ * VP0 MCP server — lets an AI builder (Claude Code, Cursor, Windsurf, …) search
+ * VP0's free iOS-app-design library and pull a design's complete, import-ready
+ * source without the user ever copy-pasting a link.
+ *
+ * Two tools:
+ *   search_vp0_designs(query)  → matching designs (name, slug, import link)
+ *   get_vp0_design(slug)       → the full manifest: inline files, deps, the
+ *                                exact install command, and step-by-step
+ *                                integration instructions (manifest.aiInstructions)
+ *
+ * No API key. The design link is the key, and only approved/public designs are
+ * exposed — same surface as https://vp0.com/source/:slug.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const API_BASE = (process.env.VP0_API_URL || "https://api.vp0.com").replace(/\/+$/, "");
+async function api(path) {
+    const res = await fetch(`${API_BASE}${path}`, {
+        headers: { Accept: "application/json", "User-Agent": "vp0-mcp" },
+    });
+    if (!res.ok) {
+        throw new Error(`VP0 API responded ${res.status} for ${path}`);
+    }
+    return (await res.json());
+}
+function asText(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+const server = new McpServer({ name: "vp0", version: "0.1.0" });
+server.tool("search_vp0_designs", "Search VP0's free library of iOS app design starters (Expo React Native). " +
+    "Returns matching designs with their slug and import link. " +
+    "Call get_vp0_design with a slug to fetch the full, import-ready source.", {
+    query: z.string().describe("keywords, e.g. 'fitness dark dashboard' or 'onboarding'"),
+    limit: z.number().int().min(1).max(30).optional().describe("max results (default 12)"),
+}, async ({ query, limit }) => {
+    const data = await api(`/contents?search=${encodeURIComponent(query)}&limit=${limit ?? 12}`);
+    const designs = (data.data ?? []).map((c) => ({
+        name: c.name,
+        slug: c.slug,
+        description: c.description ?? null,
+        importUrl: `https://vp0.com/source/${c.slug}`,
+    }));
+    return asText({ count: designs.length, designs });
+});
+server.tool("get_vp0_design", "Fetch the complete import-ready manifest for one VP0 design by slug: inline " +
+    "source file(s), dependencies, the exact install command, and ordered " +
+    "integration steps. Follow manifest.aiInstructions verbatim to add the " +
+    "design to the user's Expo React Native project.", {
+    slug: z.string().describe("the design slug, e.g. 'gym-fits-design'"),
+}, async ({ slug }) => {
+    const manifest = await api(`/designs/${encodeURIComponent(slug)}/manifest`);
+    return asText(manifest);
+});
+async function main() {
+    await server.connect(new StdioServerTransport());
+    // Log to stderr — stdout is reserved for the MCP protocol.
+    console.error(`vp0-mcp ready (API: ${API_BASE})`);
+}
+main().catch((err) => {
+    console.error("vp0-mcp failed to start:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "vp0-mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol server for VP0 — search and import free iOS app design starters straight into your AI builder (Claude Code, Cursor, Windsurf).",
+  "type": "module",
+  "bin": {
+    "vp0-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VP0COM/vp0com-official-site-2026.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://vp0.com",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "vp0",
+    "react-native",
+    "expo",
+    "ios",
+    "ai"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0"
+  }
+}