@msegoviadev/api-mind-mcp 0.1.0

package/dist/core/parser.js

@@ -0,0 +1,215 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseApiHeader = parseApiHeader;
+exports.parseServers = parseServers;
+exports.stripDeprecationWrapper = stripDeprecationWrapper;
+exports.normalizePath = normalizePath;
+exports.parseEndpointLine = parseEndpointLine;
+exports.parseEndpoints = parseEndpoints;
+exports.findEndpointBlock = findEndpointBlock;
+exports.extractSchemaRefs = extractSchemaRefs;
+exports.findSchemaBlock = findSchemaBlock;
+exports.collectSchemas = collectSchemas;
+exports.parseFullEndpoint = parseFullEndpoint;
+const API_HEADER_REGEX = /^#\s*API:\s*(.+?)\s*—\s*(.+)$/;
+const SERVERS_HEADER_REGEX = /^#\s*Servers:\s*(.+)$/;
+const SECTION_HEADER_REGEX = /^##\s+(.+?)\s*$/;
+const ENDPOINT_LINE_REGEX = /^(~~)?([A-Z]+)(~~)?\s+(\/[^\s]*?)(\s+\[auth:\s*(.+?)\])?\s*$/;
+const SCHEMA_REF_REGEX = /\b([A-Z][a-zA-Z0-9_]*)\b/g;
+function parseApiHeader(content) {
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const match = line.match(API_HEADER_REGEX);
+        if (match) {
+            return {
+                title: match[1].trim(),
+                defaultUrl: match[2].trim(),
+            };
+        }
+    }
+    return null;
+}
+function parseServers(content) {
+    const lines = content.split("\n");
+    for (const line of lines) {
+        const match = line.match(SERVERS_HEADER_REGEX);
+        if (match) {
+            const servers = {};
+            const pairs = match[1].split(",");
+            for (const pair of pairs) {
+                const [label, url] = pair.trim().split("=");
+                if (label && url) {
+                    servers[label.trim()] = url.trim();
+                }
+            }
+            return servers;
+        }
+    }
+    return {};
+}
+function stripDeprecationWrapper(method) {
+    return method.replace(/^~~|~~$/g, "");
+}
+function normalizePath(path) {
+    return path.replace(/\{[^}:]+:[^}]+\}/g, (match) => {
+        return match.substring(0, match.indexOf(":")) + "}";
+    });
+}
+function parseEndpointLine(line) {
+    const match = line.match(ENDPOINT_LINE_REGEX);
+    if (!match)
+        return null;
+    const method = stripDeprecationWrapper(match[2]);
+    const path = normalizePath(match[4]);
+    const auth = match[6]?.trim();
+    return { method, path, auth: auth || undefined };
+}
+function parseEndpoints(content) {
+    const lines = content.split("\n");
+    const endpoints = [];
+    let currentSection = null;
+    let inSchemasSection = false;
+    for (const line of lines) {
+        if (line.match(/^##\s+Schemas\s*$/i)) {
+            inSchemasSection = true;
+            continue;
+        }
+        const sectionMatch = line.match(SECTION_HEADER_REGEX);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1];
+            inSchemasSection = false;
+            continue;
+        }
+        if (inSchemasSection)
+            continue;
+        if (line.startsWith("#"))
+            continue;
+        const endpoint = parseEndpointLine(line);
+        if (endpoint && currentSection) {
+            endpoints.push({
+                ...endpoint,
+                section: currentSection,
+            });
+        }
+    }
+    return endpoints;
+}
+function findEndpointBlock(content, method, path) {
+    const normalizedPath = normalizePath(path);
+    const lines = content.split("\n");
+    const blockLines = [];
+    let inBlock = false;
+    let foundEndpoint = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const endpoint = parseEndpointLine(line);
+        if (endpoint) {
+            if (endpoint.method === method && endpoint.path === normalizedPath) {
+                inBlock = true;
+                foundEndpoint = true;
+                blockLines.push(line);
+                continue;
+            }
+            else if (inBlock) {
+                break;
+            }
+        }
+        if (inBlock) {
+            if (line.match(/^##\s+/) || line.match(/^(~~)?[A-Z]+(~~)?\s+\//)) {
+                break;
+            }
+            blockLines.push(line);
+        }
+    }
+    return foundEndpoint ? blockLines.join("\n") : null;
+}
+function extractSchemaRefs(block) {
+    const refs = new Set();
+    const matches = block.matchAll(SCHEMA_REF_REGEX);
+    for (const match of matches) {
+        const name = match[1];
+        if (name === "OneOf" || name === "AnyOf" || name === "AllOf" || name === "extends") {
+            continue;
+        }
+        refs.add(name);
+    }
+    return Array.from(refs);
+}
+function findSchemaBlock(content, schemaName) {
+    const lines = content.split("\n");
+    const schemaRegex = new RegExp(`^${schemaName}:\\s*`);
+    let inSchema = false;
+    let braceDepth = 0;
+    const blockLines = [];
+    for (const line of lines) {
+        if (line.match(schemaRegex)) {
+            inSchema = true;
+            blockLines.push(line);
+            braceDepth += (line.match(/{/g) || []).length;
+            braceDepth -= (line.match(/}/g) || []).length;
+            continue;
+        }
+        if (inSchema) {
+            blockLines.push(line);
+            braceDepth += (line.match(/{/g) || []).length;
+            braceDepth -= (line.match(/}/g) || []).length;
+            if (line.includes(":") && !line.includes("{") && braceDepth === 0) {
+                break;
+            }
+            if (braceDepth === 0 && line.trim().endsWith("}")) {
+                break;
+            }
+        }
+    }
+    return blockLines.length > 0 ? blockLines.join("\n") : null;
+}
+function collectSchemas(content, endpointBlock) {
+    const schemasSection = extractSchemasSection(content);
+    const refs = extractSchemaRefs(endpointBlock);
+    const collected = [];
+    for (const ref of refs) {
+        const schemaBlock = findSchemaBlock(schemasSection, ref);
+        if (schemaBlock) {
+            collected.push(schemaBlock);
+            const nestedRefs = extractSchemaRefs(schemaBlock);
+            for (const nestedRef of nestedRefs) {
+                if (!refs.includes(nestedRef)) {
+                    const nestedBlock = findSchemaBlock(schemasSection, nestedRef);
+                    if (nestedBlock) {
+                        collected.push(nestedBlock);
+                    }
+                }
+            }
+        }
+    }
+    return collected.join("\n\n");
+}
+function extractSchemasSection(content) {
+    const lines = content.split("\n");
+    const schemaLines = [];
+    let inSchemas = false;
+    for (const line of lines) {
+        if (line.match(/^##\s+Schemas\s*$/i)) {
+            inSchemas = true;
+            continue;
+        }
+        if (inSchemas) {
+            if (line.match(/^##\s+/)) {
+                break;
+            }
+            schemaLines.push(line);
+        }
+    }
+    return schemaLines.join("\n");
+}
+function parseFullEndpoint(content, method, path) {
+    const endpointBlock = findEndpointBlock(content, method, path);
+    if (!endpointBlock)
+        return null;
+    const schemas = collectSchemas(content, endpointBlock);
+    if (schemas) {
+        return endpointBlock + "\n\n" + schemas;
+    }
+    return endpointBlock;
+}
+//# sourceMappingURL=parser.js.map

package/dist/core/parser.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,55 @@
+export interface ApiMeta {
+    filePath: string;
+    title: string;
+    defaultUrl: string;
+    servers: Record<string, string>;
+}
+export interface EndpointEntry {
+    api: string;
+    section: string;
+    method: string;
+    path: string;
+    auth?: string;
+}
+export interface EndpointIndex {
+    environments: string[];
+    apis: Record<string, ApiMeta>;
+    endpoints: EndpointEntry[];
+}
+export interface ApiInfo {
+    name: string;
+    title: string;
+    defaultUrl: string;
+    environments: Record<string, string>;
+}
+export interface ListApisResult {
+    apis: ApiInfo[];
+}
+export interface ListEndpointsResult {
+    environments: string[];
+    endpoints: EndpointEntry[];
+}
+export interface InitOptions {
+    specsDir: string;
+}
+export interface ParsedApiHeader {
+    title: string;
+    defaultUrl: string;
+}
+export interface ParsedEndpoint {
+    method: string;
+    path: string;
+    auth?: string;
+    section: string;
+}
+export interface GetEndpointSchemaResult {
+    api: string;
+    title: string;
+    defaultUrl: string;
+    environments: Record<string, string>;
+    method: string;
+    path: string;
+    auth: string | null;
+    schema: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,EAAE,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+declare const Server: any;
+declare const StdioServerTransport: any;
+declare const CallToolRequestSchema: any, ListToolsRequestSchema: any;
+declare const initIndex: any;
+declare const initNodeBindings: any;
+declare const listApisDefinition: any, listApisHandler: any;
+declare const listEndpointsDefinition: any, listEndpointsHandler: any;
+declare const getEndpointSchemaDefinition: any, getEndpointSchemaHandler: any;
+declare const resolve: any, isAbsolute: any;
+declare function getSpecsDir(): string;
+declare const SPECS_DIR: string;
+declare const server: any;
+declare let indexReady: boolean;
+declare let indexError: any;
+declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,QAAA,MAAQ,MAAM,KAAyD,CAAC;AACxE,QAAA,MAAQ,oBAAoB,KAAyD,CAAC;AACtF,QAAA,MACE,qBAAqB,OACrB,sBAAsB,KACyB,CAAC;AAClD,QAAA,MAAQ,SAAS,KAAgC,CAAC;AAClD,QAAA,MAAQ,gBAAgB,KAAsC,CAAC;AAC/D,QAAA,MAAoB,kBAAkB,OAAW,eAAe,KAAoC,CAAC;AACrG,QAAA,MAAoB,uBAAuB,OAAW,oBAAoB,KAAyC,CAAC;AACpH,QAAA,MAAoB,2BAA2B,OAAW,wBAAwB,KAA8C,CAAC;AACjI,QAAA,MAAQ,OAAO,OAAE,UAAU,KAAoB,CAAC;AAMhD,iBAAS,WAAW,WAkEnB;AAED,QAAA,MAAM,SAAS,QAAgB,CAAC;AAGhC,QAAA,MAAM,MAAM,KAUX,CAAC;AAGF,QAAA,IAAI,UAAU,SAAQ,CAAC;AACvB,QAAA,IAAI,UAAU,KAAO,CAAC;AAiFtB,iBAAe,IAAI,kBAIlB"}

package/dist/index.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+const { Server } = require("@modelcontextprotocol/sdk/server/index.js");
+const { StdioServerTransport } = require("@modelcontextprotocol/sdk/server/stdio.js");
+const { CallToolRequestSchema, ListToolsRequestSchema, } = require("@modelcontextprotocol/sdk/types.js");
+const { initIndex } = require("./core/loader.js");
+const { initNodeBindings } = require("./lib/node-bindings.js");
+const { definition: listApisDefinition, handler: listApisHandler } = require("./tools/list-apis.js");
+const { definition: listEndpointsDefinition, handler: listEndpointsHandler } = require("./tools/list-endpoints.js");
+const { definition: getEndpointSchemaDefinition, handler: getEndpointSchemaHandler } = require("./tools/get-endpoint-schema.js");
+const { resolve, isAbsolute } = require("path");
+// Initialize Node.js bindings for file system operations
+initNodeBindings();
+// Get specs directory from command-line, env var, or error
+function getSpecsDir() {
+    // Priority 1: Command-line argument
+    const args = process.argv.slice(2);
+    if (args[0]) {
+        if (!isAbsolute(args[0])) {
+            console.error(`
+[api-mind] ERROR: Relative paths not supported.
+Provided: ${args[0]}
+Absolute: ${resolve(args[0])}
+
+Use absolute path:
+  claude mcp add api-mind -- node dist/index.js ${resolve(args[0])}
+`);
+            process.exit(1);
+        }
+        console.error(`[api-mind] Specs directory: ${args[0]}`);
+        return args[0];
+    }
+    // Priority 2: Environment variable
+    if (process.env.SPECS_DIR) {
+        if (!isAbsolute(process.env.SPECS_DIR)) {
+            console.error(`
+[api-mind] ERROR: SPECS_DIR must be absolute.
+Provided: ${process.env.SPECS_DIR}
+Absolute: ${resolve(process.env.SPECS_DIR)}
+
+Use:
+  SPECS_DIR=${resolve(process.env.SPECS_DIR)} claude mcp add api-mind -- ...
+`);
+            process.exit(1);
+        }
+        console.error(`[api-mind] Specs directory: ${process.env.SPECS_DIR}`);
+        return process.env.SPECS_DIR;
+    }
+    // Priority 3: No configuration - help user
+    console.error(`
+[api-mind] ERROR: No specs directory configured.
+
+Setup options:
+
+1. Command-line argument:
+   claude mcp add api-mind -- node dist/index.js /ABSOLUTE/PATH/TO/SPECS
+
+2. Environment variable:
+   claude mcp add api-mind --env SPECS_DIR=/ABSOLUTE/PATH/TO/SPECS -- node dist/index.js
+
+3. Project .mcp.json:
+   {
+     "mcpServers": {
+       "api-mind": {
+         "command": "node",
+         "args": ["/path/to/api-mind-claude/dist/index.js"],
+         "env": { "SPECS_DIR": "/ABSOLUTE/PATH/TO/SPECS" }
+       }
+     }
+   }
+
+Requirements:
+- Use ABSOLUTE paths only
+- Generate .mind files: spec-mind sync --no-notation ./specs/
+
+Docs: https://github.com/msegoviadev/api-mind-mcp
+`);
+    process.exit(1);
+}
+const SPECS_DIR = getSpecsDir();
+// Create MCP server
+const server = new Server({
+    name: "api-mind",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Initialize index on startup
+let indexReady = false;
+let indexError = null;
+initIndex({ specsDir: SPECS_DIR })
+    .then(() => {
+    indexReady = true;
+    console.error("[api-mind] Index initialized successfully");
+})
+    .catch((err) => {
+    indexError = err;
+    console.error("[api-mind] Failed to initialize index:", err.message);
+});
+// Register tools list handler
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            listApisDefinition,
+            listEndpointsDefinition,
+            getEndpointSchemaDefinition,
+        ],
+    };
+});
+// Register tool execution handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    // Check if index is ready
+    if (!indexReady) {
+        if (indexError) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: Failed to initialize index: ${indexError.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Error: Index not initialized. Please wait and try again.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        switch (name) {
+            case "list_apis":
+                return await listApisHandler(args);
+            case "list_endpoints":
+                return await listEndpointsHandler(args);
+            case "get_endpoint_schema":
+                return await getEndpointSchemaHandler(args);
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error executing tool ${name}: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[api-mind] MCP server running on stdio");
+}
+main().catch((error) => {
+    console.error("[api-mind] Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/node-bindings.d.ts

@@ -0,0 +1,2 @@
+export declare function initNodeBindings(): void;
+//# sourceMappingURL=node-bindings.d.ts.map

package/dist/lib/node-bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-bindings.d.ts","sourceRoot":"","sources":["../../src/lib/node-bindings.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC"}

package/dist/lib/node-bindings.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initNodeBindings = initNodeBindings;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const loader_js_1 = require("../core/loader.js");
+function initNodeBindings() {
+    (0, loader_js_1.setFileReader)(async (path) => {
+        return await (0, promises_1.readFile)(path, "utf-8");
+    });
+    (0, loader_js_1.setDirReader)(async (dir) => {
+        const entries = await (0, promises_1.readdir)(dir);
+        return entries;
+    });
+    (0, loader_js_1.setPathJoiner)((...parts) => (0, path_1.join)(...parts));
+}
+//# sourceMappingURL=node-bindings.js.map

package/dist/lib/node-bindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-bindings.js","sourceRoot":"","sources":["../../src/lib/node-bindings.ts"],"names":[],"mappings":";;AAIA,4CAWC;AAfD,0CAAgD;AAChD,+BAA4B;AAC5B,iDAA+E;AAE/E,SAAgB,gBAAgB;IAC9B,IAAA,yBAAa,EAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QACnC,OAAO,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,IAAA,wBAAY,EAAC,KAAK,EAAE,GAAW,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,MAAM,IAAA,kBAAO,EAAC,GAAG,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,IAAA,yBAAa,EAAC,CAAC,GAAG,KAAe,EAAE,EAAE,CAAC,IAAA,WAAI,EAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/tools/get-endpoint-schema.d.ts

@@ -0,0 +1,20 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const definition: Tool;
+export declare function handler(args: {
+    api: string;
+    method: string;
+    path: string;
+}): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: string;
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=get-endpoint-schema.d.ts.map

package/dist/tools/get-endpoint-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-endpoint-schema.d.ts","sourceRoot":"","sources":["../../src/tools/get-endpoint-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,eAAO,MAAM,UAAU,EAAE,IA2CxB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GA0ChF"}

package/dist/tools/get-endpoint-schema.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.definition = void 0;
+exports.handler = handler;
+const loader_js_1 = require("../core/loader.js");
+exports.definition = {
+    name: "get_endpoint_schema",
+    description: `Returns the full context for a specific endpoint including resolved URL, auth requirements, and schema.
+
+Use this to understand an endpoint before constructing a curl command to execute via the bash tool.
+Call this after list_endpoints to get the endpoint contract.
+
+## Auth Patterns
+
+| Auth in Schema | curl Header |
+|----------------|-------------|
+| \`None\` | No header |
+| \`bearer\` | \`-H 'Authorization: Bearer <TOKEN>'\` |
+| \`oauth2 <scopes>\` | \`-H 'Authorization: Bearer <TOKEN>'\` |
+| \`api_key <header>\` | \`-H '<header>: <KEY>'\` |
+| \`basic\` | \`-H 'Authorization: Basic <base64>'\` |
+
+## NOTATION Legend
+
+\`?\` optional | \`[ro]\` readOnly | \`[w]\` writeOnly | \`=val\` default
+\`^\` header | \`~\` cookie | \`*N\` multipleOf N | \`|\` enum or nullable
+\`OneOf<A,B>\` on field = discriminated union
+\`{*:T}\` = map/dict | \`{...}\` = open object | \`extends\` = allOf
+\`&\` = inline extension | \`~~name~~\` deprecated | \`#\` = inline note
+\`[multipart]\` \`[form]\` \`[binary]\` \`[text]\` = request body encoding`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            api: {
+                type: "string",
+                description: "API name matching the .mind filename",
+            },
+            method: {
+                type: "string",
+                description: "HTTP method (GET, POST, PUT, PATCH, DELETE)",
+            },
+            path: {
+                type: "string",
+                description: "Endpoint path",
+            },
+        },
+        required: ["api", "method", "path"],
+    },
+};
+async function handler(args) {
+    try {
+        const result = await (0, loader_js_1.getEndpointSchema)(args.api, args.method, args.path);
+        const envList = Object.entries(result.environments)
+            .map(([name, url]) => `  ${name}: ${url}`)
+            .join("\n");
+        const authLine = result.auth ? `Auth: ${result.auth}` : "Auth: None";
+        const output = `# API: ${result.title}
+# Base URL: ${result.defaultUrl}
+# Environments:
+${envList}
+
+## Endpoint
+${result.method} ${result.path}
+${authLine}
+
+## Schema
+${result.schema}`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: output,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=get-endpoint-schema.js.map

package/dist/tools/get-endpoint-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-endpoint-schema.js","sourceRoot":"","sources":["../../src/tools/get-endpoint-schema.ts"],"names":[],"mappings":";;;AAgDA,0BA0CC;AA1FD,iDAAsD;AAGzC,QAAA,UAAU,GAAS;IAC9B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;2EAsB4D;IACzE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,eAAe;aAC7B;SACF;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC;KACpC;CACF,CAAC;AAEK,KAAK,UAAU,OAAO,CAAC,IAAmD;IAC/E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAA,6BAAiB,EAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAEzE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;aAChD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,GAAG,EAAE,CAAC;aACzC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;QAErE,MAAM,MAAM,GAAG,UAAU,MAAM,CAAC,KAAK;cAC3B,MAAM,CAAC,UAAU;;EAE7B,OAAO;;;EAGP,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI;EAC5B,QAAQ;;;EAGR,MAAM,CAAC,MAAM,EAAE,CAAC;QAEd,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,UAAU,YAAY,EAAE;iBAC/B;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/list-apis.d.ts

@@ -0,0 +1,9 @@
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const definition: Tool;
+export declare function handler(args: Record<string, never>): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=list-apis.d.ts.map

package/dist/tools/list-apis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-apis.d.ts","sourceRoot":"","sources":["../../src/tools/list-apis.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAE/D,eAAO,MAAM,UAAU,EAAE,IAUxB,CAAC;AAEF,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;;;;;GAUxD"}