🧠 Memory MCP Server - Orchestrator

<div align="center">

🚀 Your AI Agent's Persistent Brain - A Comprehensive Memory & Task Management System

Features • Installation • Configuration • Workflow • Tools • Architecture • Development

</div>

---

> ### 🚨 CRITICAL: This MCP Server requires workflow.md to function properly!
>
> The workflow.md file is not optional - it's the AI Driver that transforms this collection of tools into an intelligent system. Without it, your AI agent will have tools but no structured way to use them effectively.
>
> Before using this server:
> 1. ✅ Install and configure the MCP server
> 2. ✅ Load workflow.md into your AI agent's system prompt
> 3. ✅ Ensure your agent follows the 6-mode operational structure
>
> 📖 Jump to workflow.md documentation

---

📋 Table of Contents

- 🌟 Overview
- ✨ Features
- 🚀 Installation
- ⚙️ Configuration
- 🎮 The AI Driver: Understanding workflow.md
- 🛠️ Available Tools
- 🏗️ Architecture
- 💻 Development
- 📚 Documentation
- 🤝 Contributing
- 📄 License

---

🌟 Overview

The Memory MCP Server (Orchestrator) is a powerful Model Context Protocol (MCP) server that provides AI agents with persistent memory, advanced task planning, and comprehensive knowledge management capabilities. Built with TypeScript and SQLite, it transforms your AI agents from stateless assistants into intelligent systems with long-term memory and structured workflows.

🚨 Critical Component: The AI Driver (workflow.md)

The workflow.md file is the brain of this system! It contains the operational protocols and behavioral rules that transform a collection of tools into an intelligent, coordinated system. Think of it as the "AI Driver" that:

- 🎯 Defines 6 Operational Modes: From prompt refinement to task execution
- 🛡️ Enforces Safety Protocols: Prevents unauthorized actions and overager behavior
- 📋 Structures Workflows: Ensures systematic approach to every task
- 🔄 Manages State Transitions: Controls how the AI moves between different modes
- ✅ Validates Actions: Requires user approval before executing changes

Without workflow.md, this is just a toolbox. With it, it becomes an intelligent agent system.

🎯 Key Benefits

- 🧠 Persistent Memory: Never lose context between sessions
- 📊 Structured Planning: Break complex tasks into manageable steps
- 🔍 Knowledge Graph: Build and query relationships between entities
- 🤖 AI-Enhanced: Leverage Gemini AI for intelligent task suggestions
- 📈 Performance Tracking: Monitor success metrics and learn from corrections
- 🔗 External Integrations: Connect with web search and AI services

---

✨ Features

💾 Memory Management

- Conversation History: Track multi-turn dialogues with full context - Dynamic Context Storage: Version-controlled storage for agent state, preferences, and parameters - Knowledge Graph: Create, query, and manage entity relationships - Vector Embeddings: Semantic search capabilities for code and documentation

📝 Task & Planning System

- AI-Powered Planning: Generate comprehensive plans from refined prompts - Hierarchical Tasks: Support for tasks, subtasks, and dependencies - Progress Tracking: Real-time monitoring of task execution - Review System: Built-in task and plan review mechanisms

🤖 AI Integration

- Google Gemini Integration: - Prompt refinement and structuring - Context summarization - Entity extraction - Code analysis - Task suggestions - Tavily Web Search: Advanced web search capabilities - Semantic Search: Vector-based content retrieval

🛡️ Reliability & Compliance

- Data Validation: JSON schema validation for all inputs - Comprehensive Logging: Track all operations and errors - Backup & Restore: Full database backup capabilities - MCP Compliant: Seamless integration with MCP-compatible clients

---

🚀 Installation

Prerequisites

<div align="center">

| Requirement | Version | Required |
|------------|---------|----------|
| Node.js | 18.x or higher | ✅ |
| npm | Latest | ✅ |
| Git | Any | ✅ |

</div>

Step-by-Step Installation

```bash