@cmdforge/gen-apic-mp 0.0.1 → 0.0.3

package/dist/shared/types.d.ts

@@ -0,0 +1,139 @@
+export type WorkspaceInfo = {
+    serviceName: string;
+    region: string;
+    workspaceName: string;
+};
+export type PortalConfig = {
+    dataApiHostName: string;
+    title: string;
+    capabilities: [];
+};
+export type JsonObject = Record<string, unknown>;
+export type McpAssetItem = {
+    name: string;
+    title: string;
+    summary: string;
+    description: string;
+    kind: 'mcp';
+    lifecycleStage: string;
+    externalDocumentation: [];
+    contacts: [];
+    customProperties: JsonObject;
+    lastUpdated: string;
+};
+export type PluginAssetItem = {
+    name: string;
+    title: string;
+    description: string;
+    kind: 'plugin';
+    lifecycleStage: string;
+    externalDocumentation: [];
+    contacts: [];
+    customProperties: JsonObject;
+    lastUpdated: string;
+};
+export type ApiAssetItem = McpAssetItem | PluginAssetItem;
+export type PluginMcpResource = {
+    resourceId: string;
+    title: string;
+    summary: string;
+    kind: 'mcp';
+};
+export type PluginResource = PluginMcpResource;
+export type PluginAsset = {
+    name: string;
+    title: string;
+    summary: string;
+    description: string;
+    version: string;
+    resources: PluginResource[];
+    customProperties?: JsonObject;
+};
+export type PagedResponse<T> = {
+    value: T[];
+    nextLink?: string;
+};
+export type PlaneType = 'portal' | 'data';
+export type V0HttpTransport = {
+    transport?: 'http' | 'https' | 'sse' | 'streamable-http';
+    type?: 'http' | 'https' | 'sse' | 'streamable-http';
+    url: string;
+    headers?: Record<string, string>;
+};
+export type V0StdioTransport = {
+    transport?: 'stdio';
+    type?: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+};
+export type V0ServerJsonEntry = V0HttpTransport | V0StdioTransport | JsonObject;
+export type ServerJson = {
+    mcpServers?: Record<string, V0ServerJsonEntry>;
+    servers?: Record<string, V0ServerJsonEntry>;
+};
+export type V0ServerEntryResponse = V0ServerJsonEntry;
+export type McpServerStdio = {
+    transport: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+};
+export type McpServerHttp = {
+    transport: 'http' | 'sse';
+    url: string;
+    headers?: Record<string, string>;
+};
+export type McpServer = (McpServerStdio | McpServerHttp) & JsonObject;
+export type McpJson = {
+    mcpServers: Record<string, McpServer>;
+};
+export type GenerateMcpServerOptions = {
+    metaKeys?: string[];
+};
+export type PluginJson = {
+    name: string;
+    description: string;
+    version: string;
+    mcpServers?: string;
+    skills?: string[];
+};
+export type MarketplacePluginJson = {
+    name: string;
+    version: string;
+    description: string;
+    source: string | {
+        source: string;
+        repo: string;
+        path: string;
+    };
+    author?: {
+        name: string;
+        url: string;
+    };
+    homepage?: string;
+    keywords?: string[];
+    license?: string;
+    repository?: string;
+    skills: string[];
+};
+export type MarketplaceJson = {
+    name: string;
+    metadata: {
+        description: string;
+        version: string;
+    };
+    owner: {
+        name: string;
+        email?: string;
+    };
+    plugins: MarketplacePluginJson[];
+};
+export type McpAsset = McpAssetItem & {
+    version?: string;
+    serverJson?: ServerJson;
+    customProperties: JsonObject;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/shared/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,10 +1,44 @@
 {
   "name": "@cmdforge/gen-apic-mp",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @cmdforge/gen-apic-mp",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "description": "Generate a marketplace.zip containing the contents of an expected marketplace.git repository for the given Azure API Center portal.",
+  "version": "0.0.3",
+  "license": "MIT",
+  "type": "module",
+  "author": {
+    "name": "Fluttershy",
+    "url": "https://github.com/Fluttershy"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cmdforge/gen-apic-mp.git"
+  },
+  "bin": {
+    "gen-apic-mp": "./dist/server/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/shared/index.d.ts",
+      "import": "./dist/shared/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test --import tsx src/**/*.test.ts"
+  },
+  "dependencies": {
+    "commander": "15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.3",
+    "typescript": "^5.8.0",
+    "tsx": "4.22.4"
+  },
+  "allowScripts": {
+    "esbuild": true,
+    "fsevents": true
+  }
 }

package/src/server/cli.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { Command, Option } from "commander";
+import { generateMarketplaceGit, resolveUnpackDirectory } from "./marketplace.js";
+
+const program = new Command();
+const unpackPreset = "__CURRENT_WORKING_PACKAGE__";
+const unpackOption = new Option(
+  "--unpack [directory]",
+  "Also unpack the generated marketplace into a directory; defaults to the current directory",
+).preset(unpackPreset);
+const mcpMetaOption = new Option(
+  "--mcp-meta <key>",
+  "Include the specified _meta key in generated .mcp.json server entries",
+).argParser((value: string, previous: string[] = []) => [...previous, value]);
+
+program.configureHelp({
+  optionDescription(option) {
+    const description = option.description ?? "";
+    if (option.attributeName() === "unpack" && option.presetArg === unpackPreset)
+      return description;
+    return option.description;
+  },
+});
+
+program
+  .argument("<serviceName>", "Region-unique API Center service name")
+  .argument("<region>", "Region name")
+  .argument("<workspaceName>", "Workspace to convert into marketplace zip")
+  .addOption(unpackOption)
+  .addOption(mcpMetaOption)
+  .action(async (
+    serviceName: string,
+    region: string,
+    workspaceName: string,
+    options: { unpack?: string; mcpMeta?: string[] },
+  ) => {
+    const unpack = await resolveUnpackDirectory(options.unpack);
+    const mcpMetaKeys = options.mcpMeta;
+
+    const result = await generateMarketplaceGit(
+      { serviceName, region, workspaceName },
+      { unpack, mcpMetaKeys },
+    );
+    if (result.unpackPath) {
+      console.log(`Unpacked marketplace into ${result.unpackPath}`);
+      return;
+    }
+
+    console.log(`Wrote ${result.pluginCount} plugins to ${result.zipPath}`);
+  });
+
+program.parse();

package/src/server/index.ts

@@ -0,0 +1 @@
+export * from "./marketplace.js";

package/src/server/marketplace.test.ts

@@ -0,0 +1,169 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+
+import {
+  mcpServerFromV0Entry,
+  mcpServerNameFromV0Entry,
+  mcpServersFromServerJson,
+} from "./marketplace.js";
+
+test("translates stdio-style v0 server.json entries", () => {
+  const server = mcpServerFromV0Entry({
+    command: "npx",
+    args: ["-y", "@example/server"],
+    env: {
+      API_KEY: "secret",
+      PORT: 3000,
+    },
+  });
+
+  assert.deepEqual(server, {
+    transport: "stdio",
+    command: "npx",
+    args: ["-y", "@example/server"],
+    env: {
+      API_KEY: "secret",
+      PORT: "3000",
+    },
+  });
+});
+
+test("translates HTTP-style v0 server.json entries", () => {
+  const server = mcpServerFromV0Entry({
+    type: "streamable-http",
+    url: "https://example.test/mcp",
+    headers: {
+      Authorization: "Bearer token",
+    },
+  });
+
+  assert.deepEqual(server, {
+    transport: "http",
+    url: "https://example.test/mcp",
+    headers: {
+      Authorization: "Bearer token",
+    },
+  });
+});
+
+test("reads both mcpServers and servers roots", () => {
+  assert.deepEqual(
+    mcpServersFromServerJson({
+      servers: {
+        sample: {
+          command: "node",
+          args: ["server.js"],
+        },
+      },
+    }),
+    {
+      sample: {
+        transport: "stdio",
+        command: "node",
+        args: ["server.js"],
+      },
+    },
+  );
+});
+
+test("translates nested server remotes and uses nested name", () => {
+  const entry = {
+    server: {
+      $schema: "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+      name: "msdocs-mcp-server",
+      title: "Microsoft docs",
+      description: "AI assistant with real-time access to official Microsoft documentation.",
+      version: "Original",
+      remotes: [
+        {
+          type: "sse",
+          url: "https://learn.microsoft.com/api/mcp",
+        },
+      ],
+      _meta: {
+        "custom.auth": {
+          clientId: "client-id",
+          publicClient: true,
+        },
+      },
+    },
+    _meta: {
+      "registry.id": "placeholder-id",
+      "custom.auth": {
+        clientId: "wrong-level",
+      },
+    },
+  };
+
+  assert.equal(mcpServerNameFromV0Entry(entry), "msdocs-mcp-server");
+  assert.deepEqual(mcpServerFromV0Entry(entry), {
+    transport: "sse",
+    url: "https://learn.microsoft.com/api/mcp",
+  });
+  assert.deepEqual(mcpServerFromV0Entry(entry, {
+    metaKeys: ["custom.auth", "registry.id"],
+  }), {
+    transport: "sse",
+    url: "https://learn.microsoft.com/api/mcp",
+    clientId: "client-id",
+    publicClient: true,
+  });
+});
+
+test("falls back to first package when nested server has no remotes", () => {
+  const entry = {
+    server: {
+      name: "pkg-server",
+      packages: [
+        {
+          registryType: "npm",
+          identifier: "@example/pkg-server",
+          version: "1.2.3",
+          transport: {
+            type: "stdio",
+          },
+          environmentVariables: [
+            {
+              name: "API_KEY",
+              value: "secret",
+            },
+          ],
+          packageArguments: [
+            {
+              type: "named",
+              name: "--mode",
+              value: "test",
+            },
+          ],
+        },
+      ],
+    },
+    _meta: {
+      "oauth-client": {
+        client_name: "example",
+      },
+      ignored: true,
+    },
+  };
+
+  assert.equal(mcpServerNameFromV0Entry(entry), "pkg-server");
+  assert.deepEqual(mcpServerFromV0Entry(entry), {
+    transport: "stdio",
+    command: "npx",
+    args: ["-y", "@example/pkg-server@1.2.3", "--mode", "test"],
+    env: {
+      API_KEY: "secret",
+    },
+  });
+  assert.deepEqual(mcpServerFromV0Entry(entry, {
+    metaKeys: ["oauth-client"],
+  }), {
+    transport: "stdio",
+    command: "npx",
+    args: ["-y", "@example/pkg-server@1.2.3", "--mode", "test"],
+    env: {
+      API_KEY: "secret",
+    },
+    client_name: "example",
+  });
+});