Files
waggle-os/packages/memory-mcp/src/index.ts
Oleg Maslov 0c3e2ead3b
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled
moving
2026-09-02 10:10:29 +02:00

126 lines
5.1 KiB
JavaScript

#!/usr/bin/env node
/**
* Waggle Memory MCP Server
*
* Persistent memory for Claude Code, Claude Desktop, and any MCP-compatible AI system.
* Powered by the Waggle OS memory engine — FrameStore + HybridSearch + KnowledgeGraph.
*
* Transport: stdio (Claude Code / Claude Desktop standard)
* Data: ~/.waggle/ (shared with Waggle OS desktop app)
*/
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { initialize, shutdown } from './core/setup.js';
import { registerMemoryTools } from './tools/memory.js';
import { registerKnowledgeTools } from './tools/knowledge.js';
import { registerIdentityTools } from './tools/identity.js';
import { registerAwarenessTools } from './tools/awareness.js';
import { registerWorkspaceTools } from './tools/workspace.js';
import { registerHarvestTools } from './tools/harvest.js';
import { registerCleanupTools } from './tools/cleanup.js';
import { registerEraseTools } from './tools/erase.js';
import { registerIngestTools } from './tools/ingest.js';
import { registerWikiTools } from './tools/wiki.js';
import { registerResources } from './resources/memory.js';
import { parseScopes, isFullAccess, scopeGatedServer } from './scope.js';
// ── Server creation ─────────────────────────────────────────────────
const server = new McpServer(
{
name: 'waggle-memory',
version: '0.1.0',
},
{
capabilities: {
resources: {},
tools: {},
logging: {},
},
instructions: [
'Waggle Memory gives you persistent memory across conversations.',
'',
'Core workflow:',
'1. Use recall_memory FIRST to check if relevant context exists',
'2. Use save_memory to persist important facts, decisions, and preferences',
'3. Use search_entities to explore the knowledge graph',
'4. Use get_identity / get_awareness for user context',
'',
'Wiki compiler:',
'5. Use compile_wiki to build a personal wiki from your memories',
'6. Use search_wiki / get_page to browse compiled knowledge',
'7. Use compile_health to check data quality and find gaps',
'8. Use ingest_source to add documents, URLs, or files to memory',
'',
'Memory is stored locally in ~/.waggle/ and persists across sessions.',
'Workspaces provide isolated memory spaces for different projects.',
].join('\n'),
},
);
// ── Scope gate (env-driven) ─────────────────────────────────────────
// WAGGLE_MCP_SCOPES controls which tools register. Default (unset) = full
// read+write for backward-compat; "memory:read" registers read tools only,
// so a read-only client literally cannot call save/cleanup/ingest/etc.
const scopes = parseScopes(process.env.WAGGLE_MCP_SCOPES);
const target = isFullAccess(scopes) ? server : scopeGatedServer(server, scopes);
// ── Register all tools ──────────────────────────────────────────────
registerMemoryTools(target);
registerKnowledgeTools(target);
registerIdentityTools(target);
registerAwarenessTools(target);
registerWorkspaceTools(target);
registerHarvestTools(target);
registerCleanupTools(target);
registerEraseTools(target);
registerIngestTools(target);
registerWikiTools(target);
// ── Register all resources ──────────────────────────────────────────
registerResources(target);
// ── Main ────────────────────────────────────────────────────────────
async function main(): Promise<void> {
// Initialize the memory engine (MindDB, embeddings, workspace manager)
await initialize();
// Connect to stdio transport
const transport = new StdioServerTransport();
await server.connect(transport);
// Log to stderr (stdout is reserved for MCP protocol)
console.error('Waggle Memory MCP server running on stdio');
console.error(`Data directory: ${process.env.WAGGLE_DATA_DIR ?? '~/.waggle'}`);
if (!isFullAccess(scopes)) {
console.error(
`Scope gate active: ${[...scopes].sort().join(', ')} — write tools withheld`,
);
}
}
// ── Graceful shutdown ───────────────────────────────────────────────
function handleShutdown(): void {
console.error('Shutting down Waggle Memory MCP server...');
shutdown();
process.exit(0);
}
process.on('SIGINT', handleShutdown);
process.on('SIGTERM', handleShutdown);
// ── Launch ──────────────────────────────────────────────────────────
main().catch((err) => {
console.error('Fatal error starting Waggle Memory MCP server:', err);
shutdown();
process.exit(1);
});