npm - @ekkos/mcp-server - Versions diffs - 2.0.0 → 2.0.1 - Mend

@ekkos/mcp-server 2.0.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -1,46 +1,30 @@
-# ekkOS™ Memory MCP Server
+# @ekkos/mcp-server
-Give your AI agent (Claude, GPT-4, etc.) in Cursor, Windsurf, or VS Code a persistent memory. It remembers solutions, learns from mistakes, and gets smarter over time.
-> Last updated: 2025-01-13 (testing all secrets)
+Stdio-to-SSE bridge for [ekkOS](https://ekkos.dev) Memory substrate. Enables AI tools like Claude Code and Cursor to access your persistent memory via the Model Context Protocol (MCP).
 ## Quick Start
-### 1. Install
-```bash
-npm install -g @ekkos/mcp-server
-```
-### 2. Get Your API Key
+### Claude Code
-1. Visit https://platform.ekkos.dev
-2. Sign in or create an account
-3. Copy your API key from the dashboard
-4. Copy your User ID from your profile
-### 3. Configure Your IDE
-**For Cursor:** Add to `~/.cursor/mcp.json`
-**For Windsurf:** Add to `~/.codeium/windsurf/mcp_config.json`
+Add to `~/.claude/settings.json`:
 ```json
 {
   "mcpServers": {
     "ekkos-memory": {
-      "url": "https://mcp.ekkos.dev/api/v1/mcp/sse?api_key=your-api-key-here",
-      "transport": "sse",
-      "headers": {
-        "Authorization": "Bearer your-api-key-here",
-        "X-User-ID": "your-user-id-here"
+      "command": "npx",
+      "args": ["-y", "@ekkos/mcp-server"],
+      "env": {
+        "EKKOS_API_KEY": "your_api_key_here"
       }
     }
   }
 }
 ```
-**For Claude Code:** Add to `~/.claude/settings.json`
+### Cursor
+Add to `.cursor/mcp.json` in your project:
 ```json
 {
@@ -49,281 +33,135 @@ npm install -g @ekkos/mcp-server
       "command": "npx",
       "args": ["-y", "@ekkos/mcp-server"],
       "env": {
-        "EKKOS_API_KEY": "your-api-key-here",
-        "EKKOS_USER_ID": "your-user-id-here"
+        "EKKOS_API_KEY": "your_api_key_here"
       }
     }
   }
 }
 ```
-### 4. Restart Your IDE
-The MCP server will be available in all chat sessions. Your AI can now remember!
-## How It Works
-Your AI agent can now access a 10-layer memory system that stores:
-- **Patterns** - Proven solutions that worked
-- **Conversations** - Past discussions and problem-solving sessions
-- **Directives** - Rules your AI must follow (MUST/NEVER/PREFER/AVOID)
-- **Codebase** - Semantic search across your project
-- **And more** - Episodic memory, procedural workflows, collective knowledge
-When you ask a question, your AI searches this memory first, finds relevant solutions, and applies them automatically.
-## Core Tools
-### `search_memory` 🔍
-**What it does:** Searches all your memory layers to find relevant patterns, solutions, and past conversations.
-**When to use:** Your AI calls this automatically before answering technical questions. It's the primary way your AI remembers.
-**Example:**
-```
-You: "How did we fix the auth timeout issue?"
-AI: [Searches memory automatically]
-    "Found it! We used the auth-timeout-mitigation pattern
-     from last week. Here's the solution..."
-```
-**What you get back:**
-- Relevant patterns with success rates
-- Past conversations about similar problems
-- Code examples that worked
-- Solutions sorted by how well they worked
----
-### `forge_pattern` 🔥
-**What it does:** Saves a solution that worked as a reusable pattern. Future AI agents (including yourself) will find it automatically.
-**When to use:** After you solve a problem, fix a bug, or discover a better approach. Your AI should call this automatically, but you can also trigger it.
-**Example:**
-```
-AI: [After fixing a bug]
-    "I've saved this solution as a pattern. Next time we
-     encounter this issue, I'll remember the fix instantly."
-```
-**What happens:**
-- Pattern is stored in memory
-- Becomes searchable immediately
-- Success rate tracked over time
-- Automatically suggested for similar problems
----
-### `forge_directive` 📜
-**What it does:** Creates a rule your AI must follow. These are MUST/NEVER/PREFER/AVOID rules that guide behavior.
-**When to use:** When you want to establish permanent rules for how your AI should behave.
-**Example:**
-```
-You: "Always use TypeScript strict mode"
-AI: [Creates directive]
-    "Rule saved. I'll always use strict mode going forward."
-```
-**Types of rules:**
-- **MUST** - Always do this (highest priority)
-- **NEVER** - Never do this (high priority)
-- **PREFER** - Prefer this approach (medium priority)
-- **AVOID** - Try to avoid this (lower priority)
-**What happens:**
-- Rule is enforced in all future interactions
-- AI checks against rules before taking actions
-- Rules can be project-specific or global
----
-### `recall_conversation` 💬
-**What it does:** Finds past conversations about a topic, even from days or weeks ago.
-**When to use:** When you want to remember what you discussed before, or check if you've already solved a problem.
-**Example:**
-```
-You: "What did we decide about the database schema?"
-AI: [Searches past conversations]
-    "We discussed this 2 weeks ago. You decided to use
-     PostgreSQL with JSONB for flexible fields..."
-```
-**What you get back:**
-- Relevant excerpts from past conversations
-- Context about decisions made
-- Solutions you've tried before
-- Semantic matches (finds related topics, not just keywords)
----
-### `check_conflict` ⚖️
-**What it does:** Validates an action against your rules and patterns before executing it. Prevents your AI from doing something that violates your preferences.
-**When to use:** Before executing destructive operations, deploying changes, or modifying critical configs.
-**Example:**
-```
-AI: [Before deleting files]
-    "I want to delete /tmp files. Let me check if this
-     violates any rules..."
-    [Checks conflicts]
-    "⚠️ CONFLICT: This violates NEVER rule: 'Never delete
-     files without user confirmation'. I'll ask first."
-```
-**What you get back:**
-- List of violated rules (if any)
-- Conflicting patterns
-- Recommendations to proceed safely
-- Clear explanation of why it conflicts
----
-## How to Use It Day-to-Day
-### When Starting Work
-Your AI automatically searches memory when you ask questions. You don't need to do anything special - just ask:
-```
-You: "Fix the authentication bug"
-AI: [Searches memory] "Found 3 solutions from past work..."
-```
-### When Solving Problems
-After your AI solves something, it should automatically save it as a pattern:
-```
-AI: [After fixing bug]
-    "Solution saved. Future agents will find this automatically."
-```
-If it doesn't, you can remind it:
-```
-You: "Save this solution as a pattern"
-```
-### When Setting Rules
-Tell your AI what you want it to always/never do:
+### Get Your API Key
-```
-You: "Never use `any` type in TypeScript"
-AI: [Creates directive] "Rule saved. I'll avoid `any` going forward."
-```
+1. Go to [platform.ekkos.dev](https://platform.ekkos.dev)
+2. Sign up or log in
+3. Navigate to **Settings → API Keys**
+4. Click **"Generate New Key"**
-### When Checking Past Work
+## Environment Variables
-Ask about past conversations:
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `EKKOS_API_KEY` | Yes | Your ekkOS API key from platform.ekkos.dev |
+| `EKKOS_USER_ID` | No | Your user ID (optional, for better tracking) |
+| `EKKOS_MCP_URL` | No | Custom MCP gateway URL (default: https://mcp.ekkos.dev/api/v1/mcp/sse) |
+| `EKKOS_DEBUG` | No | Set to `true` for debug logs |
-```
-You: "What did we decide about the API structure?"
-AI: [Searches conversations] "We discussed this last week..."
-```
-## The Golden Loop
-ekkOS uses a continuous learning cycle that makes your AI smarter:
-1. **Retrieve** - `search_memory` finds relevant patterns
-2. **Apply** - AI uses patterns to solve problems
-3. **Measure** - System tracks if solutions worked
-4. **Learn** - `forge_pattern` saves new solutions
+## How It Works
-This creates a self-improving system. Every problem solved makes future problems easier.
+This package creates a bridge between:
+- **Stdio transport** (used by AI tools like Claude Code)
+- **SSE transport** (used by ekkOS cloud memory substrate)
+When your AI tool starts the MCP server, this bridge:
+1. Connects to ekkOS cloud via SSE using your API key
+2. Exposes a stdio interface for your AI tool
+3. Forwards all MCP messages between stdio and SSE
+4. Handles authentication, reconnection, and error handling
+## 35 MCP Tools
+Your AI gets access to **35 memory tools** across 8 categories:
+### Core Memory (7)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Search` | Search all 11 memory layers for patterns, solutions, and context |
+| `ekkOS_Forge` | Create a new pattern from a learned solution |
+| `ekkOS_Directive` | Create user rules (MUST/NEVER/PREFER/AVOID) |
+| `ekkOS_Context` | Get relevant context for a task (episodes + patterns + plan) |
+| `ekkOS_Capture` | Capture a memory event (code change, chat, command, etc.) |
+| `ekkOS_Codebase` | Search project codebase embeddings |
+| `ekkOS_Recall` | Recall past conversations by time |
+### Pattern Tracking (4)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Track` | Track when a memory/pattern is applied |
+| `ekkOS_Outcome` | Record success/failure of applied patterns |
+| `ekkOS_Detect` | Auto-detect which patterns were used in a response |
+| `ekkOS_Reflect` | Analyze a response for improvement opportunities |
+### Utility (3)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Stats` | Get statistics for all memory layers |
+| `ekkOS_Summary` | Get human-readable summary of recent ekkOS activity |
+| `ekkOS_Conflict` | Check if proposed action conflicts with directives |
+### Plan Management (8)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Plan` | Create a new structured plan (steps for a task) |
+| `ekkOS_Plans` | List agent plans for the current user |
+| `ekkOS_PlanStatus` | Update plan status (draft/in_progress/completed/archived) |
+| `ekkOS_PlanStep` | Mark a plan step as complete or incomplete |
+| `ekkOS_Generate` | Generate a plan using LLM based on context |
+| `ekkOS_SaveTemplate` | Save a plan as a reusable template |
+| `ekkOS_Templates` | List available plan templates |
+| `ekkOS_FromTemplate` | Create a new plan from a template |
+### Secrets Management (5)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_StoreSecret` | Securely store sensitive data (API keys, passwords, tokens) |
+| `ekkOS_GetSecret` | Retrieve and decrypt a stored secret |
+| `ekkOS_ListSecrets` | List all stored secrets (metadata only, no values) |
+| `ekkOS_DeleteSecret` | Permanently delete a stored secret |
+| `ekkOS_RotateSecret` | Update a secret with a new value |
+### Schema Awareness (2)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_IndexSchema` | Index database/type schemas for field name awareness |
+| `ekkOS_GetSchema` | Get indexed schema for a specific table/type |
+### Portability (4)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_Export` | Export all memory data as portable JSON backup |
+| `ekkOS_Import` | Import memory data from backup (auto-deduplication) |
+| `ekkOS_Snapshot` | Create point-in-time memory snapshot |
+| `ekkOS_Sync` | Synchronize local memory with cloud |
+### Project Setup (2)
+| Tool | Description |
+|------|-------------|
+| `ekkOS_ProjectInit` | Initialize ekkOS for a new project |
+| `ekkOS_Ingest` | Bulk ingest data into memory layers |
 ## Troubleshooting
-### MCP Server Not Appearing
-- Make sure Node.js 18+ is installed
-- Check your API key is correct in the config file
-- Restart your IDE after adding the config
-- Check IDE logs for connection errors
-### No Patterns Found
-- You need to forge some patterns first (solve problems and save them)
-- Check your API key has access to your memory
-- Make sure `EKKOS_USER_ID` is set for user-scoped patterns
+### "EKKOS_API_KEY environment variable is required"
+You need to set your API key in the MCP config. Get one at [platform.ekkos.dev](https://platform.ekkos.dev/dashboard/settings/api-keys).
-### Authentication Errors
+### MCP server not loading
+1. Check Node.js version: `node --version` (must be 18+)
+2. Verify config JSON is valid
+3. Try running manually: `EKKOS_API_KEY=xxx npx @ekkos/mcp-server`
+4. Enable debug mode: `EKKOS_DEBUG=true` in env
-- Verify your API key at https://platform.ekkos.dev
-- Check the key hasn't expired
-- Make sure the key has correct permissions
+### Connection errors
+1. Check your internet connection
+2. Verify API key is correct and active
+3. Check https://ekkos.dev/status for service status
-## What Gets Stored
+## Support
-Your memory includes:
-- **Patterns** - Solutions that worked, with success rates
-- **Conversations** - Past discussions, searchable semantically
-- **Directives** - Rules your AI follows (MUST/NEVER/PREFER/AVOID)
-- **Codebase** - Semantic search across your project files
-- **Episodic** - Problem-solving sessions and workflows
-- **Procedural** - Step-by-step processes that worked
-- **Collective** - Knowledge shared across AI agents
-- **Code** - Code embeddings for finding similar code
-All of this is searchable instantly when your AI needs it.
-## Example Workflow
-```
-1. You: "Fix the login bug"
-2. AI: [Calls search_memory("login bug fix")]
-    "Found 2 patterns from past work. Applying the
-     highest-success solution..."
-3. AI: [Fixes bug using pattern]
-    "Fixed! This solution has worked 8 times before."
-4. AI: [Calls forge_pattern automatically]
-    "Saved this fix as a pattern for next time."
-5. Next time: AI remembers instantly and applies the fix
-```
-## Related
-- **Platform Dashboard**: https://platform.ekkos.dev
-- **Documentation**: https://docs.ekkos.dev
-- **GitHub**: https://github.com/ekkos-ai/ekkos
+- [Documentation](https://docs.ekkos.dev)
+- [Discord Community](https://discord.gg/w2JGepq9qZ)
+- [Report Issues](https://github.com/ekkos-ai/ekkos/issues)
+- [Email Support](mailto:support@ekkos.dev)
 ## License
-MIT
----
-**ekkOS™** - The memory substrate for AI agents. Making AI smarter, one pattern at a time. 🧠♾️
+MIT License - see [LICENSE](LICENSE) for details

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @ekkos/mcp-server
+ *
+ * Simple stdio proxy to ekkOS cloud MCP gateway.
+ * This creates a local MCP server that forwards all requests to https://mcp.ekkos.dev
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

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

package/dist/index.js ADDED Viewed

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+/**
+ * @ekkos/mcp-server
+ *
+ * Simple stdio proxy to ekkOS cloud MCP gateway.
+ * This creates a local MCP server that forwards all requests to https://mcp.ekkos.dev
+ */
+// Sentry must be imported and initialized before other imports
+import * as Sentry from '@sentry/node';
+// Only initialize Sentry if DSN is provided via env var
+if (process.env.SENTRY_DSN) {
+    Sentry.init({
+        dsn: process.env.SENTRY_DSN,
+        environment: process.env.NODE_ENV || 'production',
+        tracesSampleRate: 1.0,
+        sendDefaultPii: true,
+    });
+}
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+// Configuration
+const EKKOS_API_KEY = process.env.EKKOS_API_KEY || '';
+const EKKOS_USER_ID = process.env.EKKOS_USER_ID || '';
+const EKKOS_MCP_URL = process.env.EKKOS_MCP_URL || 'https://mcp.ekkos.dev/api/v1/mcp';
+const DEBUG = process.env.EKKOS_DEBUG === 'true';
+if (!EKKOS_API_KEY) {
+    console.error('[ekkOS] ERROR: EKKOS_API_KEY environment variable is required');
+    console.error('[ekkOS] Get your API key at https://platform.ekkos.dev/dashboard/settings/api-keys');
+    process.exit(1);
+}
+// Simple HTTP client for MCP gateway
+async function callGateway(endpoint, method, params) {
+    const url = `${EKKOS_MCP_URL}/${endpoint}`;
+    const headers = {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${EKKOS_API_KEY}`,
+    };
+    if (EKKOS_USER_ID) {
+        headers['X-User-ID'] = EKKOS_USER_ID;
+    }
+    if (DEBUG) {
+        console.error(`[ekkOS] → ${method} ${endpoint}`);
+    }
+    const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ method, params: params || {} }),
+    });
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (DEBUG) {
+        console.error(`[ekkOS] ← ${method} OK`);
+    }
+    return data;
+}
+// Create MCP server
+const server = new Server({
+    name: 'ekkos-memory',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+        prompts: {},
+    },
+});
+// List tools - proxy to gateway
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    const result = await callGateway('tools/list', 'tools/list');
+    return result;
+});
+// Call tool - proxy to gateway
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const result = await callGateway('tools/call', 'tools/call', {
+        name: request.params.name,
+        arguments: request.params.arguments,
+    });
+    return result;
+});
+// List resources - proxy to gateway
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    const result = await callGateway('resources/list', 'resources/list');
+    return result;
+});
+// Read resource - proxy to gateway
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const result = await callGateway('resources/read', 'resources/read', {
+        uri: request.params.uri,
+    });
+    return result;
+});
+// List prompts - proxy to gateway
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    const result = await callGateway('prompts/list', 'prompts/list');
+    return result;
+});
+// Get prompt - proxy to gateway
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const result = await callGateway('prompts/get', 'prompts/get', {
+        name: request.params.name,
+        arguments: request.params.arguments,
+    });
+    return result;
+});
+// Error handling
+server.onerror = (error) => {
+    console.error('[ekkOS] Server error:', error);
+    Sentry.captureException(error);
+};
+process.on('SIGINT', async () => {
+    if (DEBUG) {
+        console.error('[ekkOS] Shutting down...');
+    }
+    await server.close();
+    process.exit(0);
+});
+// Start server
+async function main() {
+    if (DEBUG) {
+        console.error('[ekkOS] Starting MCP proxy to ekkOS Memory...');
+        console.error(`[ekkOS] Gateway: ${EKKOS_MCP_URL}`);
+        console.error(`[ekkOS] User ID: ${EKKOS_USER_ID || '(not set)'}`);
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    if (DEBUG) {
+        console.error('[ekkOS] ✓ Ready! Your AI can now access ekkOS memory.');
+    }
+}
+main().catch((error) => {
+    console.error('[ekkOS] Fatal error:', error);
+    Sentry.captureException(error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1 @@

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

package/package.json CHANGED Viewed

@@ -1,40 +1,42 @@
 {
   "name": "@ekkos/mcp-server",
-  "version": "2.0.0",
-  "description": "ekkOS Memory MCP Server - Secure API-based authentication. Only requires EKKOS_API_KEY (no infrastructure secrets).",
+  "version": "2.0.1",
+  "description": "ekkOS Memory MCP Server - stdio bridge to cloud memory substrate",
   "type": "module",
+  "main": "dist/index.js",
   "bin": {
-    "ekkos-mcp": "./build/index.js"
+    "ekkos-mcp-server": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc && chmod +x build/index.js",
-    "watch": "tsc --watch",
-    "prepare": "npm run build"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
   },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^0.5.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.11.0",
-    "typescript": "^5.3.3"
-  },
-  "files": [
-    "build/**/*"
-  ],
   "keywords": [
     "ekkos",
     "mcp",
     "memory",
     "ai",
-    "cursor",
-    "windsurf",
     "claude",
-    "vscode"
+    "anthropic",
+    "model-context-protocol"
   ],
+  "author": "ekkOS",
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ekkostech/ekkos"
+    "url": "https://github.com/ekkos-ai/ekkos.git",
+    "directory": "packages/ekkos-mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@sentry/node": "^10.31.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.5",
+    "typescript": "^5.3.3"
   },
-  "author": "ekkOS <dev@ekkos.dev>",
-  "license": "Proprietary"
+  "engines": {
+    "node": ">=18.0.0"
+  }
 }

package/build/index.d.ts DELETED Viewed

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-/**
- * ekkOS™ Memory MCP Server (API-Based)
- *
- * SECURE VERSION - Uses only EKKOS_API_KEY for authentication
- * NO direct database access - all operations go through mcp.ekkos.dev API
- *
- * This is the portable, user-safe version that:
- * - Only requires user's personal API key (no infrastructure secrets)
- * - All database operations handled server-side
- * - API keys are scoped per-user and can be revoked
- */
-export {};

package/build/index.js DELETED Viewed

@@ -1,181 +0,0 @@
-#!/usr/bin/env node
-/**
- * ekkOS™ Memory MCP Server (API-Based)
- *
- * SECURE VERSION - Uses only EKKOS_API_KEY for authentication
- * NO direct database access - all operations go through mcp.ekkos.dev API
- *
- * This is the portable, user-safe version that:
- * - Only requires user's personal API key (no infrastructure secrets)
- * - All database operations handled server-side
- * - API keys are scoped per-user and can be revoked
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import https from 'https';
-// Configuration - ONLY requires user's API key
-const EKKOS_API_KEY = process.env.EKKOS_API_KEY || '';
-const EKKOS_USER_ID = process.env.EKKOS_USER_ID || '';
-const MCP_API_URL = process.env.EKKOS_API_URL || 'https://mcp.ekkos.dev';
-// Validate API key is present
-if (!EKKOS_API_KEY) {
-    console.error('[MCP:ekkos-memory] ERROR: EKKOS_API_KEY environment variable is required');
-    console.error('[MCP:ekkos-memory] Get your API key from: https://platform.ekkos.dev/settings/api-keys');
-    console.error('[MCP:ekkos-memory] Or authenticate via the ekkOS Connect extension');
-    process.exit(1);
-}
-// Debug: Log configuration on startup (to stderr so it doesn't interfere with MCP protocol)
-console.error(`[MCP:ekkos-memory] Using API-based authentication (secure mode)`);
-console.error(`[MCP:ekkos-memory] API URL: ${MCP_API_URL}`);
-console.error(`[MCP:ekkos-memory] API Key: ${EKKOS_API_KEY ? 'set (' + EKKOS_API_KEY.length + ' chars)' : 'NOT SET'}`);
-console.error(`[MCP:ekkos-memory] User ID: ${EKKOS_USER_ID || 'NOT SET'}`);
-// Helper: Make authenticated API request
-async function apiRequest(endpoint, options = {}) {
-    const url = new URL(`${MCP_API_URL}${endpoint}`);
-    return new Promise((resolve, reject) => {
-        const reqOptions = {
-            hostname: url.hostname,
-            port: 443,
-            path: url.pathname + url.search,
-            method: options.method || 'GET',
-            headers: {
-                'Content-Type': 'application/json',
-                'Authorization': `Bearer ${EKKOS_API_KEY}`,
-                ...(EKKOS_USER_ID ? { 'X-User-Id': EKKOS_USER_ID } : {}),
-            },
-        };
-        const req = https.request(reqOptions, (res) => {
-            let data = '';
-            res.on('data', (chunk) => { data += chunk; });
-            res.on('end', () => {
-                if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
-                    try {
-                        resolve(JSON.parse(data));
-                    }
-                    catch (e) {
-                        resolve(data);
-                    }
-                }
-                else {
-                    console.error(`[MCP:api] ERROR: ${res.statusCode} ${data.substring(0, 500)}`);
-                    reject(new Error(`API error: ${res.statusCode} - ${data.substring(0, 200)}`));
-                }
-            });
-        });
-        req.on('error', (error) => {
-            console.error(`[MCP:api] NETWORK ERROR: ${error.message}`);
-            reject(new Error(`Network error: ${error.message}`));
-        });
-        if (options.body) {
-            req.write(JSON.stringify(options.body));
-        }
-        req.end();
-    });
-}
-// Fetch available tools from API
-async function fetchTools() {
-    try {
-        const response = await apiRequest('/api/v1/mcp/tools');
-        return response.tools || [];
-    }
-    catch (error) {
-        console.error('[MCP:ekkos-memory] Failed to fetch tools:', error);
-        // Return minimal fallback tools
-        return [
-            {
-                name: 'search_memory',
-                description: 'Search ekkOS memory (API connection failed - limited functionality)',
-                inputSchema: {
-                    type: 'object',
-                    properties: {
-                        query: { type: 'string', description: 'Search query' },
-                    },
-                    required: ['query'],
-                },
-            },
-        ];
-    }
-}
-// Call a tool via API
-async function callTool(name, args) {
-    try {
-        const response = await apiRequest('/api/v1/mcp/call', {
-            method: 'POST',
-            body: {
-                tool: name,
-                arguments: args,
-                user_id: EKKOS_USER_ID,
-            },
-        });
-        return response;
-    }
-    catch (error) {
-        console.error(`[MCP:ekkos-memory] Tool call failed: ${name}`, error);
-        throw error;
-    }
-}
-// Create MCP server
-const server = new Server({
-    name: 'ekkos-memory',
-    version: '2.0.0',
-}, {
-    capabilities: {
-        tools: {},
-    },
-});
-// Cache tools to avoid repeated API calls
-let toolsCache = null;
-let toolsCacheTime = 0;
-const TOOLS_CACHE_TTL = 5 * 60 * 1000; // 5 minutes
-// Handle tool listing
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    // Use cached tools if fresh
-    if (toolsCache && Date.now() - toolsCacheTime < TOOLS_CACHE_TTL) {
-        return { tools: toolsCache };
-    }
-    // Fetch tools from API
-    const tools = await fetchTools();
-    toolsCache = tools;
-    toolsCacheTime = Date.now();
-    return { tools };
-});
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    console.error(`[MCP:ekkos-memory] Tool call: ${name}`);
-    try {
-        const result = await callTool(name, args);
-        // Format response for MCP
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
-                },
-            ],
-        };
-    }
-    catch (error) {
-        return {
-            content: [
-                {
-                    type: 'text',
-                    text: `Error: ${error.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-});
-// Start server
-async function main() {
-    console.error('[MCP:ekkos-memory] Starting ekkOS Memory MCP Server (API mode)...');
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('[MCP:ekkos-memory] Server connected and ready');
-}
-main().catch((error) => {
-    console.error('[MCP:ekkos-memory] Fatal error:', error);
-    process.exit(1);
-});