@ekkos/mcp-server 2.0.3 → 2.1.0
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.
- package/dist/index.d.ts +5 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +520 -32
- package/dist/index.js.map +1 -1
- package/dist/local-cache.d.ts +90 -0
- package/dist/local-cache.d.ts.map +1 -0
- package/dist/local-cache.js +525 -0
- package/dist/local-cache.js.map +1 -0
- package/dist/offline-queue.d.ts +25 -0
- package/dist/offline-queue.d.ts.map +1 -0
- package/dist/offline-queue.js +119 -0
- package/dist/offline-queue.js.map +1 -0
- package/ekkOS_CONTEXT.md +89 -0
- package/package.json +6 -2
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"local-cache.js","sourceRoot":"","sources":["../src/local-cache.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Offline Write Queue for ekkOS MCP Server
|
|
3
|
+
*
|
|
4
|
+
* When the cloud gateway is unreachable, queues write operations
|
|
5
|
+
* (Forge, Track, Outcome, Directive) to a local JSONL file.
|
|
6
|
+
* Flushes the queue when connectivity is restored.
|
|
7
|
+
*/
|
|
8
|
+
/**
|
|
9
|
+
* Check if a tool is a write operation that can be queued
|
|
10
|
+
*/
|
|
11
|
+
export declare function isWriteTool(toolName: string): boolean;
|
|
12
|
+
/**
|
|
13
|
+
* Queue a write operation for later execution
|
|
14
|
+
*/
|
|
15
|
+
export declare function queueWrite(toolName: string, args: Record<string, unknown>): void;
|
|
16
|
+
/**
|
|
17
|
+
* Flush all pending writes to the cloud gateway
|
|
18
|
+
* Returns the number of successfully flushed writes
|
|
19
|
+
*/
|
|
20
|
+
export declare function flushQueue(callGateway: (endpoint: string, method: string, params?: any) => Promise<any>): Promise<number>;
|
|
21
|
+
/**
|
|
22
|
+
* Get count of pending writes
|
|
23
|
+
*/
|
|
24
|
+
export declare function getPendingCount(): number;
|
|
25
|
+
//# sourceMappingURL=offline-queue.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"offline-queue.d.ts","sourceRoot":"","sources":["../src/offline-queue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8BH;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAiBhF;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAC5E,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CASxC"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Offline Write Queue for ekkOS MCP Server
|
|
3
|
+
*
|
|
4
|
+
* When the cloud gateway is unreachable, queues write operations
|
|
5
|
+
* (Forge, Track, Outcome, Directive) to a local JSONL file.
|
|
6
|
+
* Flushes the queue when connectivity is restored.
|
|
7
|
+
*/
|
|
8
|
+
import { appendFileSync, readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
|
|
9
|
+
import { join } from 'path';
|
|
10
|
+
import { homedir } from 'os';
|
|
11
|
+
const CACHE_DIR = join(homedir(), '.ekkos', 'cache');
|
|
12
|
+
const QUEUE_FILE = join(CACHE_DIR, 'pending-writes.jsonl');
|
|
13
|
+
// Tools that perform writes and should be queued when offline
|
|
14
|
+
const WRITE_TOOLS = new Set([
|
|
15
|
+
'ekkOS_Forge',
|
|
16
|
+
'ekkOS_AutoForge',
|
|
17
|
+
'ekkOS_Track',
|
|
18
|
+
'ekkOS_Outcome',
|
|
19
|
+
'ekkOS_Directive',
|
|
20
|
+
'ekkOS_UpdateDirective',
|
|
21
|
+
'ekkOS_DeleteDirective',
|
|
22
|
+
'ekkOS_Capture',
|
|
23
|
+
'ekkOS_StoreSecret',
|
|
24
|
+
'ekkOS_RotateSecret',
|
|
25
|
+
'ekkOS_DeleteSecret',
|
|
26
|
+
]);
|
|
27
|
+
/**
|
|
28
|
+
* Check if a tool is a write operation that can be queued
|
|
29
|
+
*/
|
|
30
|
+
export function isWriteTool(toolName) {
|
|
31
|
+
return WRITE_TOOLS.has(toolName);
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* Queue a write operation for later execution
|
|
35
|
+
*/
|
|
36
|
+
export function queueWrite(toolName, args) {
|
|
37
|
+
try {
|
|
38
|
+
if (!existsSync(CACHE_DIR)) {
|
|
39
|
+
mkdirSync(CACHE_DIR, { recursive: true });
|
|
40
|
+
}
|
|
41
|
+
const entry = {
|
|
42
|
+
timestamp: new Date().toISOString(),
|
|
43
|
+
toolName,
|
|
44
|
+
arguments: args,
|
|
45
|
+
};
|
|
46
|
+
appendFileSync(QUEUE_FILE, JSON.stringify(entry) + '\n');
|
|
47
|
+
console.error(`[ekkOS:offline] Queued ${toolName} for later sync`);
|
|
48
|
+
}
|
|
49
|
+
catch (err) {
|
|
50
|
+
console.error('[ekkOS:offline] Failed to queue write:', err);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* Flush all pending writes to the cloud gateway
|
|
55
|
+
* Returns the number of successfully flushed writes
|
|
56
|
+
*/
|
|
57
|
+
export async function flushQueue(callGateway) {
|
|
58
|
+
if (!existsSync(QUEUE_FILE))
|
|
59
|
+
return 0;
|
|
60
|
+
let lines;
|
|
61
|
+
try {
|
|
62
|
+
const raw = readFileSync(QUEUE_FILE, 'utf-8').trim();
|
|
63
|
+
if (!raw)
|
|
64
|
+
return 0;
|
|
65
|
+
lines = raw.split('\n');
|
|
66
|
+
}
|
|
67
|
+
catch {
|
|
68
|
+
return 0;
|
|
69
|
+
}
|
|
70
|
+
let flushed = 0;
|
|
71
|
+
const failed = [];
|
|
72
|
+
for (const line of lines) {
|
|
73
|
+
try {
|
|
74
|
+
const entry = JSON.parse(line);
|
|
75
|
+
await callGateway('tools/call', 'tools/call', {
|
|
76
|
+
name: entry.toolName,
|
|
77
|
+
arguments: entry.arguments,
|
|
78
|
+
});
|
|
79
|
+
flushed++;
|
|
80
|
+
}
|
|
81
|
+
catch {
|
|
82
|
+
// Keep failed writes for next flush attempt
|
|
83
|
+
failed.push(line);
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
// Rewrite queue with only failed writes
|
|
87
|
+
try {
|
|
88
|
+
if (failed.length > 0) {
|
|
89
|
+
writeFileSync(QUEUE_FILE, failed.join('\n') + '\n');
|
|
90
|
+
}
|
|
91
|
+
else {
|
|
92
|
+
writeFileSync(QUEUE_FILE, '');
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
catch {
|
|
96
|
+
// Best effort cleanup
|
|
97
|
+
}
|
|
98
|
+
if (flushed > 0) {
|
|
99
|
+
console.error(`[ekkOS:offline] Flushed ${flushed} queued writes (${failed.length} remaining)`);
|
|
100
|
+
}
|
|
101
|
+
return flushed;
|
|
102
|
+
}
|
|
103
|
+
/**
|
|
104
|
+
* Get count of pending writes
|
|
105
|
+
*/
|
|
106
|
+
export function getPendingCount() {
|
|
107
|
+
try {
|
|
108
|
+
if (!existsSync(QUEUE_FILE))
|
|
109
|
+
return 0;
|
|
110
|
+
const raw = readFileSync(QUEUE_FILE, 'utf-8').trim();
|
|
111
|
+
if (!raw)
|
|
112
|
+
return 0;
|
|
113
|
+
return raw.split('\n').length;
|
|
114
|
+
}
|
|
115
|
+
catch {
|
|
116
|
+
return 0;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
//# sourceMappingURL=offline-queue.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"offline-queue.js","sourceRoot":"","sources":["../src/offline-queue.ts"],"names":[],"mappings":"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"}
|
package/ekkOS_CONTEXT.md
ADDED
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
---
|
|
2
|
+
system_id: packages-ekkos-mcp-server
|
|
3
|
+
domain: packages
|
|
4
|
+
status: active
|
|
5
|
+
last_compiled_at: 2026-03-18T11:51:27.508-04:00
|
|
6
|
+
compiled_timezone: America/Toronto
|
|
7
|
+
content_hash: aa6fe83435af287ab97c551dbb555f2df1ac957fb5d6889cad6b48047c83406b
|
|
8
|
+
invalidation_fingerprint: f1bb80338c4bb72b8db61961f438213e94230d5ddb1efab24f42d605bff689af
|
|
9
|
+
recompile_reason: "2 local file changes"
|
|
10
|
+
source_event_ids: []
|
|
11
|
+
source_event_count: 6
|
|
12
|
+
evidence_window_start: 2026-02-27T01:04:05.000-05:00
|
|
13
|
+
evidence_window_end: 2026-03-16T14:50:02.000-04:00
|
|
14
|
+
confidence: medium
|
|
15
|
+
redactions: 1
|
|
16
|
+
compiled_by: ekkOS Cortex (remote)
|
|
17
|
+
compiler_model: gemini-3.1-flash-lite-preview
|
|
18
|
+
source_repo: Ekkos-Technologies-Inc/ekkos
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
<!-- EKKOS_AUTOGENERATED_START aa6fe83435af287ab97c551dbb555f2df1ac957fb5d6889cad6b48047c83406b -->
|
|
22
|
+
|
|
23
|
+
# packages/ekkos-mcp-server
|
|
24
|
+
|
|
25
|
+
The `packages/ekkos-mcp-server` directory provides a bridge between the Model Context Protocol (MCP) stdio transport and the ekkOS cloud memory substrate. It enables AI coding agents (like Claude Code and Cursor) to interact with persistent memory, patterns, and plans via a standardized MCP interface.
|
|
26
|
+
|
|
27
|
+
## Architecture
|
|
28
|
+
- **Runtime**: Node.js (v18+ required)
|
|
29
|
+
- **Entry points**: `src/index.ts` (compiled to `dist/index.js`)
|
|
30
|
+
- **Key dependencies**:
|
|
31
|
+
- `@modelcontextprotocol/sdk`: Provides the core MCP transport and server implementation.
|
|
32
|
+
- `@sentry/node`: Used for error tracking and observability.
|
|
33
|
+
- **Build system**: TypeScript (`tsc`) configured via `tsconfig.json`.
|
|
34
|
+
- **Deploy target**: Distributed via npm as `@ekkos/mcp-server`, intended for local execution by AI agent environments.
|
|
35
|
+
|
|
36
|
+
## Key Files
|
|
37
|
+
- `src/index.ts`: Main server entry point; initializes the MCP server and handles transport bridging.
|
|
38
|
+
- `src/local-cache.ts`: Manages local caching of memory operations to reduce latency.
|
|
39
|
+
- `src/offline-queue.ts`: Handles queuing of memory updates when the cloud substrate is unreachable.
|
|
40
|
+
- `package.json`: Defines dependencies and build scripts.
|
|
41
|
+
- `README.md`: Contains configuration instructions for Claude Code and Cursor.
|
|
42
|
+
- `tsconfig.json`: TypeScript configuration targeting ES2022.
|
|
43
|
+
|
|
44
|
+
## API / Exports
|
|
45
|
+
The server exposes 35 tools via the MCP protocol, categorized as follows:
|
|
46
|
+
- **Core Memory**: `ekkOS_Search`, `ekkOS_Forge`, `ekkOS_Directive`, `ekkOS_Context`, `ekkOS_Capture`, `ekkOS_Codebase`, `ekkOS_Recall`.
|
|
47
|
+
- **Pattern Tracking**: `ekkOS_Track`, `ekkOS_Outcome`, `ekkOS_Detect`, `ekkOS_Reflect`.
|
|
48
|
+
- **Utility**: `ekkOS_Stats`, `ekkOS_Summary`, `ekkOS_Conflict`.
|
|
49
|
+
- **Plan Management**: `ekkOS_Plan`, `ekkOS_Plans`, `ekkOS_PlanStatus`, `ekkOS_PlanStep`, `ekkOS_Generate`, `ekkOS_SaveTemplate`, `ekkOS_Templates`, `ekkOS_FromTemplate`.
|
|
50
|
+
- **Secrets Management**: `ekkOS_StoreSecret`, `ekkOS_GetSecret`, `ekkOS_ListSecrets`, `ekkOS_DeleteSecret`, `ekkOS_RotateSecret`.
|
|
51
|
+
- **Schema Awareness**: `ekkOS_IndexSchema`, `ekkOS_GetSchema`.
|
|
52
|
+
- **Portability**: `ekkOS_Export`, `ekkOS_Import`, `ekkOS_Snapshot`, `ekkOS_Sync`.
|
|
53
|
+
- **Project Setup**: `ekkOS_ProjectInit`, `ekkOS_Ingest`.
|
|
54
|
+
|
|
55
|
+
## Environment Variables
|
|
56
|
+
- `EKKOS_API_KEY` (Required): Authentication token from `platform.ekkos.dev`.
|
|
57
|
+
- `EKKOS_USER_ID` (Optional): Identifier for tracking.
|
|
58
|
+
- `EKKOS_MCP_URL` (Optional): Custom gateway URL (defaults to `https://mcp.ekkos.dev/api/v1/mcp/sse`).
|
|
59
|
+
- `EKKOS_DEBUG` (Optional): Enables verbose logging when set to `true`.
|
|
60
|
+
|
|
61
|
+
## Conventions
|
|
62
|
+
- **Transport**: Uses `stdio` for communication with the host AI agent and `SSE` for communication with the ekkOS cloud.
|
|
63
|
+
- **Build**: Uses `tsc` for compilation; outputs to `./dist`.
|
|
64
|
+
- **Configuration**: Configured via JSON files in the host agent's settings (e.g., `~/.claude/settings.json` or `.cursor/mcp.json`).
|
|
65
|
+
- **Error Handling**: Integrates `@sentry/node` for monitoring; relies on `offline-queue.ts` for resilience during network partitions.
|
|
66
|
+
|
|
67
|
+
## Recent Changes
|
|
68
|
+
- [2026-03-16] Proxy error elimination, LangCache full integration, ANS v4 dashboard, CLI startup optimization.
|
|
69
|
+
- [2026-03-15] Updated ekkOS context documentation across monorepo.
|
|
70
|
+
- [2026-03-10] Audit marketing page with Playwright.
|
|
71
|
+
- [2026-03-09] Marketing stats fix, extension updates, gemini migration, ekkOS context docs.
|
|
72
|
+
|
|
73
|
+
## Gotchas
|
|
74
|
+
- **Node Version**: Requires Node.js 18 or higher.
|
|
75
|
+
- **Connectivity**: If the server fails to load, verify the `EKKOS_API_KEY` is valid and the environment has network access to `mcp.ekkos.dev`.
|
|
76
|
+
- **Debugging**: Always set `EKKOS_DEBUG=true` when troubleshooting connection or tool execution issues.
|
|
77
|
+
- **Persistence**: While `local-cache.ts` and `offline-queue.ts` exist, they are intended to bridge transient connectivity issues; the primary source of truth is the ekkOS cloud substrate.
|
|
78
|
+
|
|
79
|
+
## Connected Systems
|
|
80
|
+
- **ekkOS Cloud Substrate**: The primary backend for memory storage and retrieval.
|
|
81
|
+
- **Claude Code / Cursor**: Host environments that consume the MCP server.
|
|
82
|
+
- **Sentry**: Integrated for error reporting.
|
|
83
|
+
- **Supabase**: Co-change coupling indicates shared logic or data dependencies.
|
|
84
|
+
- **ekkOS SDK**: Shared dependency for core ekkOS functionality.
|
|
85
|
+
|
|
86
|
+
<!-- EKKOS_AUTOGENERATED_END -->
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
*Generated from observed work patterns, decisions, corrections, and file activity via GitHub API.*
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ekkos/mcp-server",
|
|
3
|
-
"version": "2.0
|
|
3
|
+
"version": "2.1.0",
|
|
4
4
|
"description": "ekkOS Memory MCP Server - stdio bridge to cloud memory substrate",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"model-context-protocol"
|
|
23
23
|
],
|
|
24
24
|
"author": "ekkOS",
|
|
25
|
-
"license": "
|
|
25
|
+
"license": "UNLICENSED",
|
|
26
26
|
"repository": {
|
|
27
27
|
"type": "git",
|
|
28
28
|
"url": "https://github.com/ekkos-ai/ekkos.git",
|
|
@@ -32,7 +32,11 @@
|
|
|
32
32
|
"@modelcontextprotocol/sdk": "^1.0.4",
|
|
33
33
|
"@sentry/node": "^10.31.0"
|
|
34
34
|
},
|
|
35
|
+
"optionalDependencies": {
|
|
36
|
+
"better-sqlite3": "^9.4.3"
|
|
37
|
+
},
|
|
35
38
|
"devDependencies": {
|
|
39
|
+
"@types/better-sqlite3": "^7.6.8",
|
|
36
40
|
"@types/node": "^20.11.5",
|
|
37
41
|
"typescript": "^5.3.3"
|
|
38
42
|
},
|