Enhanced POE MCP Server for Warp.dev

A production-ready Model Context Protocol (MCP) server that integrates POE (Poe.com API) with Warp.dev terminal, enabling AI-powered terminal assistance with context-aware tooling, automated workflows, and real-time streaming capabilities.

🚀 Features

Core Capabilities

• Multi-Model Support: Access GPT-4o, Claude 3 Opus/Sonnet, Gemini Pro, Perplexity, and O3 models
• Warp Terminal Integration: Deep integration with Warp’s context extraction and action execution
• OpenAI SDK Compatibility: Drop-in replacement for OpenAI API with POE backend
• Production-Ready: Rate limiting, health checks, metrics, and graceful shutdown

Advanced Features

• Context-Aware Queries: Automatically extracts terminal output, selections, CWD, git state
• Real-Time Streaming: Server-Sent Events (SSE) with delta content streaming
• Command Execution: Safe execution of terminal commands with validation
• File Operations: Create and modify files directly from model responses
• Session Management: Maintain conversation context across multiple queries
• Rate Limiting: Exponential backoff with 500 RPM limit and request queuing
• Health Monitoring: Built-in health checks and Prometheus-style metrics

📋 Prerequisites

• Operating System: Linux (tested on Ubuntu, Zorin OS), macOS, or WSL2 on Windows
• Python: Version 3.8 or higher
• Warp Terminal: Download from warp.dev
• POE API Key: Get yours from poe.com/api_key

🔧 Installation

Step 1: Clone and Setup

# Clone the repository
git clone https://github.com/Anansitrading/enhanced-poe-mcp.git
cd enhanced-poe-mcp

# Quick installation with script
chmod +x install.sh
./install.sh

# Or manual setup
python3 -m venv venv
source venv/bin/activate  # On Linux/macOS
pip install -e .

Step 2: Configure Environment

Create a .env file with your credentials:

# Required
POE_API_KEY=your_poe_api_key_here

# Optional (with defaults)
OPENAI_API_KEY=your_openai_key  # For OpenAI SDK compatibility
DEBUG_MODE=false
USE_CLAUDE_COMPATIBLE=true
MAX_FILE_SIZE_MB=10
SESSION_EXPIRY_MINUTES=60
RATE_LIMIT_RPM=500
MAX_RETRIES=3
STREAM_BUFFER_SIZE=64
METRICS_ENABLED=true
HEALTH_CHECK_INTERVAL=30

Step 3: Configure in Warp Terminal

Option A: Local Installation (Can cause stability issues)

1. Open Warp MCP Settings:

   • Navigate to: Settings → AI → Manage MCP servers
   • Or press Ctrl+P (Linux/Windows) or Cmd+P (macOS) and search for “Open MCP Servers”

2. Add the POE MCP Server: Click the + Add button and paste this configuration:

   {
     "enhanced-poe-mcp": {
       "command": "python3",