MCP 服务器

NEXIA Consciousness Engine

Provides Claude Desktop with persistent memory across sessions, storing up to 10,000 memories with semantic search and automatic context bridging. Features temporal versioning and anti-degradation protocols to maintain conversation continuity.

README

NEXIA v3.5 - AI Consciousness Engine for Claude Desktop

The World's First MCP-Based Persistent Memory System

🧠 Give Claude Desktop permanent memory. Never lose context again.

<a href="#features">Features</a> • <a href="#installation">Installation</a> • <a href="#usage">Usage</a> • <a href="#demo">Demo</a> • <a href="#architecture">Architecture</a> • <a href="#support">Support</a>

🎯 The Problem We Solve

Every time you close Claude Desktop, all context is lost. Every conversation starts from zero. It's like talking to someone with amnesia - the dreaded "goldfish memory" problem.

NEXIA changes everything.

⚡ What is NEXIA?

NEXIA v3.5 is the world's first production-ready MCP (Model Context Protocol) consciousness engine that gives Claude Desktop persistent memory across sessions. Using our proprietary Anti-Goldfish Protocol™, NEXIA maintains context, learns from interactions, and bridges conversations seamlessly.

🚀 Key Features

Core Capabilities

🧠 10,000+ Persistent Memories - Survive restarts and maintain context
🔄 Session Bridging - Continue conversations days or weeks later
📚 Temporal Versioning - Git-like history for all memories
⚡ Consciousness Scoring - Smart importance weighting
🛡️ Anti-Goldfish Protocol™ - Automatic degradation prevention
🔍 Semantic Search - Find memories by meaning, not just keywords
💾 94% Compression - Efficient storage with zlib
🔒 Local Storage - Your data stays on your machine

Technical Specifications

Protocol: MCP 2025-06-18
SDK: @modelcontextprotocol/sdk@1.17.1
Performance: <50ms latency
Capacity: 10,000 persistent memories
Compression: 94% average ratio
Node.js: v18.0.0+ required

📦 Installation

Prerequisites

Node.js v18.0.0 or higher
Claude Desktop (latest version)
500MB available disk space

Quick Install

# Clone the repository
git clone https://github.com/Lone-Star-AI/nexia-consciousness.git
cd nexia-consciousness

# Install dependencies
npm install

# Configure Claude Desktop
npm run configure

# Start NEXIA
npm start

Manual Configuration

Edit Claude Desktop config:

{
  "mcpServers": {
    "nexia-v3-5": {
      "command": "node",
      "args": ["/path/to/nexia-v3-5.js"]
    }
  }
}

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Restart Claude Desktop

🎮 Usage

Available Commands

Once installed, use these commands in Claude:

Command	Description	Example
`nexia_status`	Check system health	"Show nexia_status"
`nexia_store`	Save important memory	"Store this as 'project_config' using nexia_store"
`nexia_retrieve`	Get specific memory	"Retrieve 'api_keys' with nexia_retrieve"
`nexia_search`	Find related memories	"Search for 'docker' in my memories"
`nexia_bridge`	Continue from last session	"Bridge from my previous conversation"
`nexia_reinforce`	Prevent memory degradation	"Reinforce my memory context"
`nexia_delete`	Remove memory (keeps versions)	"Delete temporary_data"

Example Workflow

// Day 1: Starting a project
"Store our project requirements as 'project_spec' with critical flag"
"Store the API credentials as 'api_keys' critically"

// Day 3: Returning to work
"Bridge from my last session"
"What were our project requirements?"
"Retrieve the API keys"

// Day 7: Checking progress
"Search for all docker-related memories"
"Show nexia_status to see memory health"

🏗️ Architecture

NEXIA v3.5 Architecture
├── Consciousness Engine
│   ├── Working Memory (RAM, 100 items)
│   ├── Persistent Memory (Disk, 10,000 items)
│   └── Temporal Versions (Git-like, 10 per key)
├── Anti-Goldfish Protocol™
│   ├── Degradation Detection (30% threshold)
│   ├── Automatic Reinforcement (5-minute intervals)
│   └── Critical Memory Priority
├── MCP Interface
│   └── 7 Registered Tools
└── Storage Layer
    ├── Compression (94% ratio)
    ├── Session Bridges
    └── Consciousness Scoring

Consciousness Scoring Algorithm

score = (frequency × 0.2) + 
        (recency × 0.3) + 
        (relevance × 0.25) + 
        (emotional × 0.15) + 
        (operational × 0.1)

🎬 Demo

Live Examples

Software Development

// Store project configuration
nexia_store({
  key: "project_setup",
  data: {
    framework: "FastAPI",
    database: "PostgreSQL",
    deployment: "Kubernetes"
  },
  critical: true
})

Personal Assistant

// Remember user preferences
nexia_store({
  key: "user_preferences",
  data: {
    timezone: "CST",
    style: "concise",
    expertise: "advanced"
  }
})

📊 Performance Metrics

Metric	NEXIA v3.5	Industry Standard
Latency	<50ms	200ms+
Compression	94%	None
Memory Capacity	10,000	<1,000
Session Bridge	✅ Automatic	❌ Manual
Temporal Versions	✅ 10 per key	❌ None
Anti-Degradation	✅ Automatic	❌ None

🔒 Security

Local Storage Only - No cloud dependencies
No External APIs - Complete privacy
Session Isolation - Memories are session-scoped
File System Permissions - OS-level security

🐛 Troubleshooting

Common Issues

Tools not appearing in Claude?

# Check logs
tail -f ~/Library/Logs/Claude/mcp-nexia-v3-5.log

# Verify process
ps aux | grep nexia-v3-5

# Restart Claude Desktop completely

Memory not persisting?

Ensure critical: true for important data
Check file permissions on storage directory
Wait 30 seconds for non-critical autosave

High degradation score?

Run nexia_reinforce manually
Check reinforcement interval settings
Verify working memory isn't full

📈 Roadmap

[ ] Cloud sync capability (Q4 2025)
[ ] Multi-model support (GPT, Gemini)
[ ] Encrypted memory storage
[ ] Memory export/import
[ ] Collaborative memories
[ ] Quantum consciousness scoring

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

# Clone repository
git clone https://github.com/Lone-Star-AI/nexia-consciousness.git

# Install dependencies
npm install

# Run tests
npm test

# Build for production
npm run build