@astramindapp/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,136 @@
+# @mindapp/mcp-server
+
+**MIND MCP Server** — Give any AI agent persistent memory.
+
+Your AI agents forget everything between sessions. MIND fixes that. Connect any MCP-compatible tool to your personal knowledge graph and never lose context again.
+
+## What It Does
+
+| Tool | Description |
+|------|-------------|
+| `mind_query` | Search your knowledge graph — returns only what's relevant |
+| `mind_remember` | Store anything — auto-categorized as document, entry, or thought |
+| `mind_context` | Load your persistent identity, preferences, rules, and priorities |
+| `mind_life` | Manage goals, projects, and tasks |
+| `mind_crm` | Track contacts and relationships |
+| `mind_graph` | Check graph health and statistics |
+
+## Quick Start
+
+### 1. Get a MIND API Key
+
+Sign up at [m-i-n-d.ai](https://m-i-n-d.ai) → Settings → Developer → Create API Key
+
+### 2. Install
+
+```bash
+npm install -g @mindapp/mcp-server
+```
+
+### 3. Configure Your AI Tool
+
+#### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mind": {
+      "command": "mind-mcp",
+      "env": {
+        "MIND_API_KEY": "mind_your_key_here"
+      }
+    }
+  }
+}
+```
+
+#### Claude Code
+
+```bash
+claude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcp
+```
+
+#### OpenClaw
+
+Add to your OpenClaw config:
+
+```json5
+{
+  mcp: {
+    servers: {
+      mind: {
+        command: "mind-mcp",
+        env: { MIND_API_KEY: "mind_xxx" }
+      }
+    }
+  }
+}
+```
+
+#### Cursor
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "mind": {
+      "command": "mind-mcp",
+      "env": {
+        "MIND_API_KEY": "mind_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## How It Works
+
+```
+Your AI Agent ←→ MCP Protocol ←→ MIND MCP Server ←→ MIND Knowledge Graph
+```
+
+1. Agent calls `mind_context` at session start → gets identity, rules, priorities
+2. Agent calls `mind_query` before decisions → gets relevant memories
+3. Agent calls `mind_remember` after tasks → stores outcomes and learnings
+4. Next session, same agent (or different one!) has full context
+
+**Your knowledge graph grows from every tool you use.** What you learn in Claude Code is available in Cursor. What you decide in OpenClaw is remembered by Claude Desktop.
+
+## Why MIND vs. Flat File Memory
+
+| | Flat files (MEMORY.md) | MIND |
+|---|---|---|
+| Size limit | ~20K chars, then truncated | Unlimited graph |
+| Retrieval | Loads everything every turn | Only relevant memories |
+| Capture | Manual (agent must write) | Automatic categorization |
+| Cross-agent | One tool only | Shared across all agents |
+| Structure | Unstructured text | Knowledge graph with entities & relationships |
+| Search | Keyword/vector on small file | Hybrid semantic + graph traversal |
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `MIND_API_KEY` | Yes | — | Your MIND Developer API key |
+| `MIND_BASE_URL` | No | `https://m-i-n-d.ai` | MIND API base URL |
+
+## Programmatic Usage
+
+```typescript
+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);
+// Connect to any MCP transport
+```
+
+## License
+
+MIT — Astra AI

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+#!/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
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const mind_client_js_1 = require("./mind-client.js");
+const server_js_1 = require("./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 mind_client_js_1.MindClient({ baseUrl: BASE_URL, apiKey });
+    const server = (0, server_js_1.createMindMcpServer)(client);
+    const transport = new stdio_js_1.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);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;GAUG;;AAEH,wEAAiF;AACjF,qDAA8C;AAC9C,2CAAkD;AAElD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,oBAAoB,CAAC;AAEnE,IAAI,CAAC,OAAO,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CACX,yDAAyD;QACvD,4EAA4E,CAC/E,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAQ,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,2BAAU,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAA,+BAAmB,EAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,gEAAgE;IAChE,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAChD,OAAO,CAAC,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;AACvG,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.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";
+//# 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":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,mBAAmB,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * @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);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MindClient = exports.createMindMcpServer = void 0;
+var server_js_1 = require("./server.js");
+Object.defineProperty(exports, "createMindMcpServer", { enumerable: true, get: function () { return server_js_1.createMindMcpServer; } });
+var mind_client_js_1 = require("./mind-client.js");
+Object.defineProperty(exports, "MindClient", { enumerable: true, get: function () { return mind_client_js_1.MindClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,yCAAkD;AAAzC,gHAAA,mBAAmB,OAAA;AAC5B,mDAA8C;AAArC,4GAAA,UAAU,OAAA"}

package/dist/mind-client.d.ts

@@ -0,0 +1,172 @@
+/**
+ * MIND API Client
+ *
+ * Thin wrapper around the MIND Developer API.
+ * All methods return typed responses or throw on HTTP errors.
+ */
+export interface MindClientConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+export interface QueryRequest {
+    query: string;
+    mode?: "mix" | "graph" | "vector";
+    limit?: number;
+}
+export interface QueryResponse {
+    response: string;
+    sources: Array<{
+        id?: string;
+        title?: string;
+        content_preview?: string;
+        relevance_score?: number;
+    }>;
+    credits_used: number;
+    credits_remaining: number;
+}
+export interface DocumentCreateRequest {
+    title: string;
+    content: string;
+    source?: string;
+    tags?: string[];
+}
+export interface DocumentResponse {
+    id: string;
+    title: string;
+    source: string;
+    status: string;
+    created_at: string;
+    content_preview?: string;
+}
+export interface EntryCreateRequest {
+    title?: string;
+    content: string;
+    entry_type?: string;
+    tags?: string[];
+}
+export interface EntryResponse {
+    id?: string;
+    entry_id?: string;
+    title?: string;
+    content?: string;
+    entry_type?: string;
+    tags?: string[];
+    created_at?: string;
+}
+export interface ThoughtCreateRequest {
+    content: string;
+}
+export interface ThoughtResponse {
+    id?: string;
+    thought_id?: string;
+    content: string;
+    created_at?: string;
+}
+export interface LifeItemCreateRequest {
+    title: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    due_date?: string;
+}
+export interface LifeItemResponse {
+    item_id: string;
+    title: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    due_date?: string;
+    created_at?: string;
+}
+export interface CrmContactCreateRequest {
+    name: string;
+    email?: string;
+    company?: string;
+    type?: string;
+    stage?: string;
+    source?: string;
+    value?: number;
+    notes?: string;
+}
+export interface CrmContactResponse {
+    id?: string;
+    contact_id?: string;
+    name: string;
+    email?: string;
+    company?: string;
+    type?: string;
+    stage?: string;
+    created_at?: string;
+}
+export interface GraphInfoResponse {
+    total_entities: number;
+    total_relationships: number;
+    popular_labels?: Array<{
+        label: string | null;
+        count: number;
+    }>;
+    storage_status?: {
+        workspace_id: string;
+        status: string;
+    };
+}
+export interface ProfileResponse {
+    username: string;
+    tier?: string;
+    credits_remaining?: number;
+    [key: string]: unknown;
+}
+export interface InsightsResponse {
+    insights: Array<{
+        id?: string;
+        type?: string;
+        content?: string;
+        created_at?: string;
+    }>;
+}
+export declare class MindClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: MindClientConfig);
+    private request;
+    query(req: QueryRequest): Promise<QueryResponse>;
+    createDocument(req: DocumentCreateRequest): Promise<DocumentResponse>;
+    listDocuments(page?: number, pageSize?: number): Promise<{
+        documents: DocumentResponse[];
+    }>;
+    deleteDocument(docId: string): Promise<void>;
+    createEntry(req: EntryCreateRequest): Promise<EntryResponse>;
+    listEntries(limit?: number): Promise<{
+        entries: EntryResponse[];
+    }>;
+    deleteEntry(entryId: string): Promise<void>;
+    createThought(req: ThoughtCreateRequest): Promise<ThoughtResponse>;
+    listThoughts(): Promise<{
+        thoughts: ThoughtResponse[];
+    }>;
+    deleteThought(thoughtId: string): Promise<void>;
+    createLifeItem(req: LifeItemCreateRequest): Promise<LifeItemResponse>;
+    listLifeItems(status?: string, limit?: number): Promise<{
+        items: LifeItemResponse[];
+    }>;
+    updateLifeItem(itemId: string, patch: Partial<LifeItemCreateRequest & {
+        status: string;
+    }>): Promise<LifeItemResponse>;
+    deleteLifeItem(itemId: string): Promise<void>;
+    createContact(req: CrmContactCreateRequest): Promise<CrmContactResponse>;
+    listContacts(): Promise<{
+        contacts: CrmContactResponse[];
+    }>;
+    updateContact(contactId: string, patch: Partial<CrmContactCreateRequest>): Promise<CrmContactResponse>;
+    graphInfo(): Promise<GraphInfoResponse>;
+    profile(): Promise<ProfileResponse>;
+    credits(): Promise<{
+        credits_balance: number;
+        credits_limit: number;
+        tier: string;
+        documents_used: number;
+        documents_limit: number;
+    }>;
+    insights(): Promise<InsightsResponse>;
+}
+//# sourceMappingURL=mind-client.d.ts.map

package/dist/mind-client.d.ts.map

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

package/dist/mind-client.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * MIND API Client
+ *
+ * Thin wrapper around the MIND Developer API.
+ * All methods return typed responses or throw on HTTP errors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MindClient = void 0;
+class MindApiError extends Error {
+    status;
+    statusText;
+    body;
+    constructor(status, statusText, body) {
+        super(`MIND API error ${status}: ${statusText} — ${body}`);
+        this.status = status;
+        this.statusText = statusText;
+        this.body = body;
+        this.name = "MindApiError";
+    }
+}
+class MindClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+    }
+    async request(method, path, body, params) {
+        let url = `${this.baseUrl}${path}`;
+        if (params) {
+            const qs = new URLSearchParams(params).toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {
+            "X-API-Key": this.apiKey,
+            "Content-Type": "application/json",
+        };
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const text = await res.text();
+        if (!res.ok) {
+            throw new MindApiError(res.status, res.statusText, text);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    // ─── Query ──────────────────────────────────────────────
+    async query(req) {
+        return this.request("POST", "/developer/v1/query", req);
+    }
+    // ─── Documents ──────────────────────────────────────────
+    async createDocument(req) {
+        return this.request("POST", "/developer/v1/documents", req);
+    }
+    async listDocuments(page = 1, pageSize = 20) {
+        return this.request("GET", "/developer/v1/documents", undefined, {
+            page: String(page),
+            page_size: String(pageSize),
+        });
+    }
+    async deleteDocument(docId) {
+        await this.request("DELETE", `/developer/v1/documents/${docId}`);
+    }
+    // ─── Entries ────────────────────────────────────────────
+    async createEntry(req) {
+        return this.request("POST", "/developer/v1/entries", req);
+    }
+    async listEntries(limit = 20) {
+        return this.request("GET", "/developer/v1/entries", undefined, {
+            limit: String(limit),
+        });
+    }
+    async deleteEntry(entryId) {
+        await this.request("DELETE", `/developer/v1/entries/${entryId}`);
+    }
+    // ─── Thoughts ───────────────────────────────────────────
+    async createThought(req) {
+        return this.request("POST", "/developer/v1/thoughts", req);
+    }
+    async listThoughts() {
+        return this.request("GET", "/developer/v1/thoughts");
+    }
+    async deleteThought(thoughtId) {
+        await this.request("DELETE", `/developer/v1/thoughts/${thoughtId}`);
+    }
+    // ─── Life ───────────────────────────────────────────────
+    async createLifeItem(req) {
+        return this.request("POST", "/developer/v1/life/items", req);
+    }
+    async listLifeItems(status, limit = 30) {
+        const params = { limit: String(limit) };
+        if (status)
+            params.status = status;
+        return this.request("GET", "/developer/v1/life/items", undefined, params);
+    }
+    async updateLifeItem(itemId, patch) {
+        return this.request("PATCH", `/developer/v1/life/items/${itemId}`, patch);
+    }
+    async deleteLifeItem(itemId) {
+        await this.request("DELETE", `/developer/v1/life/items/${itemId}`);
+    }
+    // ─── CRM ────────────────────────────────────────────────
+    async createContact(req) {
+        return this.request("POST", "/developer/v1/crm/contacts", req);
+    }
+    async listContacts() {
+        return this.request("GET", "/developer/v1/crm/contacts");
+    }
+    async updateContact(contactId, patch) {
+        return this.request("PATCH", `/developer/v1/crm/contacts/${contactId}`, patch);
+    }
+    // ─── Graph ──────────────────────────────────────────────
+    async graphInfo() {
+        return this.request("GET", "/developer/v1/graph");
+    }
+    // ─── Profile / Credits ─────────────────────────────────
+    async profile() {
+        return this.request("GET", "/developer/v1/profile");
+    }
+    async credits() {
+        return this.request("GET", "/developer/v1/credits");
+    }
+    // ─── Insights ───────────────────────────────────────────
+    async insights() {
+        return this.request("GET", "/developer/v1/insights");
+    }
+}
+exports.MindClient = MindClient;
+//# sourceMappingURL=mind-client.js.map

package/dist/mind-client.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MIND MCP Server
+ *
+ * Exposes the MIND knowledge graph as MCP tools that any LLM agent can use.
+ * This is the universal AI memory layer.
+ *
+ * Tools:
+ *   mind_query     — Semantic search across the knowledge graph
+ *   mind_remember  — Store content to the graph (auto-categorized)
+ *   mind_context   — Get structured always-loaded context (soul/user/rules)
+ *   mind_life      — Read/write goals, projects, tasks
+ *   mind_crm       — Read/write contacts and interactions
+ *   mind_graph     — Get graph statistics and health
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { MindClient } from "./mind-client.js";
+export declare function createMindMcpServer(client: MindClient): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAqbjE"}