README - Arc MCP Server by elblanco2

Arc MCP Server

A Model Context Protocol (MCP) server that simplifies framework deployments on various hosting environments.

Overview

Arc bridges the gap between Large Language Models (LLMs) and hosting environments, allowing novice developers to deploy web applications easily through conversational interfaces. It implements the Model Context Protocol (MCP) to expose tools, resources, and prompts that guide users through the deployment process.

Key Features

Framework Support: Deploy Wasp applications with ease, with planned support for Next.js and Astro
Multi-Provider: Support for Netlify, Vercel, traditional shared hosting environments, and Hostm.com
Guided Deployments: Prompts to guide users through the deployment process
Authentication Management: Secure storage of hosting provider credentials
Troubleshooting: Built-in tools to diagnose and fix common deployment issues
Windsurf Integration: Seamless handoff to Windsurf (Codeium's VS Code) for continued development

Status

This project is currently in early development. Contributions and feedback are welcome!

Getting Started

Prerequisites

Python 3.10+
MCP Client (e.g., Claude Desktop)
Hosting provider accounts as needed

Installation

# Using pip
pip install arc-mcp-server

# Or install in development mode
git clone https://github.com/elblanco2/arc-mcp.git
cd arc-mcp
pip install -e .

Configuration

Create a .env file with your configuration:

SECURE_STORAGE_PATH=~/.arc/credentials

Usage

Running from command line

# Start the server directly
arc

# With debug logging
arc --debug

# With a custom storage path
arc --secure-storage-path=/path/to/credentials

Using with Claude Desktop

Edit your Claude Desktop configuration file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add Arc server configuration:

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

Restart Claude Desktop.
Start conversations with Claude about deploying your applications!

Using with Windsurf (Codeium)

The Arc MCP server includes special integration with Windsurf, Codeium's version of VS Code, to provide a seamless development experience after deployment:

Deploy your application using Arc.
Use the "windsurf-handoff" prompt to transition to Windsurf for continued development.
Windsurf's AI Flow feature will guide you through adding features and improving your application.

Architecture

Arc is built on a modular architecture:

Credentials Manager: Securely stores and retrieves provider credentials
Framework Handlers: Framework-specific deployment logic
Hosting Providers: Provider-specific deployment operations
MCP Interface: Exposes tools, resources, and prompts via the Model Context Protocol

Supported Providers

Provider	Status	Features
Netlify	Complete	Serverless, Edge, Forms
Vercel	Complete	Serverless, Edge, Analytics
Shared Hosting	Complete	SSH/SFTP, PHP, MySQL
Hostm.com	Complete	Shared Hosting, API Access

Supported Frameworks

Framework	Status	Features
Wasp	Complete	Full-Stack JS Framework
Next.js	Planned	React Framework
Astro	Planned	Static Site Generator

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
flake8

License

This project is licensed under the MIT License - see the file for details.

Acknowledgments

Model Context Protocol for enabling this integration
Wasp for the excellent framework used in our initial support
Windsurf for AI-powered development environment integration