Arc Deployment Orchestrator (MCP Server)

An implementation of the Model Context Protocol (MCP) server designed to simplify the provisioning of applications built on specific frameworks across varied infrastructural targets, with a specialized emphasis on legacy shared hosting environments.

Conceptual Summary

Arc functions as an intermediary layer, connecting advanced Language Models (LLMs) with target hosting environments. This linkage empowers novice developers to execute web application deployments seamlessly via conversational interaction. By adhering to the Model Context Protocol (MCP), it exposes necessary operational tools, contextual resources, and guiding prompts to shepherd users through complex provisioning sequences.

Core Capabilities

Framework Abstraction: Native capability for deploying applications structured via Wasp; future expansion to include other popular stacks.
Infrastructure Versatility: Operational support spanning Netlify, Vercel, traditional hosting platforms, and Hostm.com services.
Interactive Provisioning: Context-aware prompts to navigate users through deployment phases.
Credential Vault: Secure mechanism for persistent storage and retrieval of platform access keys.
Diagnostic Utilities: Integrated mechanisms for identifying and rectifying prevalent deployment anomalies.
Shared Host Optimization: Dedicated pathways to ease deployment onto standard, non-containerized server environments.

Current State

This utility is presently in its foundational development phase. We eagerly welcome community contributions and constructive feedback!

Initial Setup Requirements

Dependencies

Python interpreter version 3.10 or newer
An operative MCP Client (e.g., Claude Desktop application)
Valid accounts for target hosting vendors as required

Installation Procedure

# Obtain source code repository
git clone https://github.com/elblanco2/arc-mcp.git
cd arc-mcp

# Establish an isolated execution environment
python -m venv venv
source venv/bin/activate  # Windows users substitute with: venv\Scripts\activate

# Install runtime dependencies
pip install -r requirements.txt

# Install the package for active development use
pip install -e .

Configuration Directives

Establish a configuration file named .env containing:

SECURE_STORAGE_PATH=~/.arc/credentials

Operation

Command Line Execution

# Initiate the service normally
arc

# Initiate with verbose logging
arc --debug

# Initiate specifying a custom credential storage location
arc --secure-storage-path=/alternative/path/to/secrets

Integration with Claude Desktop

Modify the Claude Desktop configuration file:
macOS users: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows users: %APPDATA%\Claude\claude_desktop_config.json
Insert the Arc server definition:

{
  "mcpServers": {
    "arc": {
      "command": "python",
      "args": [
        "-m",
        "arc",
        "--debug"
      ]
    }
  }
}

Relaunch the Claude Desktop application.
Engage Claude in dialogues concerning your application deployment needs!

System Design

Arc employs a decoupled, modular architecture:

Credential Manager: Responsible for the secure persistence and retrieval of vendor credentials.
Framework Adapters: Modules containing deployment logic specific to each supported application framework.
Infrastructure Handlers: Components managing provider-specific operational calls.
MCP Interface Layer: The gateway exposing tools, context, and prompts via the Model Context Protocol specification.

Supported Infrastructure Targets

Target	Status	Core Capabilities
Netlify	✅ Operational	Serverless Functions, Edge Logic, Form Handling
Vercel	✅ Operational	Serverless Functions, Edge Networking, Analytics Hook
Conventional Hosting	✅ Operational	SSH/SFTP Access, PHP Execution, MySQL Database
Hostm.com	✅ Operational	Standard Shared Hosting Features, API Integration

Supported Application Constructs

Construct	Status	Description
Wasp	✅ Operational	Full-Stack JavaScript/TypeScript Application Structure
Next.js	⚙️ Scheduled	React-based Web Application Pattern
Astro	⚙️ Scheduled	Static Site Generation Utility

Collaboration Guidelines

We welcome external contributions! Please submit revisions via a Pull Request.

Development Workflow

# Install dependencies required for development and testing
pip install -e ".[dev]"

# Execute unit and integration tests
pytest

# Run code style and quality checks
flake8