MCP OVHcloud Web Hosting

Serveur MCP (Model Context Protocol) pour piloter les services OVHcloud Web Hosting via les APIs OVH.

Fonctionnalités

• 8 tools read-only pour consulter vos services Web Hosting
• 6 tools write (désactivés par défaut) pour gérer vos services
• 2 modes de transport : stdio (Cursor, Claude Desktop) ou HTTP (SHAI)
• 3 modes d'authentification : Bearer passthrough, OAuth2 Service Account, AK/AS/CK
• Gestion des erreurs avec mapping vers codes MCP standard
• Rate limiting côté client (token bucket)
• Retries automatiques avec backoff exponentiel
• Logs structurés (Pino) avec masquage des secrets
• Audit logging des appels de tools

Prérequis

• Node.js >= 18.0.0
• Un compte OVHcloud avec au moins un service Web Hosting
• Credentials API OVH (selon le mode d'authentification choisi)

Installation

# Cloner le repo
git clone <repository-url>
cd mcp-ovh-webhosting

# Installer les dépendances
npm install

# Copier la configuration exemple
cp env.example .env

# Compiler le TypeScript
npm run build

Modes de Transport

Mode stdio (défaut)

Pour les clients MCP locaux comme Cursor ou Claude Desktop.

# Démarrer en mode stdio
npm start
# ou
npm run dev

Mode HTTP (pour SHAI)

Pour les clients HTTP comme SHAI. Expose un endpoint /mcp avec SSE.

# Démarrer en mode HTTP
npm run start:http
# ou
MCP_TRANSPORT=http npm start
# ou
MCP_TRANSPORT=http MCP_HTTP_PORT=8080 npm run dev

Le serveur affiche :

MCP Server is running on http://0.0.0.0:8080/mcp

Configuration avec SHAI

1. Démarrer le serveur MCP sur votre SDEV

cd mcp-ovh-webhosting
MCP_TRANSPORT=http MCP_HTTP_PORT=<VOTRE_PORT_SDEV> npm run start:http

Remplacez <VOTRE_PORT_SDEV> par un port dans la plage autorisée de votre SDEV :

cat /etc/ovh.conf.d/sdev.conf | grep "SDEV_PORT_"

2. Configurer l'agent SHAI

Créez le fichier ~/.config/shai/agents/ovh_webhosting.config :

{
  "name": "ovh_webhosting",
  "description": "Agent pour piloter OVHcloud Web Hosting",
  "llm_provider": {
    "provider": "ovhcloud",
    "env_vars": {
      "OVH_API_KEY": "votre_AI_endpoints_token"
    },
    "model": "Qwen3-Coder-30B-A3B-Instruct",
    "tool_method": "FunctionCall"
  },
  "tools": {
    "builtin": ["*"],
    "builtin_excluded": [],
    "mcp": {
      "ovh": {
        "config": {
          "type": "http",
          "url": "http://gw2sdev-docker.ovh.net:<VOTRE_PORT_SDEV>/mcp",
          "bearer_token": "votre_token_api_ovh"
        },
        "enabled_tools": ["*"],
        "excluded_tools": []
      }
    }
  },
  "system_prompt": "{{CODER_BASE}}",
  "max_tokens": 1000000,
  "temperature": 0.0
}

3. Lancer SHAI

shai agent ovh_webhosting

Vous verrez les tools MCP disponibles :

░ MCP 'ovh' connected (authenticated)
░ mcp(ovh): ovh.webhosting.listServices, ovh.webhosting.getService, ...

Modes d'authentification OVH

Mode Bearer (passthrough) - Recommandé pour SHAI

Le token est passé par le client MCP (SHAI) et transmis tel quel à l'API OVH.

# Configuration minimale pour mode HTTP + Bearer
MCP_TRANSPORT=http
OVH_AUTH_MODE=bearer  # Défaut en mode HTTP
OVH_API_REGION=eu

Le bearer_token configuré dans SHAI est automatiquement utilisé pour authentifier les appels à l'API OVH.

Mode OAuth2 Service Account

Pour les automatisations internes sans SHAI.

OVH_AUTH_MODE=oauth2
OVH_API_REGION=eu
OVH_OAUTH_CLIENT_ID=votre-client-id
OVH_OAUTH_CLIENT_SECRET=votre-client-secret
OVH_OAUTH_SCOPE=all

Créer un Service Account

1. Connectez-vous à la Console OVHcloud
2. Mon compte → Gestion des comptes → Comptes de service
3. Créer un compte de service
4. Notez le Client ID et Client Secret

Créer une Policy IAM

{
  "name": "webhosting-full-access",
  "description": "Accès complet aux services Web Hosting",
  "permissions": {
    "allow": [
      { "action": "webHosting:apiovh:get" },
      { "action": "webHosting:apiovh:create" },
      { "action": "webHosting:apiovh:update" },
      { "action": "webHosting:apiovh:delete" }
    ]
  },
  "resources": [
    { "urn": "urn:v1:eu:resource:webHosting:*" }
  ]
}

Mode AK/AS/CK

Pour la délégation de droits ou l'usage avec des applications existantes.

OVH_AUTH_MODE=akasck
OVH_API_REGION=eu
OVH_APP_KEY=votre-application-key
OVH_APP_SECRET=votre-application-secret
OVH_CONSUMER_KEY=votre-consumer-key

Configuration dans Cursor / Claude Desktop

Pour les clients MCP locaux, utilisez le mode stdio :

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ovh-webhosting": {
      "command": "node",
      "args": ["/chemin/vers/mcp-ovh-webhosting/dist/server.js"],
      "env": {
        "OVH_AUTH_MODE": "oauth2",
        "OVH_API_REGION": "eu",
        "OVH_OAUTH_CLIENT_ID": "votre-client-id",
        "OVH_OAUTH_CLIENT_SECRET": "votre-client-secret"
      }
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "ovh-webhosting": {
      "command": "node",
      "args": ["/chemin/vers/mcp-ovh-webhosting/dist/server.js"],
      "env": {
        "OVH_AUTH_MODE": "oauth2",
        "OVH_API_REGION": "eu",
        "OVH_OAUTH_CLIENT_ID": "votre-client-id",
        "OVH_OAUTH_CLIENT_SECRET": "votre-client-secret"
      }
    }
  }
}

