@msegoviadev/api-mind-mcp 0.1.0

package/dist/tools/list-apis.js

@@ -0,0 +1,28 @@
+"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: "list_apis",
+    description: `Lists all APIs loaded from the specs folder, with their names, titles, base URLs, and available environments.
+
+Use this when you need to know what APIs are loaded or what environments a specific API supports.
+Call this first when the user references an API you haven't seen yet.`,
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};
+async function handler(args) {
+    const result = await (0, loader_js_1.listApis)();
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-apis.js.map

package/dist/tools/list-apis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-apis.js","sourceRoot":"","sources":["../../src/tools/list-apis.ts"],"names":[],"mappings":";;;AAeA,0BAUC;AAzBD,iDAA6C;AAGhC,QAAA,UAAU,GAAS;IAC9B,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE;;;sEAGuD;IACpE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;KACf;CACF,CAAC;AAEK,KAAK,UAAU,OAAO,CAAC,IAA2B;IACvD,MAAM,MAAM,GAAG,MAAM,IAAA,oBAAQ,GAAE,CAAC;IAChC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

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

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

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

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

package/dist/tools/list-endpoints.js

@@ -0,0 +1,33 @@
+"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: "list_endpoints",
+    description: `Lists all available endpoints across all loaded .mind files. Also surfaces the available environment names.
+
+Use this to discover what endpoints exist across all APIs. Filter by method, path, or section.
+Call this when the user references an API or asks what's available.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            filter: {
+                type: "string",
+                description: "Substring match on method, path, or section name",
+            },
+        },
+    },
+};
+async function handler(args) {
+    const result = await (0, loader_js_1.listEndpoints)(args.filter);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(result, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-endpoints.js.map

package/dist/tools/list-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-endpoints.js","sourceRoot":"","sources":["../../src/tools/list-endpoints.ts"],"names":[],"mappings":";;;AAoBA,0BAUC;AA9BD,iDAAkD;AAGrC,QAAA,UAAU,GAAS;IAC9B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EAAE;;;oEAGqD;IAClE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;SACF;KACF;CACF,CAAC;AAEK,KAAK,UAAU,OAAO,CAAC,IAAyB;IACrD,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAa,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC;SACF;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@msegoviadev/api-mind-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for API discovery from .mind spec files",
+  "main": "./dist/index.js",
+  "bin": {
+    "api-mind-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "test": "node --experimental-strip-types test/test.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "api",
+    "discovery",
+    "openapi",
+    "model-context-protocol",
+    "claude-code",
+    "llm"
+  ],
+  "author": {
+    "name": "msegoviadev",
+    "email": "marcos@msegovia.dev"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/msegoviadev/api-mind-mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/msegoviadev/api-mind-mcp/issues"
+  },
+  "homepage": "https://github.com/msegoviadev/api-mind-mcp#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "setup-mcp.sh.example"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/setup-mcp.sh.example

@@ -0,0 +1,41 @@
+#!/bin/bash
+# Example setup script for api-mind MCP server
+# Run this once after cloning the repository
+
+set -e
+
+PROJECT_ROOT="$(cd "$(dirname "$0")" && pwd)"
+SPECS_DIR="${PROJECT_ROOT}/specs"
+
+echo "Setting up api-mind MCP server..."
+echo "Project root: ${PROJECT_ROOT}"
+echo "Specs directory: ${SPECS_DIR}"
+
+# Check if specs directory exists
+if [ ! -d "$SPECS_DIR" ]; then
+  echo "Creating specs directory..."
+  mkdir -p "$SPECS_DIR"
+fi
+
+# Check for .mind files
+MIND_FILES=$(find "$SPECS_DIR" -name "*.mind" 2>/dev/null | wc -l | tr -d ' ')
+if [ "$MIND_FILES" -eq 0 ]; then
+  echo ""
+  echo "⚠️  No .mind files found in $SPECS_DIR"
+  echo "Generate them with: spec-mind sync --no-notation ./specs/"
+  echo ""
+fi
+
+# Add MCP server to Claude Code
+echo "Adding api-mind to Claude Code..."
+claude mcp add --transport stdio --scope project api-mind \
+  --env SPECS_DIR="$SPECS_DIR" \
+  -- npx -y @msegoviadev/api-mind-mcp
+
+echo ""
+echo "✓ api-mind configured successfully!"
+echo ""
+echo "Next steps:"
+echo "1. Add OpenAPI specs to: ${SPECS_DIR}/"
+echo "2. Generate .mind files: spec-mind sync --no-notation ./specs/"
+echo "3. Restart Claude Code"