Baby-SkyNet 🤖

Autonomous Memory Management System for Claude AI with Multi-Provider LLM Integration & Graph Database

Ein MCP Server der Claude ein permanentes, durchsuchbares Gedächtnis verleiht - inklusive semantischer Analyse, Multi-Provider LLM Support und Graph-Datenbank Integration.

Was ist das?

Baby-SkyNet erweitert Claude um:

Persistentes Memory - Erinnerungen überleben Session-Grenzen
Kategorisierung - Strukturierte Organisation von Wissen
Volltext-Suche - Finde alte Gespräche und Erkenntnisse
Semantische Analyse - KI-gestützte Konzept-Extraktion
Multi-Provider Support - Ollama (lokal) + Anthropic API
Graph Database - Neo4j Integration für verknüpfte Informationen

Features v2.3

Core Memory Management

✅ SQL Database - Robuste, lokale Datenhaltung
✅ Kategorien-System - Programmieren, Debugging, Projekte, etc.
✅ Volltext-Suche - Durchsuche alle Memories
✅ CRUD Operations - Create, Read, Update, Move

Advanced Vector & Graph Storage

✅ ChromaDB Integration - Vector-basierte semantische Suche
✅ Neo4j Graph Database - Relationship-basierte Memory-Vernetzung
✅ Multi-Source Search - Kombinierte Resultate aus allen Datenquellen
✅ Graph Analytics - Netzwerk-Statistiken und Beziehungsanalyse

Semantic Analysis Engine

✅ Multi-Provider LLM - Ollama (lokal) oder Anthropic API
✅ Memory Classification - technical, emotional, procedural, factual
✅ Concept Extraction - Automatische Schlüsselkonzept-Extraktion
✅ Batch Processing - Asynchrone Analyse mehrerer Memories
✅ Metadata Enrichment - Tools, People, Code-Detection
✅ Relationship Detection - Automatische semantische Verknüpfungen

Container Management & Auto-Start

✅ Podman/Docker Integration - Automatisches Container-Management
✅ Auto-Start Services - ChromaDB und Neo4j automatisch starten
✅ Health Monitoring - Container-Status in memory_status Tool
✅ Smart Recovery - Neustart fehlgeschlagener Container

Quick Start

Voraussetzungen

Node.js >= 18.0
TypeScript >= 5.0
Ollama (optional, für lokale LLM) oder Anthropic API Key
MCP-kompatible Umgebung (Claude Desktop, etc.)

Installation

# Repository klonen
git clone https://github.com/spie-mkroehn/baby-skynet.git
cd baby-skynet

# Dependencies installieren
npm install

# TypeScript kompilieren
npm run build

# Starten
npm start

Konfiguration

Option 1: Anthropic API (empfohlen)

# .env Datei erstellen
echo "ANTHROPIC_API_KEY=your_api_key_here" > .env

# Mit Claude Haiku starten
node build/index.js --db-path ./claude_memory.db --brain-model claude-3-5-haiku-latest

Option 2: Lokale Ollama

# Ollama installieren und Modell laden
ollama pull llama3.1:latest

# Mit Ollama starten
node build/index.js --db-path ./claude_memory.db --brain-model llama3.1:latest

MCP Integration

In Claude Desktop claude_desktop_config.json:

*Configuration content*

Neo4j Graph Database (Optional aber empfohlen)

Neo4j Setup:

# 1. Neo4j installieren
# Download von https://neo4j.com/download/
# Oder mit Docker:
docker run --publish=7474:7474 --publish=7687:7687 --volume=$HOME/neo4j/data:/data neo4j

# 2. Environment Variables konfigurieren
cp .env.example .env
# Bearbeite .env mit deinen Neo4j Credentials:
# NEO4J_URL=bolt://localhost:7687
# NEO4J_USER=neo4j
# NEO4J_PASSWORD=your_password

Graph Features nutzen:

save_memory_with_graph - Memory mit automatischer Vernetzung
search_memories_with_graph - Erweiterte Suche mit Kontext
get_memory_graph_context - Beziehungsnetzwerk anzeigen
get_graph_statistics - Netzwerk-Statistiken

LLM Client Factory Architecture

Baby-SkyNet verwendet eine zentrale LLMClientFactory zur Verwaltung aller LLM-Provider:

Unterstützte Provider

Anthropic Claude: claude-3-sonnet, claude-3-haiku, etc.
Ollama Local Models: llama2, mistral, etc.

Automatische Provider-Erkennung

import { LLMClientFactory } from './llm/LLMClientFactory.js';

// Automatische Erkennung basierend auf Modellname
const anthropicClient = LLMClientFactory.createClient('claude-3-sonnet');
const ollamaClient = LLMClientFactory.createClient('llama2');

SemanticAnalyzer Integration

Der SemanticAnalyzer nutzt die Factory automatisch:

import { SemanticAnalyzer } from './llm/SemanticAnalyzer.js';

const analyzer = new SemanticAnalyzer('claude-3-sonnet'); // Verwendet Factory intern

🧪 Testing

Baby-SkyNet verfügt über eine umfassende Test-Suite mit 18+ Tests:

# Build & einzelner Test
npm run build
node tests/test-simple.js

# Alle Tests ausführen
Get-ChildItem tests\test-*.js | ForEach-Object { node $_.FullName }

Test-Kategorien:

Core System Tests (Basis-Funktionalität)
Integration Tests (End-to-End)
MCP Interface Tests (Claude Desktop)
Database Tests (PostgreSQL/SQLite)
VectorDB Tests (ChromaDB)
External Service Tests (OpenAI, Neo4j)

📖 Detaillierte Dokumentation: TESTING.md | tests/README.md

✅ JobProcessor Reorganisation (Januar 2025)

Verzeichnisstruktur optimiert

JobProcessor.ts von src/jobs/ nach src/utils/ verschoben
Leeres jobs/ Verzeichnis entfernt
Import-Pfade entsprechend aktualisiert

Neue schlanke Struktur:

src/
├── database/     # Alle Datenbank-bezogenen Klassen
├── embedding/    # Embedding-Services
├── llm/          # LLM-Clients und SemanticAnalyzer
├── utils/        # Utilities inkl. JobProcessor
└── index.ts      # Hauptdatei

Vorteile:

Weniger Verzeichnisse → übersichtliche

Baby Skynet