@astramindapp/mcp-server 0.1.0

package/dist/setup.js

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * MIND MCP Server — Interactive Setup Wizard
+ *
+ * Usage:
+ *   npx @mindapp/mcp-server setup
+ *   mind-mcp-setup
+ *
+ * Auto-detects installed AI tools and configures MIND as their memory layer.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const readline = __importStar(require("readline"));
+const HOME = os.homedir();
+function getToolConfigs() {
+    const platform = process.platform;
+    const tools = [];
+    // Claude Desktop
+    if (platform === "darwin") {
+        tools.push({
+            name: "Claude Desktop",
+            configPath: path.join(HOME, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+            configKey: "mcpServers",
+            detected: false,
+        });
+    }
+    else if (platform === "win32") {
+        tools.push({
+            name: "Claude Desktop",
+            configPath: path.join(process.env.APPDATA ?? path.join(HOME, "AppData", "Roaming"), "Claude", "claude_desktop_config.json"),
+            configKey: "mcpServers",
+            detected: false,
+        });
+    }
+    else {
+        // Linux
+        tools.push({
+            name: "Claude Desktop",
+            configPath: path.join(HOME, ".config", "Claude", "claude_desktop_config.json"),
+            configKey: "mcpServers",
+            detected: false,
+        });
+    }
+    // Cursor
+    const cursorConfig = path.join(HOME, ".cursor", "mcp.json");
+    tools.push({
+        name: "Cursor",
+        configPath: cursorConfig,
+        configKey: "mcpServers",
+        detected: false,
+    });
+    // Windsurf
+    const windsurfConfig = path.join(HOME, ".windsurf", "mcp.json");
+    tools.push({
+        name: "Windsurf",
+        configPath: windsurfConfig,
+        configKey: "mcpServers",
+        detected: false,
+    });
+    // VS Code (Copilot MCP)
+    const vscodeConfig = path.join(HOME, ".vscode", "mcp.json");
+    tools.push({
+        name: "VS Code (Copilot)",
+        configPath: vscodeConfig,
+        configKey: "servers",
+        detected: false,
+    });
+    // Detect which tools exist
+    for (const tool of tools) {
+        const configDir = path.dirname(tool.configPath);
+        tool.detected = fs.existsSync(configDir);
+    }
+    return tools;
+}
+// ─── CLI Helpers ──────────────────────────────────────────
+function createRL() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+function ask(rl, question) {
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => resolve(answer.trim()));
+    });
+}
+function print(msg) {
+    console.log(msg);
+}
+function printHeader() {
+    print("");
+    print("╔══════════════════════════════════════════╗");
+    print("║     🧠 MIND MCP Server — Setup Wizard    ║");
+    print("║  Give your AI agents persistent memory   ║");
+    print("╚══════════════════════════════════════════╝");
+    print("");
+}
+// ─── Config Writing ───────────────────────────────────────
+function getMindServerConfig(apiKey) {
+    // Use the globally installed CLI path, or fall back to local
+    const cliPath = path.resolve(__dirname, "cli.js");
+    return {
+        command: "node",
+        args: [cliPath],
+        env: {
+            MIND_API_KEY: apiKey,
+        },
+    };
+}
+function writeToolConfig(tool, apiKey) {
+    try {
+        const configDir = path.dirname(tool.configPath);
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        let config = {};
+        if (fs.existsSync(tool.configPath)) {
+            try {
+                const raw = fs.readFileSync(tool.configPath, "utf-8");
+                config = JSON.parse(raw);
+            }
+            catch {
+                // If the file exists but is invalid JSON, start fresh
+                config = {};
+            }
+        }
+        // Get or create the MCP servers section
+        const serversKey = tool.configKey;
+        if (!config[serversKey] || typeof config[serversKey] !== "object") {
+            config[serversKey] = {};
+        }
+        // Add MIND server
+        config[serversKey]["mind"] =
+            getMindServerConfig(apiKey);
+        // Write back
+        fs.writeFileSync(tool.configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+// ─── API Key Validation ──────────────────────────────────
+async function validateApiKey(apiKey, baseUrl) {
+    try {
+        const res = await fetch(`${baseUrl}/developer/v1/profile`, {
+            headers: { "X-API-Key": apiKey },
+        });
+        if (res.ok) {
+            return { valid: true };
+        }
+        return { valid: false, error: `API returned ${res.status}: ${res.statusText}` };
+    }
+    catch (err) {
+        return { valid: false, error: String(err) };
+    }
+}
+// ─── Main ─────────────────────────────────────────────────
+async function main() {
+    printHeader();
+    const rl = createRL();
+    // Step 1: API Key
+    print("Step 1: Connect to your MIND");
+    print("─────────────────────────────");
+    print("You need a MIND API key. Get one at: https://m-i-n-d.ai → Settings → Developer → API Keys");
+    print("");
+    let apiKey = process.env.MIND_API_KEY ?? "";
+    if (apiKey) {
+        print(`Found MIND_API_KEY in environment: ${apiKey.slice(0, 12)}...`);
+        const useExisting = await ask(rl, "Use this key? (Y/n): ");
+        if (useExisting.toLowerCase() === "n") {
+            apiKey = "";
+        }
+    }
+    if (!apiKey) {
+        apiKey = await ask(rl, "Paste your MIND API key: ");
+    }
+    if (!apiKey) {
+        print("\n❌ No API key provided. Exiting.");
+        rl.close();
+        process.exit(1);
+    }
+    // Validate
+    const baseUrl = process.env.MIND_BASE_URL ?? "https://m-i-n-d.ai";
+    print("\nValidating API key...");
+    const validation = await validateApiKey(apiKey, baseUrl);
+    if (!validation.valid) {
+        print(`\n⚠️  Could not validate key: ${validation.error}`);
+        const proceed = await ask(rl, "Continue anyway? (y/N): ");
+        if (proceed.toLowerCase() !== "y") {
+            rl.close();
+            process.exit(1);
+        }
+    }
+    else {
+        print("✅ API key is valid!\n");
+    }
+    // Step 2: Detect AI tools
+    print("Step 2: Detect your AI tools");
+    print("─────────────────────────────");
+    const tools = getToolConfigs();
+    const detected = tools.filter((t) => t.detected);
+    const notDetected = tools.filter((t) => !t.detected);
+    if (detected.length > 0) {
+        print("Found these AI tools on your machine:");
+        for (const tool of detected) {
+            print(`  ✅ ${tool.name}`);
+        }
+    }
+    if (notDetected.length > 0) {
+        print("\nNot detected (you can still configure manually):");
+        for (const tool of notDetected) {
+            print(`  ⬜ ${tool.name}`);
+        }
+    }
+    print("");
+    // Step 3: Configure each detected tool
+    print("Step 3: Configure MIND memory");
+    print("──────────────────────────────");
+    const configured = [];
+    for (const tool of detected) {
+        const answer = await ask(rl, `Add MIND to ${tool.name}? (Y/n): `);
+        if (answer.toLowerCase() === "n") {
+            print(`  ⏭️  Skipped ${tool.name}`);
+            continue;
+        }
+        const result = writeToolConfig(tool, apiKey);
+        if (result.success) {
+            print(`  ✅ ${tool.name} configured!`);
+            configured.push(tool.name);
+        }
+        else {
+            print(`  ❌ Failed: ${result.error}`);
+        }
+    }
+    // Also offer non-detected tools
+    for (const tool of notDetected) {
+        const answer = await ask(rl, `Configure MIND for ${tool.name} anyway? (y/N): `);
+        if (answer.toLowerCase() !== "y")
+            continue;
+        const result = writeToolConfig(tool, apiKey);
+        if (result.success) {
+            print(`  ✅ ${tool.name} configured!`);
+            configured.push(tool.name);
+        }
+        else {
+            print(`  ❌ Failed: ${result.error}`);
+        }
+    }
+    // Done
+    print("");
+    print("══════════════════════════════════════════");
+    print("🧠 MIND MCP Server setup complete!");
+    print("══════════════════════════════════════════");
+    print("");
+    if (configured.length > 0) {
+        print("Configured for:");
+        for (const name of configured) {
+            print(`  ✅ ${name}`);
+        }
+        print("");
+        print("⚠️  Restart your AI tools for changes to take effect.");
+        print("   (Fully quit and reopen — not just close the window)");
+    }
+    else {
+        print("No tools configured. You can run this again anytime:");
+        print("  npx @mindapp/mcp-server setup");
+    }
+    print("");
+    print("Your AI agents now have persistent memory. 🧠");
+    print("Everything they learn gets stored in your MIND knowledge graph.");
+    print("");
+    rl.close();
+}
+// Entry point
+const args = process.argv.slice(2);
+if (args.includes("setup") || args.includes("--setup")) {
+    main().catch((err) => {
+        console.error("Setup failed:", err);
+        process.exit(1);
+    });
+}
+else {
+    // If called directly without "setup", show help
+    print("MIND MCP Server Setup");
+    print("");
+    print("Usage:");
+    print("  mind-mcp-setup          Run interactive setup wizard");
+    print("  mind-mcp-setup setup    Same as above");
+    print("");
+    main().catch((err) => {
+        console.error("Setup failed:", err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@astramindapp/mcp-server",
+  "version": "0.1.0",
+  "description": "MIND MCP Server — Universal AI memory layer. Give any LLM agent persistent memory, structured context, and automatic knowledge capture via the Model Context Protocol.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "mind-mcp": "dist/cli.js",
+    "mind-mcp-setup": "dist/setup.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "start": "node dist/cli.js",
+    "lint": "eslint src/",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-memory",
+    "knowledge-graph",
+    "llm",
+    "mind",
+    "mindapp"
+  ],
+  "author": "Astra AI <hello@theastraway.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/theastraway/MINDapp.git",
+    "directory": "mcp-server"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "tsx": "^4.19.0",
+    "vitest": "^3.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * MIND MCP Server — CLI Entry Point
+ *
+ * Usage:
+ *   MIND_API_KEY=mind_xxx mind-mcp
+ *   MIND_API_KEY=mind_xxx MIND_BASE_URL=https://m-i-n-d.ai mind-mcp
+ *
+ * Environment variables:
+ *   MIND_API_KEY   — Required. Your MIND Developer API key.
+ *   MIND_BASE_URL  — Optional. Defaults to https://m-i-n-d.ai
+ */
+
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { MindClient } from "./mind-client.js";
+import { createMindMcpServer } from "./server.js";
+
+const API_KEY = process.env.MIND_API_KEY;
+const BASE_URL = process.env.MIND_BASE_URL ?? "https://m-i-n-d.ai";
+
+if (!API_KEY) {
+  console.error(
+    "Error: MIND_API_KEY environment variable is required.\n" +
+      "Get your API key at https://m-i-n-d.ai → Settings → Developer → API Keys\n"
+  );
+  process.exit(1);
+}
+
+async function main() {
+  const apiKey = API_KEY!;
+  const client = new MindClient({ baseUrl: BASE_URL, apiKey });
+  const server = createMindMcpServer(client);
+  const transport = new StdioServerTransport();
+
+  await server.connect(transport);
+
+  // Log to stderr so it doesn't interfere with MCP stdio protocol
+  console.error(`MIND MCP Server v0.1.0 started`);
+  console.error(`  → Base URL: ${BASE_URL}`);
+  console.error(`  → API Key: ${apiKey.slice(0, 8)}...`);
+  console.error(`  → Tools: mind_query, mind_remember, mind_context, mind_life, mind_crm, mind_graph`);
+}
+
+main().catch((err) => {
+  console.error("Fatal error starting MIND MCP Server:", err);
+  process.exit(1);
+});

package/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * @mindapp/mcp-server
+ *
+ * MIND MCP Server — Universal AI memory layer.
+ * Give any LLM agent persistent memory via the Model Context Protocol.
+ *
+ * Programmatic usage:
+ *   import { createMindMcpServer, MindClient } from "@mindapp/mcp-server";
+ *   const client = new MindClient({ baseUrl: "https://m-i-n-d.ai", apiKey: "mind_xxx" });
+ *   const server = createMindMcpServer(client);
+ */
+
+export { createMindMcpServer } from "./server.js";
+export { MindClient } from "./mind-client.js";
+export type * from "./mind-client.js";