nexus-prime-warp

Lone-Star-AI/nexus-prime-warp

3.2

If you are the rightful owner of nexus-prime-warp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Nexus-Prime Warp MCP Server is an enterprise-grade server designed to integrate advanced AI tools with Warp Terminal using the Model Context Protocol.

Tools
4
Resources
0
Prompts
0

Nexus-Prime Warp MCP Server

Enterprise-Grade Model Context Protocol Integration

Version: 1.0.0
Status: Production Ready
Organization: Lone Star AI
Last Updated: October 5, 2025

🌟 Overview

Nexus-Prime Warp MCP Server is an enterprise-grade Model Context Protocol server providing 28+ advanced tools for AI agents in Warp Terminal. It features persistent memory palace integration, forensic tracking, advanced file operations, state persistence, and AWS S3 connectivity.

Key Features

  • 🧠 Memory Palace Integration - Persistent, searchable memory with forensic analytics
  • 📁 Advanced File Operations - All operations include automatic backups and rollback capability
  • 💾 State Persistence - Save and restore complete conversation states with checkpoints
  • ☁️ AWS S3 Integration - Seamless cloud storage operations
  • 🔍 Forensic Tracking - Complete audit trail of all operations
  • 🔒 Enterprise Security - Secure command execution with sandboxing
  • ⚡ High Performance - Optimized HTTP-to-stdio bridge architecture

🚀 Quick Start

Prerequisites

  • Python 3.11+ (tested with Python 3.13)
  • Warp Terminal (latest version)
  • macOS, Linux, or Windows (full cross-platform support)
  • Network access for AWS S3 operations (optional)

Installation

  1. Clone or extract Nexus-Prime MCP to your preferred location:

    # Recommended location
mkdir -p ~/.nexus-prime-warp

  2. Install dependencies:

    cd ~/.nexus-prime-warp
pip install -r requirements.txt

  3. Start the HTTP server:

    python server.py

  4. Add to Warp Terminal:

    • Open Warp → Settings → AI → MCP Servers
    • Click "+ Add"
    • Paste the configuration from Configuration section

⚙️ Configuration

Warp Terminal Configuration

Add this JSON to Warp's MCP Servers:

{
  "mcpServers": {
    "nexus-prime-warp": {
      "command": "python3",
      "args": ["/Users/jpgair/.nexus-prime-warp/warp_stdio_bridge.py"],
      "env": {
        "PYTHONUNBUFFERED": "1"
      },
      "working_directory": "/Users/jpgair/.nexus-prime-warp"
    }
  }
}

Environment Variables

| Variable | Description | Default | |----------|-------------|---------|| | PYTHONUNBUFFERED | Ensure immediate output | 1 | | NEXUS_LOG_LEVEL | Logging level | INFO | | NEXUS_DATA_DIR | Data storage directory | ~/.nexus-prime-data | | AWS_ACCESS_KEY_ID | AWS credentials (optional) | - | | AWS_SECRET_ACCESS_KEY | AWS credentials (optional) | - |

🛠️ Architecture

System Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Warp Terminal │◄──►│  stdio Bridge    │◄──►│  HTTP Server    │
│   (MCP Client)  │    │  (JSON-RPC 2.0)  │    │  (FastAPI)      │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                                                         │
                                               ┌─────────▼─────────┐
                                               │   Tool Handlers   │
                                               │  Memory Palace    │
                                               │  File Operations  │
                                               │  State Manager    │
                                               │  AWS S3 Client    │
                                               └───────────────────┘

🚀 Nexus-Prime Warp - HTTP MCP Server

Enterprise-grade tools for Warp Terminal via HTTP REST API

By Lone Star AI - October 5, 2025

📖 What is This?

Nexus-Prime Warp is the HTTP version of Nexus-Prime MCP, specifically designed for Warp Terminal.

Protocol: HTTP REST API (port 3580)
For: Warp Terminal (HTTP-based MCP)
Tools: 28+ enterprise-grade capabilities

🎯 Relationship to Other Projects

Nexus-Prime (stdio)       →  Cursor, Claude Desktop
Nexus-Prime Warp (HTTP)   →  Warp Terminal (THIS!)
Astraeus                  →  AI consciousness system

Completely separate projects with zero mixing!

✨ Features

🔄 State Persistence

  • save_conversation_state - Save complete conversation context
  • restore_conversation_state - Restore previous state
  • list_conversation_checkpoints - Browse saved states

📁 File Operations (14 tools)

  • Advanced file reading with encoding detection
  • Automatic backups before writes
  • Find/replace operations
  • One-click rollback
  • File comparison (diff)
  • Content search
  • And more!

