mcplane 0.1.0

package/dist/submissions.js

@@ -0,0 +1,126 @@
+/**
+ * Your submissions, kept in .mcplane/submissions.json (gitignored: it holds
+ * the private tokens that update your Review Times reports), and logged to
+ * Review Times so every wait counts toward the public numbers.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { ensureLocalDir } from './manifest.js';
+import { markLive, takeSnapshot } from './drift.js';
+const RT = process.env.MCPLANE_REVIEWTIMES_URL ?? 'https://reviewtimes.fyi';
+const DIR = '.mcplane';
+const FILE = `${DIR}/submissions.json`;
+/** Review Times store slugs. Grok and Docker are read straight from their GitHub queues, so they aren't reported twice. */
+const RT_SLUG = {
+    chatgpt: 'chatgpt',
+    'claude-connectors': 'claude-connectors',
+    'claude-plugins': 'claude-plugins',
+    cursor: 'cursor',
+    muse: 'muse',
+};
+const TRACKED_FROM_GITHUB = ['grok', 'docker'];
+export async function load(dir = process.cwd()) {
+    try {
+        return JSON.parse(await readFile(resolve(dir, FILE), 'utf8'));
+    }
+    catch {
+        return [];
+    }
+}
+async function save(list, dir = process.cwd()) {
+    await ensureLocalDir(dir);
+    await writeFile(resolve(dir, FILE), JSON.stringify(list, null, 2) + '\n');
+}
+const today = () => new Date().toISOString().slice(0, 10);
+/** What identifies this listing to Review Times' directory watch, so the report can close itself. */
+function listingRef(m, store, appId) {
+    if (store === 'chatgpt')
+        return appId;
+    if (store === 'claude-connectors' || store === 'muse')
+        return m.server.url;
+    if (store === 'claude-plugins' || store === 'cursor')
+        return m.repository;
+    return undefined;
+}
+export async function recordSubmitted(m, store, opts, dir = process.cwd()) {
+    const s = { store, kind: opts.kind ?? 'new', version: opts.version, submittedOn: opts.date ?? today(), status: 'waiting' };
+    let note;
+    const slug = RT_SLUG[store];
+    if (TRACKED_FROM_GITHUB.includes(store)) {
+        note = 'Review Times reads this store’s review queue from GitHub, so it counts your pull request already.';
+    }
+    else if (!slug) {
+        s.status = 'approved';
+        s.decidedOn = s.submittedOn;
+        note = 'This store publishes without a review, so it counts as live from today.';
+    }
+    else if (opts.share === false) {
+        note = 'Kept locally only (--private).';
+    }
+    else {
+        const res = await fetch(`${RT}/api/v1/reports`, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json', 'user-agent': 'mcplane' },
+            body: JSON.stringify({ store: slug, submitted_on: s.submittedOn, status: 'waiting', kind: s.kind, listing_ref: listingRef(m, store, opts.appId) }),
+        });
+        const body = (await res.json().catch(() => ({})));
+        if (!res.ok || !body.token)
+            throw new Error(`Review Times didn't take the report: ${body.error ?? `HTTP ${res.status}`}`);
+        s.reviewTimes = { token: body.token, shareUrl: body.share_url ?? null };
+        note = `Logged to Review Times (anonymous). Public page: ${body.share_url ?? `${RT}/${slug}`}`;
+    }
+    const list = await load(dir);
+    list.push(s);
+    await save(list, dir);
+    // What the store is reviewing, so "mcplane drift" can tell when the live server moves away from it.
+    await takeSnapshot(m, store, { version: opts.version, state: s.status === 'approved' ? 'live' : 'submitted', token: opts.token }, dir).catch(() => null);
+    return { submission: s, note };
+}
+export async function recordDecision(store, outcome, date, dir = process.cwd()) {
+    const list = await load(dir);
+    const s = [...list].reverse().find((x) => x.store === store && x.status === 'waiting');
+    if (!s)
+        throw new Error(`No waiting ${store} submission recorded. Run "mcplane submitted ${store}" first.`);
+    s.status = outcome;
+    s.decidedOn = date ?? today();
+    if (s.reviewTimes) {
+        const res = await fetch(`${RT}/api/v1/reports/${s.reviewTimes.token}`, {
+            method: 'PATCH',
+            headers: { 'content-type': 'application/json', 'user-agent': 'mcplane' },
+            body: JSON.stringify({ status: outcome, decided_on: s.decidedOn }),
+        });
+        if (!res.ok)
+            throw new Error(`Review Times didn't take the update: HTTP ${res.status}`);
+    }
+    await save(list, dir);
+    if (outcome === 'approved')
+        await markLive(store, dir);
+    return s;
+}
+/** Refreshes each waiting submission from Review Times (the directory watch may have closed it) and adds the store's typical wait. */
+export async function status(dir = process.cwd()) {
+    const list = await load(dir);
+    const verdicts = new Map();
+    for (const s of list) {
+        if (s.status === 'waiting' && s.reviewTimes) {
+            const r = await fetch(`${RT}/api/v1/reports/${s.reviewTimes.token}`, { headers: { 'user-agent': 'mcplane' } }).catch(() => null);
+            const b = r?.ok ? (await r.json()) : null;
+            if (b?.status && b.status !== 'waiting') {
+                s.status = b.status;
+                s.decidedOn = b.decided_on ?? undefined;
+            }
+        }
+        const slug = RT_SLUG[s.store] ?? (s.store === 'docker' ? 'docker-mcp' : s.store === 'grok' ? 'grok' : null);
+        if (slug && !verdicts.has(slug)) {
+            const r = await fetch(`${RT}/api/v1/stores/${slug}`, { headers: { 'user-agent': 'mcplane' } }).catch(() => null);
+            verdicts.set(slug, r?.ok ? ((await r.json()).verdict ?? null) : null);
+        }
+    }
+    await save(list, dir);
+    const dayMs = 86_400_000;
+    return list.map((s) => {
+        const end = s.decidedOn ? Date.parse(s.decidedOn) : Date.now();
+        const slug = RT_SLUG[s.store] ?? (s.store === 'docker' ? 'docker-mcp' : s.store === 'grok' ? 'grok' : null);
+        return { submission: s, days: Math.max(0, Math.floor((end - Date.parse(s.submittedOn)) / dayMs)), typical: slug ? (verdicts.get(slug) ?? null) : null };
+    });
+}

