@smithers-orchestrator/cli 0.16.0

package/src/mcp/SemanticMcpServerOptions.ts

@@ -0,0 +1,4 @@
+export type SemanticMcpServerOptions = {
+    name?: string;
+    version?: string;
+};

package/src/mcp/SemanticToolCallResult.ts

@@ -0,0 +1,14 @@
+import type { SemanticToolError } from "./SemanticToolError.ts";
+
+export type SemanticToolCallResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    structuredContent: {
+        ok: boolean;
+        data?: unknown;
+        error?: SemanticToolError;
+    };
+    isError?: boolean;
+};

package/src/mcp/SemanticToolContext.ts

@@ -0,0 +1,6 @@
+import type { findAndOpenDb } from "../find-db.js";
+
+export type SemanticToolContext = {
+    cwd: () => string;
+    openDb: typeof findAndOpenDb;
+};

package/src/mcp/SemanticToolDefinition.ts

@@ -0,0 +1,13 @@
+import type { z } from "zod";
+
+import type { SEMANTIC_TOOL_NAMES } from "./semantic-tools.js";
+import type { SemanticToolCallResult } from "./SemanticToolCallResult.ts";
+
+export type SemanticToolDefinition = {
+    name: (typeof SEMANTIC_TOOL_NAMES)[number];
+    description: string;
+    inputSchema: z.ZodTypeAny;
+    outputSchema: z.ZodTypeAny;
+    annotations: Record<string, boolean>;
+    handler: (input: any) => Promise<SemanticToolCallResult>;
+};

package/src/mcp/SemanticToolError.ts

@@ -0,0 +1,6 @@
+export type SemanticToolError = {
+    code: string;
+    message: string;
+    details?: Record<string, unknown> | null;
+    docsUrl?: string | null;
+};

package/src/mcp/semantic-server.js

@@ -0,0 +1,41 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createSemanticToolDefinitions, } from "./semantic-tools.js";
+/** @typedef {import("./SemanticMcpServerOptions.ts").SemanticMcpServerOptions} SemanticMcpServerOptions */
+/** @typedef {import("./SemanticToolDefinition.ts").SemanticToolDefinition} SemanticToolDefinition */
+
+/**
+ * @param {McpServer} server
+ * @param {SemanticToolDefinition[]} [toolDefinitions]
+ */
+export function registerSemanticTools(server, toolDefinitions = createSemanticToolDefinitions()) {
+    for (const tool of toolDefinitions) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            annotations: tool.annotations,
+        }, async (input) => tool.handler(input));
+    }
+    return server;
+}
+/**
+ * @param {SemanticMcpServerOptions} [options]
+ */
+export function createSemanticMcpServer(options = {}) {
+    const server = new McpServer({
+        name: options.name ?? "smithers",
+        version: options.version ?? "0.0.0",
+    });
+    registerSemanticTools(server);
+    return server;
+}
+/**
+ * @param {SemanticMcpServerOptions} [options]
+ */
+export async function serveSemanticMcpServer(options = {}) {
+    const server = createSemanticMcpServer(options);
+    const transport = new StdioServerTransport(process.stdin, process.stdout);
+    await server.connect(transport);
+    return server;
+}