@commercetools/nimbus-mcp 0.1.0 → 2.10.0

package/src/index.ts

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Nimbus MCP Server — stdio entry point.
- *
- * Connects the MCP server to stdin/stdout so it can be used with any MCP
- * client (e.g. Claude Desktop, Claude Code) via the stdio transport.
- *
- * Usage:
- *   node dist/index.js
- *   # or via package bin:
- *   nimbus-mcp
- */
-
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createServer } from "./server.js";
-
-async function main(): Promise<void> {
-  const server = createServer();
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch((error: unknown) => {
-  console.error("Nimbus MCP server error:", error);
-  process.exit(1);
-});
-
-export type { ComponentMeta, DesignToken, ToolResult } from "./types.js";

package/src/server.spec.ts

@@ -1,86 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
-import { createServer } from "./server.js";
-
-/**
- * Integration tests for the Nimbus MCP server.
- *
- * These tests run the server in-process using InMemoryTransport so no
- * child-process spawning or stdio wiring is needed. Add new tools freely —
- * the tool-list tests only assert structure and cardinality, never specific
- * tool names, so they won't break when new tools are registered.
- */
-
-function createTestClient() {
-  const server = createServer();
-  const [clientTransport, serverTransport] =
-    InMemoryTransport.createLinkedPair();
-  const client = new Client(
-    { name: "test-client", version: "1.0.0" },
-    { capabilities: {} }
-  );
-
-  return {
-    server,
-    client,
-    clientTransport,
-    serverTransport,
-    async connect() {
-      await server.connect(serverTransport);
-      await client.connect(clientTransport);
-    },
-    async close() {
-      await client.close();
-    },
-  };
-}
-
-describe("MCP server — initialize handshake", () => {
-  it("responds to initialize with server info and capabilities", async () => {
-    // client.connect() performs the initialize handshake automatically
-    const ctx = createTestClient();
-    await ctx.connect();
-
-    const serverVersion = ctx.client.getServerVersion();
-    expect(serverVersion).toBeDefined();
-    expect(serverVersion?.name).toBe("nimbus-mcp");
-    expect(serverVersion?.version).toMatch(/^\d+\.\d+\.\d+$/);
-
-    const capabilities = ctx.client.getServerCapabilities();
-    expect(capabilities).toBeDefined();
-    expect(capabilities?.tools).toBeDefined();
-
-    await ctx.close();
-  });
-});
-
-describe("MCP server — tools/list", () => {
-  it("returns a non-empty array of tools", async () => {
-    const ctx = createTestClient();
-    await ctx.connect();
-
-    const { tools } = await ctx.client.listTools();
-    expect(Array.isArray(tools)).toBe(true);
-    expect(tools.length).toBeGreaterThan(0);
-
-    await ctx.close();
-  });
-
-  it("every tool has a name, description, and inputSchema", async () => {
-    const ctx = createTestClient();
-    await ctx.connect();
-
-    const { tools } = await ctx.client.listTools();
-    for (const tool of tools) {
-      expect(typeof tool.name).toBe("string");
-      expect(tool.name.length).toBeGreaterThan(0);
-      expect(tool.description).toBeDefined();
-      expect(tool.description!.length).toBeGreaterThan(0);
-      expect(tool.inputSchema).toBeDefined();
-      expect(tool.inputSchema.type).toBe("object");
-    }
-
-    await ctx.close();
-  });
-});

package/src/server.ts

@@ -1,28 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { registerListComponents } from "./tools/list-components.js";
-
-/**
- * Creates and configures the Nimbus MCP server.
- *
- * Each tool lives in `src/tools/` and exports a `register*` function that
- * receives the server instance and calls `server.registerTool(...)`. This
- * file collects all registrations in one place.
- */
-export function createServer(): McpServer {
-  const server = new McpServer(
-    {
-      name: "nimbus-mcp",
-      version: "0.1.0",
-    },
-    {
-      capabilities: {
-        tools: {},
-      },
-    }
-  );
-
-  // Register all tools
-  registerListComponents(server);
-
-  return server;
-}

package/src/tools/list-components.ts

@@ -1,49 +0,0 @@
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { getRouteManifest } from "../data-loader.js";
-
-/**
- * Registers the `list_components` tool on the given MCP server.
- *
- * Returns a list of all Nimbus component names and descriptions from the
- * route manifest. This is a lightweight discovery tool — use
- * `get_component_docs` to fetch full documentation for a specific component.
- */
-export function registerListComponents(server: McpServer): void {
-  server.registerTool(
-    "list_components",
-    {
-      title: "List Components",
-      description:
-        "Returns the names and descriptions of all available Nimbus components.",
-      inputSchema: {},
-    },
-    async () => {
-      try {
-        const manifest = await getRouteManifest();
-        const components = manifest.routes
-          .filter((route) => route.category === "components")
-          .map((route) => `${route.title}: ${route.description}`)
-          .join("\n");
-
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: components || "No components found.",
-            },
-          ],
-        };
-      } catch {
-        return {
-          content: [
-            {
-              type: "text" as const,
-              text: "Component data is not available in this environment.",
-            },
-          ],
-          isError: true,
-        };
-      }
-    }
-  );
-}

package/src/types.ts

@@ -1,31 +0,0 @@
-/**
- * Shared type definitions for the Nimbus MCP server.
- */
-
-/** Metadata about a Nimbus component. */
-export interface ComponentMeta {
-  /** Component name in PascalCase (e.g. "Button", "DatePicker"). */
-  name: string;
-  /** Brief description of the component's purpose. */
-  description: string;
-  /** Filesystem path to the component directory. */
-  path: string;
-}
-
-/** A single design token entry. */
-export interface DesignToken {
-  /** Token name (e.g. "color.primary.500"). */
-  name: string;
-  /** Resolved token value. */
-  value: string;
-  /** Category the token belongs to (e.g. "color", "spacing"). */
-  category: string;
-}
-
-/** Result returned by MCP tool handlers. */
-export interface ToolResult {
-  content: Array<{
-    type: "text";
-    text: string;
-  }>;
-}

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "module": "NodeNext",
-    "moduleResolution": "nodenext",
-    "noEmit": false,
-    "declaration": true,
-    "allowImportingTsExtensions": false,
-    "verbatimModuleSyntax": false
-  },
-  "include": ["src"]
-}

package/vitest.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-  test: {
-    name: "nimbus-mcp",
-    include: ["src/**/*.spec.ts"],
-    environment: "node",
-  },
-});