package/dist/types.js

@@ -0,0 +1,15 @@
+export const STORE_NAMES = {
+    'mcp-registry': 'Official MCP Registry',
+    chatgpt: 'ChatGPT',
+    'claude-connectors': 'Claude connectors',
+    'claude-plugins': 'Claude plugins',
+    cursor: 'Cursor Marketplace',
+    grok: 'Grok plugins',
+    docker: 'Docker MCP Catalog',
+    muse: 'Muse connectors',
+    smithery: 'Smithery',
+    glama: 'Glama',
+    cline: 'Cline MCP Marketplace',
+    lobehub: 'LobeHub Market',
+    'awesome-mcp-servers': 'awesome-mcp-servers',
+};

package/dist/version.js

@@ -0,0 +1 @@
+export const VERSION = '0.1.0';

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "mcplane",
+  "version": "0.1.0",
+  "description": "fastlane for MCP servers: preflight against every store's rejection causes, publish where you can, prepare the rest, track every review.",
+  "type": "module",
+  "bin": {
+    "mcplane": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "schema.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "dev": "tsx src/cli.ts",
+    "typecheck": "tsc --noEmit -p .",
+    "test": "node --import tsx --test test/*.test.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "chatgpt",
+    "claude",
+    "cursor",
+    "plugin",
+    "connector",
+    "submission",
+    "fastlane"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^22.20.4",
+    "tsx": "^4.23.15",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.31.0",
+    "zod": "^4.6.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stevysmith/mcplane.git"
+  },
+  "homepage": "https://github.com/stevysmith/mcplane#readme",
+  "bugs": {
+    "url": "https://github.com/stevysmith/mcplane/issues"
+  },
+  "author": "Steve Smith",
+  "mcpName": "io.github.stevysmith/mcplane"
+}

package/schema.json

