more vibes

Author: dannyvassallo

README.md

@@ -1,16 +1,83 @@
-# React + Vite
+# mini-mcp-registry
 
-This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
+A lightweight, self-hosted MCP registry that exposes a filtered subset of the [official MCP registry](https://registry.modelcontextprotocol.io). Deployable to GitHub Pages as a static site.
 
-Currently, two official plugins are available:
+## Copilot MCP Registry URL
 
-- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
-- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
+```
+https://vydia.github.io/mini-mcp-registry/allowed-servers
+```
 
-## React Compiler
+This endpoint returns only the **official Figma MCP server** (`com.figma.mcp/mcp`) in standard MCP registry format.
 
-The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).
+## Running locally
 
-## Expanding the ESLint configuration
+```bash
+npm install
+npm run dev
+```
 
-If you are developing a production application, we recommend using TypeScript with type-aware lint rules enabled. Check out the [TS template](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) for information on how to integrate TypeScript and [`typescript-eslint`](https://typescript-eslint.io) in your project.
+The UI will be available at `http://localhost:5173`. It fetches live from the official registry and filters results by preset.
+
+To preview the production build locally:
+
+```bash
+npm run build
+npm run preview
+```
+
+## How the registry endpoint works
+
+At build time, `scripts/build-registry.mjs` fetches the official Figma server entry from the MCP registry API and writes it to `public/allowed-servers`. Vite copies `public/` into `dist/` unchanged, so the file is served as a static JSON response at `/allowed-servers`.
+
+To regenerate the file manually without a full build:
+
+```bash
+node scripts/build-registry.mjs
+```
+
+## Adding or changing allowed servers
+
+Edit `scripts/build-registry.mjs`. The relevant section is:
+
+```js
+// Fetch a specific server by name + version
+const url = 'https://registry.modelcontextprotocol.io/v0.1/servers/com.figma.mcp%2Fmcp/versions/latest';
+```
+
+To allow multiple servers, fetch each one and push them into the `servers` array before writing the file:
+
+```js
+const figma = await fetchServer('com.figma.mcp%2Fmcp');
+const github = await fetchServer('com.github.mcp%2Fgithub');
+
+const payload = {
+  servers: [figma, github],
+  metadata: { count: 2, nextCursor: null },
+};
+```
+
+Server names come from the [official registry](https://registry.modelcontextprotocol.io/docs). Use `%2F` to encode the `/` in the server name for the URL.
+
+## Adding UI filter presets
+
+Edit `src/presets.js`:
+
+```js
+{
+  id: 'linear',
+  label: 'Linear',
+  search: 'linear',
+  description: 'MCP servers that integrate with Linear',
+},
+```
+
+The `search` value is passed to the registry's `?search=` query param (substring match on server name).
+
+## Deployment
+
+Deploys automatically to GitHub Pages on every push to `main` via `.github/workflows/deploy.yml`.
+
+**One-time setup:** In the GitHub repo go to **Settings → Pages → Source** and select **GitHub Actions**.
+
+The build step (`npm run build`) runs `scripts/build-registry.mjs` first to fetch fresh server data, then builds the Vite app.

public/allowed-servers

@@ -0,0 +1,35 @@
+{
+  "servers": [
+    {
+      "server": {
+        "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+        "name": "com.figma.mcp/mcp",
+        "description": "The Figma MCP server brings Figma design context directly into your AI workflow.",
+        "title": "Figma MCP Server",
+        "repository": {
+          "url": "https://github.com/figma/mcp-server-guide",
+          "source": "github"
+        },
+        "version": "1.0.3",
+        "remotes": [
+          {
+            "type": "streamable-http",
+            "url": "https://mcp.figma.com/mcp"
+          }
+        ]
+      },
+      "_meta": {
+        "io.modelcontextprotocol.registry/official": {
+          "status": "active",
+          "publishedAt": "2025-10-16T17:40:56.949472Z",
+          "updatedAt": "2025-10-16T17:40:56.949472Z",
+          "isLatest": true
+        }
+      }
+    }
+  ],
+  "metadata": {
+    "count": 1,
+    "nextCursor": null
+  }
+}

scripts/build-registry.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-// Fetches filtered MCP servers from the v0.1 registry API (server-side search + latest only)
-// and writes static JSON files to public/ for deployment.
+// Fetches the official Figma MCP server from the registry and writes
+// public/allowed-servers — a Copilot-compatible MCP registry endpoint.
 
 import { writeFileSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
@@ -9,59 +9,26 @@ import { fileURLToPath } from 'url';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const OUT_DIR = join(__dirname, '..', 'public');
 
-const PRESETS = [
-  { id: 'figma',    search: 'figma' },
-  { id: 'github',   search: 'github' },
-  { id: 'notion',   search: 'notion' },
-  { id: 'slack',    search: 'slack' },
-  { id: 'postgres', search: 'postgres' },
-];
-
-async function fetchPage(url, retries = 5) {
-  for (let attempt = 0; attempt <= retries; attempt++) {
-    const res = await fetch(url);
-    if (res.status === 429) {
-      await new Promise((r) => setTimeout(r, (attempt + 1) * 2000));
-      continue;
-    }
-    if (!res.ok) throw new Error(`Registry API error: ${res.status}`);
-    return res.json();
-  }
-  throw new Error('Too many retries due to rate limiting');
-}
-
-async function fetchSearch(search) {
-  const results = [];
-  let cursor = null;
-
-  do {
-    const url = new URL('https://registry.modelcontextprotocol.io/v0.1/servers');
-    url.searchParams.set('search', search);
-    url.searchParams.set('version', 'latest');
-    url.searchParams.set('limit', '100');
-    if (cursor) url.searchParams.set('cursor', cursor);
-
-    const data = await fetchPage(url.toString());
-    results.push(...(data.servers ?? []));
-    cursor = data.metadata?.nextCursor ?? null;
-  } while (cursor);
-
-  return results;
+async function fetchFigmaOfficial() {
+  const url = 'https://registry.modelcontextprotocol.io/v0.1/servers/com.figma.mcp%2Fmcp/versions/latest';
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Registry API error: ${res.status}`);
+  return res.json();
 }
 
 mkdirSync(OUT_DIR, { recursive: true });
 
-for (const preset of PRESETS) {
-  process.stdout.write(`  Fetching "${preset.search}"...`);
-  const servers = await fetchSearch(preset.search);
+console.log('Fetching official Figma MCP server...');
+const entry = await fetchFigmaOfficial();
 
-  const payload = {
-    servers,
-    metadata: { count: servers.length, filter: preset.id, generatedAt: new Date().toISOString() },
-  };
-
-  writeFileSync(join(OUT_DIR, `${preset.id}.json`), JSON.stringify(payload, null, 2));
-  console.log(` ✓ ${servers.length} server(s) → public/${preset.id}.json`);
-}
+const payload = {
+  servers: [entry],
+  metadata: {
+    count: 1,
+    nextCursor: null,
+  },
+};
 
-console.log('Done.');
+const outPath = join(OUT_DIR, 'allowed-servers');
+writeFileSync(outPath, JSON.stringify(payload, null, 2));
+console.log('✓ public/allowed-servers written');