@bluehive/sdk-mcp 0.1.0-alpha.2

package/dynamic-tools.mjs

@@ -0,0 +1,132 @@
+import { asTextContentResult } from "./tools/types.mjs";
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { z } from 'zod';
+import { Cabidela } from '@cloudflare/cabidela';
+function zodToInputSchema(schema) {
+    return {
+        type: 'object',
+        ...zodToJsonSchema(schema),
+    };
+}
+/**
+ * A list of tools that expose all the endpoints in the API dynamically.
+ *
+ * Instead of exposing every endpoint as it's own tool, which uses up too many tokens for LLMs to use at once,
+ * we expose a single tool that can be used to search for endpoints by name, resource, operation, or tag, and then
+ * a generic endpoint that can be used to invoke any endpoint with the provided arguments.
+ *
+ * @param endpoints - The endpoints to include in the list.
+ */
+export function dynamicTools(endpoints) {
+    const listEndpointsSchema = z.object({
+        search_query: z
+            .string()
+            .optional()
+            .describe('An optional search query to filter the endpoints by. Provide a partial name, resource, operation, or tag to filter the endpoints returned.'),
+    });
+    const listEndpointsTool = {
+        metadata: {
+            resource: 'dynamic_tools',
+            operation: 'read',
+            tags: [],
+        },
+        tool: {
+            name: 'list_api_endpoints',
+            description: 'List or search for all endpoints in the BlueHive TypeScript API',
+            inputSchema: zodToInputSchema(listEndpointsSchema),
+        },
+        handler: async (client, args) => {
+            const query = args && listEndpointsSchema.parse(args).search_query?.trim();
+            const filteredEndpoints = query && query.length > 0 ?
+                endpoints.filter((endpoint) => {
+                    const fieldsToMatch = [
+                        endpoint.tool.name,
+                        endpoint.tool.description,
+                        endpoint.metadata.resource,
+                        endpoint.metadata.operation,
+                        ...endpoint.metadata.tags,
+                    ];
+                    return fieldsToMatch.some((field) => field && field.toLowerCase().includes(query.toLowerCase()));
+                })
+                : endpoints;
+            return asTextContentResult({
+                tools: filteredEndpoints.map(({ tool, metadata }) => ({
+                    name: tool.name,
+                    description: tool.description,
+                    resource: metadata.resource,
+                    operation: metadata.operation,
+                    tags: metadata.tags,
+                })),
+            });
+        },
+    };
+    const getEndpointSchema = z.object({
+        endpoint: z.string().describe('The name of the endpoint to get the schema for.'),
+    });
+    const getEndpointTool = {
+        metadata: {
+            resource: 'dynamic_tools',
+            operation: 'read',
+            tags: [],
+        },
+        tool: {
+            name: 'get_api_endpoint_schema',
+            description: 'Get the schema for an endpoint in the BlueHive TypeScript API. You can use the schema returned by this tool to invoke an endpoint with the `invoke_api_endpoint` tool.',
+            inputSchema: zodToInputSchema(getEndpointSchema),
+        },
+        handler: async (client, args) => {
+            if (!args) {
+                throw new Error('No endpoint provided');
+            }
+            const endpointName = getEndpointSchema.parse(args).endpoint;
+            const endpoint = endpoints.find((e) => e.tool.name === endpointName);
+            if (!endpoint) {
+                throw new Error(`Endpoint ${endpointName} not found`);
+            }
+            return asTextContentResult(endpoint.tool);
+        },
+    };
+    const invokeEndpointSchema = z.object({
+        endpoint_name: z.string().describe('The name of the endpoint to invoke.'),
+        args: z
+            .record(z.string(), z.any())
+            .describe('The arguments to pass to the endpoint. This must match the schema returned by the `get_api_endpoint_schema` tool.'),
+    });
+    const invokeEndpointTool = {
+        metadata: {
+            resource: 'dynamic_tools',
+            operation: 'write',
+            tags: [],
+        },
+        tool: {
+            name: 'invoke_api_endpoint',
+            description: 'Invoke an endpoint in the BlueHive TypeScript API. Note: use the `list_api_endpoints` tool to get the list of endpoints and `get_api_endpoint_schema` tool to get the schema for an endpoint.',
+            inputSchema: zodToInputSchema(invokeEndpointSchema),
+        },
+        handler: async (client, args) => {
+            if (!args) {
+                throw new Error('No endpoint provided');
+            }
+            const { success, data, error } = invokeEndpointSchema.safeParse(args);
+            if (!success) {
+                throw new Error(`Invalid arguments for endpoint. ${error?.format()}`);
+            }
+            const { endpoint_name, args: endpointArgs } = data;
+            const endpoint = endpoints.find((e) => e.tool.name === endpoint_name);
+            if (!endpoint) {
+                throw new Error(`Endpoint ${endpoint_name} not found. Use the \`list_api_endpoints\` tool to get the list of available endpoints.`);
+            }
+            try {
+                // Try to validate the arguments for a better error message
+                const cabidela = new Cabidela(endpoint.tool.inputSchema, { fullErrors: true });
+                cabidela.validate(endpointArgs);
+            }
+            catch (error) {
+                throw new Error(`Invalid arguments for endpoint ${endpoint_name}:\n${error}`);
+            }
+            return await endpoint.handler(client, endpointArgs);
+        },
+    };
+    return [getEndpointTool, listEndpointsTool, invokeEndpointTool];
+}
+//# sourceMappingURL=dynamic-tools.mjs.map