@@ -0,0 +1,283 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://unpkg.com/mcplane/schema.json",
+  "title": "mcplane.json",
+  "description": "One description of an MCP server and its listings, used by mcplane to check, pack, publish and track store submissions.",
+  "type": "object",
+  "required": [
+    "name",
+    "title",
+    "server"
+  ],
+  "additionalProperties": false,
+  "$defs": {
+    "store": {
+      "enum": [
+        "mcp-registry",
+        "chatgpt",
+        "claude-connectors",
+        "claude-plugins",
+        "cursor",
+        "grok",
+        "docker",
+        "muse",
+        "smithery",
+        "glama",
+        "cline",
+        "lobehub",
+        "awesome-mcp-servers"
+      ]
+    },
+    "url": {
+      "type": "string",
+      "format": "uri"
+    }
+  },
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "description": "Short machine name, lowercase with hyphens. Used for plugin entries and install links."
+    },
+    "title": {
+      "type": "string",
+      "description": "Display name in every store."
+    },
+    "subtitle": {
+      "type": "string",
+      "maxLength": 30,
+      "description": "ChatGPT's subtitle (30 characters)."
+    },
+    "oneLiner": {
+      "type": "string",
+      "description": "One sentence: what it does. Claude's one-liner, the registry and plugin descriptions start from it."
+    },
+    "description": {
+      "type": "string",
+      "description": "The long description."
+    },
+    "category": {
+      "type": "string",
+      "description": "ChatGPT category, e.g. DEVELOPER_TOOLS, PRODUCTIVITY, BUSINESS."
+    },
+    "server": {
+      "type": "object",
+      "required": [
+        "url"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "$ref": "#/$defs/url",
+          "description": "Your streamable HTTP endpoint, exactly as reviewers will add it."
+        },
+        "auth": {
+          "enum": [
+            "none",
+            "oauth"
+          ]
+        }
+      }
+    },
+    "repository": {
+      "$ref": "#/$defs/url",
+      "description": "Public GitHub repository for plugin stores (Claude plugins, Cursor, Grok)."
+    },
+    "author": {
+      "type": "object",
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "url": {
+          "$ref": "#/$defs/url"
+        }
+      }
+    },
+    "links": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "website": {
+          "$ref": "#/$defs/url"
+        },
+        "support": {
+          "$ref": "#/$defs/url"
+        },
+        "privacy": {
+          "$ref": "#/$defs/url"
+        },
+        "terms": {
+          "$ref": "#/$defs/url"
+        },
+        "docs": {
+          "$ref": "#/$defs/url"
+        }
+      }
+    },
+    "icon": {
+      "$ref": "#/$defs/url",
+      "description": "A direct link to a square PNG, 512px or larger. Not a page, not a favicon."
+    },
+    "prompts": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "Example prompts shown on listings."
+    },
+    "stores": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/store"
+      },
+      "uniqueItems": true,
+      "description": "Where you list. Leave out to check against every store."
+    },
+    "tests": {
+      "type": "object",
+      "description": "Review test cases. ChatGPT wants exactly 5 positive and 3 negative.",
+      "additionalProperties": false,
+      "properties": {
+        "positive": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "scenario",
+              "prompt",
+              "tools",
+              "expected"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "scenario": {
+                "type": "string"
+              },
+              "prompt": {
+                "type": "string"
+              },
+              "tools": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "expected": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "negative": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "scenario",
+              "prompt"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "scenario": {
+                "type": "string"
+              },
+              "prompt": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "justifications": {
+      "type": "object",
+      "description": "Your own ChatGPT hint justifications per tool name. They replace mcplane's drafts. 200 characters each.",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "readOnly": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "openWorld": {
+            "type": "string",
+            "maxLength": 200
+          },
+          "destructive": {
+            "type": "string",
+            "maxLength": 200
+          }
+        }
+      }
+    },
+    "version": {
+      "type": "string",
+      "description": "Your server's version, for the MCP Registry and your records."
+    },
+    "registry": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Reverse-DNS name. Defaults to io.github.<owner>/<name>."
+        },
+        "description": {
+          "type": "string",
+          "maxLength": 100
+        },
+        "file": {
+          "type": "string",
+          "description": "Where to write server.json."
+        }
+      }
+    },
+    "grok": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "description": {
+          "type": "string"
+        },
+        "category": {
+          "type": "string"
+        },
+        "keywords": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "domains": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "lanes": {
+      "type": "object",
+      "description": "Named workflows run with \"mcplane <lane>\". Each step is a command without \"mcplane\"; prefix \"?\" for optional, \"handoff:\" for a step only a person can do.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "reviewerAccess": {
+      "type": "string",
+      "description": "How reviewers get in, for servers behind sign-in. Say where credentials live; never put a password here."
+    }
+  }
+}