moving
Some checks failed
Installer Smoke / installer-smoke (push) Has been cancelled

This commit is contained in:
Oleg Maslov
2026-09-02 10:10:29 +02:00
commit 0c3e2ead3b
3841 changed files with 970576 additions and 0 deletions

View File

@@ -0,0 +1,124 @@
#!/usr/bin/env node
/**
* Hive Mind Memory MCP Server
*
* Persistent memory for Claude Code, Claude Desktop, Codex, Hermes, and any
* MCP-compatible AI system. Powered by @waggle/hive-mind-core — FrameStore +
* HybridSearch + KnowledgeGraph + IdentityLayer + AwarenessLayer.
*
* Transport: stdio (Claude Code / Claude Desktop / Codex standard)
* Data dir: HIVE_MIND_DATA_DIR (default: ~/.hive-mind)
*/
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 { 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: 'hive-mind-memory',
version: '0.1.0',
},
{
capabilities: {
resources: {},
tools: {},
logging: {},
},
instructions: [
'Hive Mind 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 and persists across sessions.',
'Workspaces provide isolated memory spaces for different projects.',
].join('\n'),
},
);
// ── Scope gate (env-driven) ─────────────────────────────────────────
// HIVE_MIND_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.HIVE_MIND_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);
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('Hive Mind Memory MCP server running on stdio');
console.error(`Data directory: ${process.env.HIVE_MIND_DATA_DIR ?? '~/.hive-mind'}`);
if (!isFullAccess(scopes)) {
console.error(
`Scope gate active: ${[...scopes].sort().join(', ')} — write tools withheld`,
);
}
}
// ── Graceful shutdown ───────────────────────────────────────────────
function handleShutdown(): void {
console.error('Shutting down Hive Mind Memory MCP server...');
shutdown();
process.exit(0);
}
process.on('SIGINT', handleShutdown);
process.on('SIGTERM', handleShutdown);
// ── Launch ──────────────────────────────────────────────────────────
main().catch((err) => {
console.error('Fatal error starting Hive Mind Memory MCP server:', err);
shutdown();
process.exit(1);
});