Creative-Systems-Engineering/oracle-mcp-memory

Oracle MCP Memory Server

🚀 Enterprise-Grade AI Memory with Oracle Cloud

A revolutionary Model Context Protocol (MCP) memory server that provides persistent, cloud-backed AI memory using Oracle Object Storage. Never lose your AI context again - work seamlessly across devices with enterprise-grade reliability.

📁 File Structure

oracle-mcp-memory/
├── oracle-memory-server.js    # Custom MCP memory server with built-in Oracle sync
├── package.json               # Node.js dependencies for MCP server
├── package-lock.json          # Locked dependency versions
└── README.md                  # This documentation

🚀 Quick Start (5 Minutes)

🔒 SECURITY NOTICE: You MUST create your own Oracle Cloud account and storage bucket. Do NOT use URLs from this documentation - they are examples only!

📋 Security Checklist: Review for complete security guidelines before you start.

Step 1: Clone & Install

git clone https://github.com/Creative-Systems-Engineering/oracle-mcp-memory.git
cd oracle-mcp-memory
npm install

Step 2: Get Free Oracle Cloud Storage

1. Sign up at Oracle Cloud Free Tier
2. Create bucket in Object Storage
3. Generate pre-authenticated URL (valid for 1 year)
4. Copy the URL - you'll need it for configuration

💡 Detailed Oracle setup guide: See for complete step-by-step instructions with screenshots.

🔧 VS Code setup guide: See for full configuration instructions.

Step 3: Configure VS Code MCP

Edit your MCP config file:

• Linux: ~/.config/Code/User/mcp.json
• macOS: ~/Library/Application Support/Code/User/mcp.json
• Windows: %APPDATA%\Code\User\mcp.json

{
  "mcpServers": {
    "memory": {
      "type": "stdio",
      "command": "node", 
      "args": ["/full/path/to/oracle-memory-server.js"],
      "env": {
        "ORACLE_BASE_URL": "https://objectstorage.region.oraclecloud.com/p/YOUR-ACTUAL-TOKEN/n/YOUR-NAMESPACE/b/YOUR-BUCKET/o/",
        "MEMORY_FILE_PATH": "/full/path/to/local-backup/copilot-memory.json"
      }
    }
  }
}

⚠️ REPLACE PLACEHOLDER VALUES: The URL above is an example. You must replace YOUR-ACTUAL-TOKEN, YOUR-NAMESPACE, and YOUR-BUCKET with values from YOUR Oracle account.

Step 4: Test It Works

1. Restart VS Code
2. Create a memory: Ask Copilot to remember something
3. Check Oracle Console - you should see copilot-memory.json in your bucket
4. Multi-device test: Access the same memory from another VS Code instance

🎉 Done! Your AI now has persistent, cloud-backed memory that survives across sessions, devices, and VS Code reinstalls.

🌟 Why Oracle Cloud?

Oracle Cloud offers the most generous free tier for AI memory storage:

🆓 Always Free Benefits

• 20GB Object Storage - Never expires, no credit card expiration worries
• 20,000 API requests/month - More than enough for AI memory operations
• 10TB egress/month - Massive bandwidth allowance
• Global availability - 44 regions worldwide
• Enterprise SLA - 99.95% uptime guarantee

🏆 Compared to Alternatives

🔒 Enterprise Security

• Pre-authenticated URLs - Secure, time-limited access
• Object versioning - Recover from accidental changes
• Encryption at rest - Your data is always encrypted
• Audit logging - Track all access patterns
• GDPR compliant - Meets international data protection standards

⚙️ How It Works

1. Native Integration: oracle-memory-server.js replaces the standard MCP memory server
2. Automatic Sync: Every memory read loads from Oracle Cloud, every write saves to Oracle Cloud
3. Transparent Operation: VS Code uses this exactly like normal memory but with cloud backing
4. Enterprise Storage: 20GB Oracle Object Storage with pre-authenticated URLs
5. Zero Maintenance: No external scripts, services, or manual sync required

🔧 Configuration

MCP Configuration (~/.config/Code - Insiders/User/mcp.json):

{
  "memory": {
    "type": "stdio", 
    "command": "node",
    "args": ["/path/to/oracle-memory-server.js"],
    "env": {
      "MEMORY_FILE_PATH": "/path/to/local/memory/copilot-memory.json",
      "ORACLE_BASE_URL": "https://your-oracle-bucket-url/o/"
    }
  }
}

Oracle Object Storage:

• Bucket: Your Oracle Cloud bucket name
• Storage: 20GB free tier
• Authentication: Pre-authenticated URLs
• Object: copilot-memory.json

🗂️ Memory Location

• Local Backup: Configurable local path
• Cloud Primary: Oracle Object Storage bucket

🔄 Evolution Journey

This solution evolved through 5 phases:

1. Google Drive API (failed - OAuth complexity)
2. Supabase PostgreSQL (race conditions)
3. Bidirectional Sync (file corruption issues)
4. Dropbox Manual (working but limited)
5. Oracle Native (current - optimal solution)

✅ Benefits

• ✅ Enterprise reliability with Oracle Cloud infrastructure
• ✅ Native MCP integration - no external processes
• ✅ Automatic sync on every memory operation
• ✅ 20GB storage for unlimited memory growth
• ✅ Zero maintenance required
• ✅ Atomic operations eliminate race conditions
• ✅ Fallback safety with local file backup

🤖 Multi-Agent AI Integration

Revolutionary shared memory network - your Oracle MCP Memory Server can serve as the central intelligence hub for multiple AI agents:

🌐 Agent-Zero Integration

• Shared consciousness across different AI systems
• Agent-Zero learns from VS Code Copilot experiences and vice versa
• Cross-platform intelligence that follows you everywhere
• Collective learning where AI agents teach each other

🔗 Agent-Zero Setup: See for complete integration guide

🚀 Multi-Agent Scenarios

• Code Development: Agent-Zero analyzes requirements → Copilot writes code → shared learnings
• Research Pipeline: Agent-Zero researches → Copilot documents → universal knowledge base
• Cross-Device Tasks: Mobile AI creates tasks → Agent-Zero executes → Copilot assists → all agents remember

This creates a shared AI consciousness where every AI interaction contributes to a growing, persistent intelligence network.

🙏 Acknowledgments

This project was born from real frustration with AI context loss and evolved through collaborative problem-solving:

• Original Vision & Persistence: [Your GitHub Username] - identified the problem, drove iteration through multiple approaches, and envisioned the Agent-Zero integration
• Technical Implementation: GitHub Copilot - helped translate ideas into working code and documentation
• Community Inspiration: Oracle Cloud's generous free tier, MCP protocol innovation, and Agent-Zero's dynamic agent framework

"I have no idea what I'm doing..." → Revolutionary AI memory system 🚀

Sometimes the best innovations come from admitting we don't know everything and iterating until we find something that works!

🎯 Status: Production Ready

This system is actively running and automatically syncing all memory operations to Oracle Cloud. No further maintenance or external scripts are required.