# Arc MCP Server

A Model Context Protocol (MCP) server that simplifies framework deployments on various hosting environments, with a focus on shared hosting.

## 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)](https://modelcontextprotocol.io/) 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 more frameworks
- **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
- **Focused on Shared Hosting**: Simplified deployment to traditional shared hosting environments

## 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

```bash
# Clone the repository
git clone https://github.com/elblanco2/arc-mcp.git
cd arc-mcp

# Create a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\\Scripts\\activate

# Install dependencies
pip install -r requirements.txt

# Install the package in development mode
pip install -e .
```

### Configuration

Create a `.env` file with your configuration:

```
SECURE_STORAGE_PATH=~/.arc/credentials
```

### Usage

#### Running from command line

```bash
# 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

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

2. Add Arc server configuration:

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

3. Restart Claude Desktop.

4. Start conversations with Claude about deploying your applications!

## 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

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

# Run tests
pytest

# Run linting
flake8
```

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Acknowledgments

- [Model Context Protocol](https://modelcontextprotocol.io/) for enabling this integration
- [Wasp](https://wasp-lang.dev/) for the excellent framework used in our initial support