package/dynamic-tools.mjs.map

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

package/index.d.mts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.mts.map

package/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":""}

package/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

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

package/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const server_1 = require("./server.js");
+const tools_1 = require("./tools.js");
+const options_1 = require("./options.js");
+async function main() {
+    const options = parseOptionsOrError();
+    if (options.list) {
+        listAllTools();
+        return;
+    }
+    const includedTools = selectToolsOrError(tools_1.endpoints, options);
+    console.error(`MCP Server starting with ${includedTools.length} tools:`, includedTools.map((e) => e.tool.name));
+    (0, server_1.init)({ server: server_1.server, endpoints: includedTools });
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server_1.server.connect(transport);
+    console.error('MCP Server running on stdio');
+}
+if (require.main === module) {
+    main().catch((error) => {
+        console.error('Fatal error in main():', error);
+        process.exit(1);
+    });
+}
+function parseOptionsOrError() {
+    try {
+        return (0, options_1.parseOptions)();
+    }
+    catch (error) {
+        console.error('Error parsing options:', error);
+        process.exit(1);
+    }
+}
+function selectToolsOrError(endpoints, options) {
+    try {
+        const includedTools = (0, server_1.selectTools)(endpoints, options);
+        if (includedTools.length === 0) {
+            console.error('No tools match the provided filters.');
+            process.exit(1);
+        }
+        return includedTools;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error('Error filtering tools:', error.message);
+        }
+        else {
+            console.error('Error filtering tools:', error);
+        }
+        process.exit(1);
+    }
+}
+function listAllTools() {
+    if (tools_1.endpoints.length === 0) {
+        console.log('No tools available.');
+        return;
+    }
+    console.log('Available tools:\n');
+    // Group endpoints by resource
+    const resourceGroups = new Map();
+    for (const endpoint of tools_1.endpoints) {
+        const resource = endpoint.metadata.resource;
+        if (!resourceGroups.has(resource)) {
+            resourceGroups.set(resource, []);
+        }
+        resourceGroups.get(resource).push(endpoint);
+    }
+    // Sort resources alphabetically
+    const sortedResources = Array.from(resourceGroups.keys()).sort();
+    // Display hierarchically by resource
+    for (const resource of sortedResources) {
+        console.log(`Resource: ${resource}`);
+        const resourceEndpoints = resourceGroups.get(resource);
+        // Sort endpoints by tool name
+        resourceEndpoints.sort((a, b) => a.tool.name.localeCompare(b.tool.name));
+        for (const endpoint of resourceEndpoints) {
+            const { tool, metadata: { operation, tags }, } = endpoint;
+            console.log(`  - ${tool.name} (${operation}) ${tags.length > 0 ? `tags: ${tags.join(', ')}` : ''}`);
+            console.log(`    Description: ${tool.description}`);
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=index.js.map

package/index.js.map

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

package/index.mjs

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { init, selectTools, server } from "./server.mjs";
+import { endpoints } from "./tools.mjs";
+import { parseOptions } from "./options.mjs";
+async function main() {
+    const options = parseOptionsOrError();
+    if (options.list) {
+        listAllTools();
+        return;
+    }
+    const includedTools = selectToolsOrError(endpoints, options);
+    console.error(`MCP Server starting with ${includedTools.length} tools:`, includedTools.map((e) => e.tool.name));
+    init({ server, endpoints: includedTools });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('MCP Server running on stdio');
+}
+if (require.main === module) {
+    main().catch((error) => {
+        console.error('Fatal error in main():', error);
+        process.exit(1);
+    });
+}
+function parseOptionsOrError() {
+    try {
+        return parseOptions();
+    }
+    catch (error) {
+        console.error('Error parsing options:', error);
+        process.exit(1);
+    }
+}
+function selectToolsOrError(endpoints, options) {
+    try {
+        const includedTools = selectTools(endpoints, options);
+        if (includedTools.length === 0) {
+            console.error('No tools match the provided filters.');
+            process.exit(1);
+        }
+        return includedTools;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error('Error filtering tools:', error.message);
+        }
+        else {
+            console.error('Error filtering tools:', error);
+        }
+        process.exit(1);
+    }
+}
+function listAllTools() {
+    if (endpoints.length === 0) {
+        console.log('No tools available.');
+        return;
+    }
+    console.log('Available tools:\n');
+    // Group endpoints by resource
+    const resourceGroups = new Map();
+    for (const endpoint of endpoints) {
+        const resource = endpoint.metadata.resource;
+        if (!resourceGroups.has(resource)) {
+            resourceGroups.set(resource, []);
+        }
+        resourceGroups.get(resource).push(endpoint);
+    }
+    // Sort resources alphabetically
+    const sortedResources = Array.from(resourceGroups.keys()).sort();
+    // Display hierarchically by resource
+    for (const resource of sortedResources) {
+        console.log(`Resource: ${resource}`);
+        const resourceEndpoints = resourceGroups.get(resource);
+        // Sort endpoints by tool name
+        resourceEndpoints.sort((a, b) => a.tool.name.localeCompare(b.tool.name));
+        for (const endpoint of resourceEndpoints) {
+            const { tool, metadata: { operation, tags }, } = endpoint;
+            console.log(`  - ${tool.name} (${operation}) ${tags.length > 0 ? `tags: ${tags.join(', ')}` : ''}`);
+            console.log(`    Description: ${tool.description}`);
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=index.mjs.map

package/index.mjs.map

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

package/options.d.mts

@@ -0,0 +1,14 @@
+import { Filter } from "./tools.mjs";
+import { ClientCapabilities, ClientType } from "./compat.mjs";
+export type CLIOptions = McpOptions & {
+    list: boolean;
+};
+export type McpOptions = {
+    client: ClientType | undefined;
+    includeDynamicTools: boolean | undefined;
+    includeAllTools: boolean | undefined;
+    filters: Filter[];
+    capabilities?: Partial<ClientCapabilities>;
+};
+export declare function parseOptions(): CLIOptions;
+//# sourceMappingURL=options.d.mts.map

package/options.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.mts","sourceRoot":"","sources":["src/options.ts"],"names":[],"mappings":"OAEO,EAAa,MAAM,EAAE;OACrB,EAAE,kBAAkB,EAAgB,UAAU,EAAE;AAEvD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IACpC,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5C,CAAC;AA+BF,wBAAgB,YAAY,IAAI,UAAU,CA2MzC"}

package/options.d.ts

@@ -0,0 +1,14 @@
+import { Filter } from "./tools.js";
+import { ClientCapabilities, ClientType } from "./compat.js";
+export type CLIOptions = McpOptions & {
+    list: boolean;
+};
+export type McpOptions = {
+    client: ClientType | undefined;
+    includeDynamicTools: boolean | undefined;
+    includeAllTools: boolean | undefined;
+    filters: Filter[];
+    capabilities?: Partial<ClientCapabilities>;
+};
+export declare function parseOptions(): CLIOptions;
+//# sourceMappingURL=options.d.ts.map

package/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["src/options.ts"],"names":[],"mappings":"OAEO,EAAa,MAAM,EAAE;OACrB,EAAE,kBAAkB,EAAgB,UAAU,EAAE;AAEvD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IACpC,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;IAC/B,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAC;IACzC,eAAe,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC5C,CAAC;AA+BF,wBAAgB,YAAY,IAAI,UAAU,CA2MzC"}