heady-mcp-server 3.2.0

package/README.md

@@ -0,0 +1,41 @@
+# @heady/mcp-server
+
+> Model Context Protocol (MCP) server for the Heady™ AI Platform — tool registration, memory operations, and JSON-RPC 2.0 handling.
+
+## Install
+
+```bash
+npm install @heady/mcp-server
+```
+
+## Quick Start
+
+```ts
+import { MCPServer } from '@heady/mcp-server';
+
+const server = new MCPServer();
+
+// Handle an MCP request
+const response = await server.handleRequest({
+  jsonrpc: '2.0',
+  id: 1,
+  method: 'tools/call',
+  params: {
+    name: 'memory.store',
+    arguments: { userId: 'user-1', x: 0, y: 0, z: 0, embedding: [1,2,3], metadata: {} }
+  }
+});
+```
+
+## Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| `memory.store` | Store a 3D vector memory |
+| `memory.query` | Cosine-similarity search |
+| `memory.stats` | User memory statistics |
+| `server.health` | Server health check |
+
+## License
+
+Proprietary — © 2026 HeadySystems Inc.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface MCPRequest {
+    jsonrpc: '2.0';
+    id: string | number;
+    method: string;
+    params?: any;
+}
+export interface MCPResponse {
+    jsonrpc: '2.0';
+    id: string | number;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export declare class MCPServer {
+    private memoryStore;
+    private tools;
+    private startTime;
+    constructor();
+    private registerTools;
+    handleRequest(request: MCPRequest): Promise<MCPResponse>;
+}
+//# 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":"AAEA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,SAAS,CAAc;;IAM/B,OAAO,CAAC,aAAa;IA8Bf,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;CA6C/D"}

package/dist/index.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPServer = void 0;
+const vector_memory_1 = require("@heady/vector-memory");
+class MCPServer {
+    memoryStore = new vector_memory_1.VectorMemoryStore();
+    tools = new Map();
+    startTime = Date.now();
+    constructor() {
+        this.registerTools();
+    }
+    registerTools() {
+        this.tools.set('memory.store', (params) => {
+            const { userId, x, y, z, embedding, metadata } = params;
+            const memory = { x, y, z, embedding, metadata, timestamp: Date.now() };
+            this.memoryStore.store(userId, memory);
+            return { success: true, timestamp: memory.timestamp };
+        });
+        this.tools.set('memory.query', (params) => {
+            const { userId, embedding, limit } = params;
+            const results = this.memoryStore.query(userId, embedding, limit);
+            return { results, count: results.length };
+        });
+        this.tools.set('memory.stats', (params) => {
+            const { userId } = params;
+            return this.memoryStore.getStats(userId);
+        });
+        this.tools.set('server.health', () => {
+            const uptimeMs = Date.now() - this.startTime;
+            return {
+                status: 'healthy',
+                version: '3.2.0',
+                uptime: uptimeMs / 1000,
+                timestamp: Date.now()
+            };
+        });
+    }
+    async handleRequest(request) {
+        if (request.method === 'tools/list') {
+            return {
+                jsonrpc: '2.0',
+                id: request.id,
+                result: {
+                    tools: Array.from(this.tools.keys()).map(name => ({
+                        name,
+                        description: `Tool: ${name}`,
+                        inputSchema: { type: 'object' }
+                    }))
+                }
+            };
+        }
+        if (request.method === 'tools/call') {
+            const { name, arguments: args } = request.params;
+            const tool = this.tools.get(name);
+            if (!tool) {
+                return {
+                    jsonrpc: '2.0',
+                    id: request.id,
+                    error: { code: -32601, message: `Tool not found: ${name}` }
+                };
+            }
+            try {
+                const result = await tool(args);
+                return { jsonrpc: '2.0', id: request.id, result };
+            }
+            catch (error) {
+                return {
+                    jsonrpc: '2.0',
+                    id: request.id,
+                    error: { code: -32603, message: error.message }
+                };
+            }
+        }
+        return {
+            jsonrpc: '2.0',
+            id: request.id,
+            error: { code: -32601, message: 'Method not found' }
+        };
+    }
+}
+exports.MCPServer = MCPServer;
+//# 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,wDAAmE;AAgBnE,MAAa,SAAS;IACZ,WAAW,GAAG,IAAI,iCAAiB,EAAE,CAAC;IACtC,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IACpC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE/B;QACE,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,MAAW,EAAE,EAAE;YAC7C,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;YACxD,MAAM,MAAM,GAAa,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;YACjF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;QACxD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,MAAW,EAAE,EAAE;YAC7C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,MAAW,EAAE,EAAE;YAC7C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;YAC1B,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,GAAG,EAAE;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YAC7C,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,QAAQ,GAAG,IAAI;gBACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAmB;QACrC,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACpC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,MAAM,EAAE;oBACN,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAChD,IAAI;wBACJ,WAAW,EAAE,SAAS,IAAI,EAAE;wBAC5B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;qBAChC,CAAC,CAAC;iBACJ;aACF,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACpC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAElC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,IAAI,EAAE,EAAE;iBAC5D,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;YACpD,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;iBAChD,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE;SACrD,CAAC;IACJ,CAAC;CACF;AApFD,8BAoFC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "heady-mcp-server",
+  "version": "3.2.0",
+  "description": "Model Context Protocol (MCP) server implementation for the Heady AI Platform — tool registration, memory operations, and JSON-RPC handling.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "heady-core": "^3.2.0",
+    "heady-vector-memory": "^3.2.0"
+  },
+  "license": "UNLICENSED",
+  "author": {
+    "name": "HeadySystems Inc.",
+    "email": "eric@headyconnection.org",
+    "url": "https://headyme.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HeadyMe/heady-production.git",
+    "directory": "packages/mcp-server"
+  },
+  "homepage": "https://headysystems.com",
+  "bugs": {
+    "url": "https://github.com/HeadyMe/heady-production/issues"
+  },
+  "keywords": [
+    "heady",
+    "ai",
+    "mcp",
+    "model-context-protocol",
+    "json-rpc",
+    "tools",
+    "multi-agent"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}