🧠 Memory Palace

  • Persistent memory with compression
  • Semantic search
  • Forensic tracking
  • 30-50% space savings

📊 Forensics & Analytics

  • Complete audit trail
  • Performance metrics
  • Memory palace analytics
  • Server health monitoring

Total: 28+ Enterprise Tools

🚀 Installation

✨ One-Command Installation (Recommended)

Install and start Nexus Prime Warp in 2 minutes with ONE command:

bash <(curl -fsSL https://raw.githubusercontent.com/Lone-Star-AI/nexus-prime-warp/main/install-warp.sh)

What it does automatically:

  • ✅ Detects your OS (macOS, Linux, WSL)
  • ✅ Checks Python, git, and port availability
  • ✅ Installs to ~/.nexus-prime-warp
  • ✅ Creates virtual environment & installs dependencies
  • ✅ AUTO-STARTS HTTP server on port 3580
  • ✅ Creates start/stop/uninstall scripts
  • ✅ Background mode with PID tracking
  • ✅ Beautiful progress UI

Server will be running at: http://localhost:3580 ✨

Manual Installation (Advanced Users)

  1. Clone and install:

    git clone https://github.com/Lone-Star-AI/nexus-prime-warp.git ~/.nexus-prime-warp
cd ~/.nexus-prime-warp
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

  2. Start server:

    ./venv/bin/python server.py

  3. Configure Warp:

    • Open Warp → Settings
    • Go to: Features → MCP Servers → Manage MCP servers
    • Add this to ~/.warp/config.json:
    "mcp": {
  "enabled": true,
  "servers": [
    {
      "name": "nexus-prime-warp",
      "endpoint": "http://localhost:3580",
      "autoStart": true
    }
  ]
}

  4. Restart Warp: Cmd+Q, then reopen

🛠️ Usage

Server Endpoints

🌐 Base URL: http://localhost:3580

Health:     GET  /api/health
Tools List: GET  /api/tools/list
Call Tool:  POST /api/tools/call
Docs:       GET  /docs

Example: Call a Tool

curl -X POST http://localhost:3580/api/tools/call \
  -H "Content-Type: application/json" \
  -d '{
    "tool_name": "save_conversation_state",
    "parameters": {
      "checkpoint_name": "my_checkpoint",
      "context_markers": ["Feature X complete"]
    }
  }'

📂 Directory Structure

~/.nexus-prime-warp/
├── server.py              # Main HTTP server
├── core/                  # Core functionality
│   ├── memory_palace.py   # Persistent memory
│   ├── file_ops.py        # File operations
│   ├── forensics.py       # Audit trail
│   └── state_persistence.py  # State save/restore
├── venv/                  # Python virtual environment
├── logs/                  # Server logs
├── data/                  # Databases & states
│   ├── memory.db
│   ├── forensics.db
│   └── states/
├── requirements.txt
├── install.sh
└── README.md (this file)

🔍 Verification

Check if server is running:

curl http://localhost:3580/api/health

List available tools:

curl http://localhost:3580/api/tools/list

View interactive docs:

Open: http://localhost:3580/docs

🆘 Troubleshooting

Server won't start

  • Check if port 3580 is available: lsof -i :3580
  • Check logs: cat ~/.nexus-prime-warp/logs/server.log

Warp not connecting

  • Verify server is running: curl http://localhost:3580/api/health
  • Check Warp config: cat ~/.warp/config.json
  • Restart Warp completely (Cmd+Q)

Tools not working

  • Check server logs for errors
  • Verify tool names: curl http://localhost:3580/api/tools/list

📊 Status & Health

# Server health
curl http://localhost:3580/api/health

# Memory palace stats
curl http://localhost:3580/api/tools/call \
  -H "Content-Type: application/json" \
  -d '{"tool_name": "memory_forensic_analytics", "parameters": {}}'

🔐 Security

  • Local only: Server binds to localhost (not exposed to internet)
  • No authentication: Designed for local use only
  • Forensic tracking: All operations logged for audit trail

🚧 Auto-Start (Optional)

To start server automatically on boot:

# Create launchd plist
cat > ~/Library/LaunchAgents/ai.lonestar.nexus-prime-warp.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>ai.lonestar.nexus-prime-warp</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Users/YOUR_USERNAME/.nexus-prime-warp/venv/bin/python</string>
        <string>/Users/YOUR_USERNAME/.nexus-prime-warp/server.py</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>
EOF

# Load it
launchctl load ~/Library/LaunchAgents/ai.lonestar.nexus-prime-warp.plist

📝 License

MIT License - By Lone Star AI

🔗 Related Projects

Questions? Check server logs at: ~/.nexus-prime-warp/logs/server.log