Tools disponibles

Read-only (MVP)

Tool	Description	Endpoint OVH
ovh.webhosting.listServices	Liste tous les services Web Hosting	GET /hosting/web/
ovh.webhosting.getService	Détails d'un service	GET /hosting/web/{serviceName}
ovh.webhosting.getActiveConfiguration	Configuration active	GET /hosting/web/{serviceName}/configuration
ovh.webhosting.listDatabases	Liste les bases de données	GET /hosting/web/{serviceName}/database
ovh.webhosting.listFtpUsers	Liste les utilisateurs FTP/SSH	GET /hosting/web/{serviceName}/user
ovh.webhosting.listModuleCatalog	Catalogue des modules	GET /hosting/web/moduleList
ovh.webhosting.getModuleCatalogItem	Détails d'un module	GET /hosting/web/moduleList/{id}
ovh.webhosting.listDatabaseDumps	Liste les dumps d'une BDD	GET /hosting/web/{serviceName}/database/{name}/dump

Write (nécessite ENABLE_WRITE_TOOLS=true)

Tool	Description	Endpoint OVH
ovh.webhosting.attachDomain	Attache un domaine	POST /hosting/web/{serviceName}/attachedDomain
ovh.webhosting.installSsl	Installe un certificat SSL	POST /hosting/web/{serviceName}/ssl
ovh.webhosting.createDatabase	Crée une base de données	POST /hosting/web/{serviceName}/database
ovh.webhosting.createDatabaseDump	Crée un dump de BDD	POST /hosting/web/{serviceName}/database/{name}/dump
ovh.webhosting.restoreDatabaseDump	[DESTRUCTIF] Restaure un dump	POST /hosting/web/{serviceName}/database/{name}/dump/{id}/restore
ovh.webhosting.installModule	Installe un module (WordPress, etc.)	POST /hosting/web/{serviceName}/module

Variables d'environnement

Transport MCP

Variable	Description	Défaut
MCP_TRANSPORT	Mode de transport: stdio ou http	stdio
MCP_HTTP_PORT	Port HTTP (mode http)	8080
MCP_HTTP_PATH	Chemin de l'endpoint MCP	/mcp
MCP_HTTP_HOST	Host HTTP	0.0.0.0

Authentification OVH

Variable	Description	Défaut
OVH_AUTH_MODE	Mode d'auth: bearer, oauth2, akasck	bearer (http) / oauth2 (stdio)
OVH_API_REGION	Région API: eu ou ca	eu
OVH_OAUTH_CLIENT_ID	Client ID OAuth2 (mode oauth2)	-
OVH_OAUTH_CLIENT_SECRET	Client Secret OAuth2 (mode oauth2)	-
OVH_OAUTH_SCOPE	Scope OAuth2	all
OVH_APP_KEY	Application Key (mode akasck)	-
OVH_APP_SECRET	Application Secret (mode akasck)	-
OVH_CONSUMER_KEY	Consumer Key (mode akasck)	-

Configuration HTTP OVH

Variable	Description	Défaut
OVH_HTTP_TIMEOUT_MS	Timeout HTTP en ms	30000
OVH_MAX_RETRIES	Nombre max de retries	3

Features

Variable	Description	Défaut
ENABLE_WRITE_TOOLS	Activer les tools d'écriture	false
LOG_LEVEL	Niveau de log	info

Endpoints HTTP

En mode HTTP, le serveur expose :

Endpoint	Méthode	Description
/mcp	GET	SSE endpoint pour connexion MCP
/mcp	POST	Messages MCP
/health	GET	Health check
/info	GET	Informations sur le serveur et les tools

Développement

# Lancer les tests
npm test

# Tests en mode watch
npm run test:watch

# Linting
npm run lint

# Formatage
npm run format

# Build
npm run build

Points à valider

Certains endpoints ou paramètres nécessitent validation dans la console OVH :

1. Endpoint création FTP/SSH user : La documentation mentionne un endpoint incohérent.
2. Paramètre domain dans attachDomain : Marqué optionnel mais potentiellement requis.
3. Actions IAM exactes : La liste complète des actions IAM pour les writes est à déterminer.
4. Rate limits OVH : Non documentés, à déterminer empiriquement.

Licence

MIT

Ressources

• Documentation API OVHcloud
• Guide Service Accounts OVH
• Guide API OVH (AK/AS/CK)
• Model Context Protocol
• SHAI Documentation