BlueRabbit-ai/mcp-smm-server

MCP SMM Order Automation Server

A secure Model Context Protocol (MCP) server for automated Social Media Marketing (SMM) order processing between G2G and JustAnotherPanel APIs.

Overview

This project creates a containerized MCP server that:

• Receives SMM order notifications from G2G via webhooks
• Automatically places corresponding orders on JustAnotherPanel
• Handles customer communications
• Logs all transactions with profit tracking
• Provides multi-channel owner notifications

Features

• Secure API Integration: MCP-compliant server with proper secret management
• Webhook Processing: Flask-based webhook receiver with HMAC verification
• Order Automation: Automated order placement and status tracking
• Multi-channel Notifications: Email, SMS, Discord, and webhook alerts
• Transaction Logging: Comprehensive CSV-based audit trails
• Docker Support: Fully containerized with Docker MCP Toolkit compatibility

Project Structure

mcp-smm-server/
├── Dockerfile                  # Container build configuration
├── requirements.txt            # Python dependencies
├── smmserver.py               # Main MCP server application
├── docker-compose.yml         # Development environment
├── mcpbuilder.yml             # MCP build configuration
├── .env.example               # Environment variables template
├── README.md                  # Project documentation (this file)
├── CLAUDE.md                  # Claude Desktop integration guide
├── custom.yaml                # Docker MCP Toolkit configuration
├── registry.yaml              # Server registration configuration
├── test-phase1.sh             # Phase 1 validation script
├── phase1-completion-report.md # Development progress report
├── config/
│   └── environment.py         # Configuration management system
├── data/                      # Transaction logs and data files
├── logs/                      # Application logs
└── sales.csv                  # Transaction logging file

Quick Start

Prerequisites

• Docker Desktop with MCP Toolkit enabled
• G2G API credentials
• JustAnotherPanel API key

Installation

1. Clone and Setup

   git clone https://github.com/BlueRabbit-ai/mcp-smm-server.git
   cd mcp-smm-server
   

2. Configure Environment

   cp .env.example .env
   # Edit .env with your API keys and configuration
   

3. Build Docker Image

   docker build -t mcp-smm-server .
   

4. Set MCP Secrets

   docker mcp secret set G2G_API_KEY "your_g2g_api_key"
   docker mcp secret set JAP_API_KEY "your_jap_api_key"
   docker mcp secret set OWNER_EMAIL "your_email@example.com"
   

5. Run with Docker MCP Toolkit

   docker mcp server enable mcp-smm-server
   

Development Environment

# Start development environment
docker-compose up -d

# Check health
curl http://localhost:5000/health

# View logs
docker-compose logs -f mcp-smm-server

# Run validation tests
chmod +x test-phase1.sh
./test-phase1.sh

Phase 1: Foundation (Current)

✅ Completed in Phase 1:

• Project directory structure
• Docker configuration and Dockerfile
• Basic MCP server skeleton with health checks
• Flask webhook receiver setup
• Environment variable management
• Comprehensive logging system

Testing Phase 1:

# Build the container
docker build -t mcp-smm-server .

# Test health endpoint
curl http://localhost:5000/health

# Check MCP server tools
docker mcp server list

Development Roadmap

• Phase 2: API Integration (G2G + JustAnotherPanel)
• Phase 3: Core Automation Logic
• Phase 4: Notification System
• Phase 5: MCP Integration & Claude Desktop Setup
• Phase 6: Testing, Security & Documentation

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   G2G Orders    │───▶│  MCP SMM Server  │───▶│ JustAnotherPanel│
│   (Webhooks)    │    │   (Docker)       │    │    (API)        │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────┐
                       │ Notifications│
                       │   & Logging  │
                       └──────────────┘

File Descriptions

Core Application Files

• smmserver.py: Main MCP server with FastMCP framework and Flask webhook handler
• requirements.txt: Python dependencies including MCP, Flask, and security libraries
• Dockerfile: Multi-stage Docker build with health checks and security best practices

Configuration Files

• .env.example: Template for environment variables (API keys, email settings)
• config/environment.py: Advanced configuration management with validation
• mcpbuilder.yml: MCP server build and deployment configuration

Docker & Deployment

• docker-compose.yml: Complete development environment with Redis
• custom.yaml: Docker MCP Toolkit server configuration
• registry.yaml: MCP server registry and metadata

Documentation & Integration

• README.md: This comprehensive project documentation
• CLAUDE.md: Claude Desktop integration configuration and usage guide
• phase1-completion-report.md: Development progress and completion status

Testing & Validation

• test-phase1.sh: Automated testing script for Phase 1 validation

License

MIT License - see LICENSE file for details.