Arc MCP Server

Arc MCP Server

Um servidor Model Context Protocol (MCP) que simplifica a implantação de frameworks em diversos ambientes de hospedagem, com foco em hospedagem compartilhada.

Visão Geral

Arc preenche a lacuna entre Modelos de Linguagem de Grande Porte (LLMs) e ambientes de hospedagem, permitindo que desenvolvedores iniciantes implantem aplicações web facilmente por meio de interfaces conversacionais. Ele implementa o Model Context Protocol (MCP) para expor ferramentas, recursos e prompts que orientam os usuários durante o processo de implantação.

Principais Recursos

• Suporte a Frameworks: Implante aplicações Wasp com facilidade, com suporte planejado para mais frameworks
• Multi-Provedor: Suporte para Netlify, Vercel, ambientes tradicionais de hospedagem compartilhada e Hostm.com
• Implantações Guiadas: Prompts para orientar os usuários durante o processo de implantação
• Gerenciamento de Autenticação: Armazenamento seguro das credenciais dos provedores de hospedagem
• Solução de Problemas: Ferramentas integradas para diagnosticar e corrigir problemas comuns de implantação
• Foco em Hospedagem Compartilhada: Implantação simplificada em ambientes tradicionais de hospedagem compartilhada

Status

Este projeto está atualmente em desenvolvimento inicial. Contribuições e feedback são bem-vindos!

Começando

Pré-requisitos

• Python 3.10+
• Cliente MCP (ex.: Claude Desktop)
• Contas nos provedores de hospedagem, conforme necessário

Instalação

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

Configuração

Crie um arquivo .env com sua configuração:

SECURE_STORAGE_PATH=~/.arc/credentials

Uso

Executando pela linha de comando

# Start the server directly
arc

# With debug logging
arc --debug

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

Usando com o Claude Desktop

1. Edite o arquivo de configuração do Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\\Claude\\claude_desktop_config.json

2. Adicione a configuração do servidor Arc:

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

3. Reinicie o Claude Desktop.

4. Comece conversas com o Claude sobre a implantação de suas aplicações!

Arquitetura

Arc é construído sobre uma arquitetura modular:

• Gerenciador de Credenciais: Armazena e recupera credenciais dos provedores com segurança
• Handlers de Frameworks: Lógica de implantação específica de cada framework
• Provedores de Hospedagem: Operações de implantação específicas de cada provedor
• Interface MCP: Expõe ferramentas, recursos e prompts por meio do Model Context Protocol

Provedores Suportados

Provedor	Status	Recursos
Netlify	✅ Completo	Serverless, Edge, Forms
Vercel	✅ Completo	Serverless, Edge, Analytics
Hospedagem Compartilhada	✅ Completo	SSH/SFTP, PHP, MySQL
Hostm.com	✅ Completo	Hospedagem Compartilhada, Acesso via API

Frameworks Suportados

Framework	Status	Recursos
Wasp	✅ Completo	Framework JS Full-Stack
Next.js	🚧 Planejado	Framework React
Astro	🚧 Planejado	Gerador de Sites Estáticos

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Desenvolvimento

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

# Run tests
pytest

# Run linting
flake8

Licença

Este projeto está licenciado sob a Licença MIT — consulte o arquivo LICENSE para obter detalhes.

Agradecimentos

• Model Context Protocol por viabilizar esta integração
• Wasp pelo excelente framework utilizado em nosso suporte inicial