HostBridge

by elblanco2

1 stars
317 downloads
Not rated
GitHub

About

Simplifies web application deployment across multiple hosting providers like Netlify and Vercel through a unified interface that handles authentication, building, and deployment operations with simple commands.

Details

Author
elblanco2
Repository
elblanco2/hostbridge-mcp
GitHub stars
1
Downloads
317
License
MIT License
Categories
Cloud Service, Infrastructure, Productivity, Developer Tools, Design, Workplace, AI, Project Management, Frontend, Other
Tags
#web

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name HostBridge
    Command (node, npx, python, etc.) python
    Arguments
    • Argument 1 -m
    • Argument 2 arc
    • Argument 3 --debug

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

python -m venv venv
source venv/bin/activate # On Windows: venv\\Scripts\\activate

pip install -r requirements.txt

pip install -e .


bash

pip install -e ".[dev]"

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "hostbridge": {
            "cwd": "string",
            "env": {},
            "args": [
                "-m",
                "arc",
                "--debug"
            ],
            "shell": false,
            "command": "python"
        }
    }
}

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "-m",
        "arc",
        "--debug"
    ],
    "shell": false,
    "command": "python"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "-m",
        "arc",
        "--debug"
    ],
    "shell": false,
    "command": "python"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "-m",
        "arc",
        "--debug"
    ],
    "shell": false,
    "command": "python"
}

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

# 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

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

{
  "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

# 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 file for details.

Acknowledgments

- Model Context Protocol for enabling this integration
- Wasp for the excellent framework used in our initial support

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.