Serveur MCP Facebook/Meta Ads
Ce projet fournit un serveur MCP agissant comme une interface avec les Meta Ads, permettant un accès programmatique aux données et aux fonctions de gestion des Meta Ads.
claude_demo.mp4
Installation facile en un clic
Pour une expérience d'installation plus simple, nous proposons des installateurs prêts à l'emploi :
👉 Télécharger le programme d'installation -https://gomarble.ai/mcp
Rejoignez notre communauté pour obtenir de l'aide et des mises à jour
👉 Communauté Slack - AI in Ads
Essayez Google ads mcp server aussi
👉 Google Ads MCP - Google Ads MCP
Ce qu'il fait
- Installe et configure le serveur MCP localement
- Gère automatiquement la configuration de l'environnement
- Demande une authentification par jeton Meta au cours du processus, ce qui est facultatif
- Si le jeton d'accès Meta n'est pas fourni, il se connecte au serveur de GoMarble pour créer le jeton en votre nom
Avertissement important
Cette configuration n'exige pas que vous obteniez manuellement un jeton d'accès développeur Meta.
Au lieu de cela, il se connecte de manière sécurisée au serveur de GoMarble pour créer le jeton en votre nom. GoMarble ne stocke pas votre jeton - il est sauvegardé localement sur votre machine pour être utilisé avec le serveur MCP.
Configuration
Prérequis
- Python 3.10+
- Dépendances listées dans
requirements.txt
- (Facultatif mais recommandé) Créez et activez un environnement virtuel :
python3 -m venv venv
source venv/bin/activate # Sous Windows utiliservenv\Scripts\activate
L'utilisation d'un environnement virtuel permet de gérer proprement les dépendances du projet [Source]. - Installer les dépendances :
pip install -r requirements.txt - Obtenir le jeton d'accès Meta : Obtenir un jeton d'accès utilisateur Meta avec les permissions nécessaires (par exemple,
ads_read). Vous pouvez le générer via le portail Meta Developer. Suivez ce lien.
Utilisation avec des clients MCP (par exemple, Cursor, Claude Desktop)
Pour intégrer ce serveur avec un client compatible MCP, ajoutez une configuration(Claude) similaire à la suivante. Remplacez YOUR_META_ACCESS_TOKEN par votre token réel et ajustez le chemin d'accès à server.py si nécessaire.
{ "mcpServers" : { "fb-ads-mcp-server" : { "command" : "python", "args" : ["/path/to/your/fb-ads-mcp-server/server.py", "--fb-token", "YOUR_META_ACCESS_TOKEN" ] // Si vous utilisez un environnement virtuel, vous devrez peut-être spécifier l'exécutable python dans le venv : // "command" : "/path/to/your/fb-ads-mcp-server/venv/bin/python", // "args" : [ // "/path/to/your/fb-ads-mcp-server/server.py", // "--fb-token", // "YOUR_META_ACCESS_TOKEN" // ] } } }
Redémarrez l'application MCP Client après avoir effectué la mise à jour de la configuration.
(Remarque : sous Windows, il se peut que vous deviez adapter la structure de la commande ou utiliser cmd /k en fonction de votre configuration)
Débogage du serveur
Exécutez server.py, en fournissant le jeton d'accès via l'argument --fb-token.
python server.py --fb-token YOUR_META_ACCESS_TOKEN
Outils MCP disponibles
Ce serveur MCP fournit des outils permettant d'interagir avec les objets et les données des publicités META :
| Nom de l'outil | Description de l'outil |
|---|---|
| Lecture des comptes et des objets | |
| list_ad_accounts | Liste les comptes publicitaires liés au jeton. |
| get_details_of_ad_account | Récupère les détails d'un compte publicitaire spécifique. |
| get_campaign_by_id | Récupère les détails d'une campagne spécifique. |
| get_adset_by_id | Récupère les détails d'un ensemble de publicités spécifique. |
| get_ad_by_id | Récupère les détails d'une publicité spécifique. |
| get_ad_creative_by_id | Récupère les détails d'une création publicitaire spécifique. |
| get_adsets_by_ids | Récupère les détails de plusieurs ensembles de publicités en fonction de leurs identifiants. |
| Récupération de collections | |
| get_campaigns_by_adaccount | Récupère les campagnes d'un compte publicitaire. |
| get_adsets_by_adaccount | Récupère les ensembles de publicités d'un compte publicitaire. |
| get_ads_by_adaccount | Récupère les publicités d'un compte publicitaire. |
| get_adsets_by_campaign | Récupère les jeux de publicités d'une campagne. |
| get_ads_by_campaign | Récupère les publicités d'une campagne. |
| get_ads_by_adset | Récupère les publicités d'un ensemble de publicités. |
| get_ad_creatives_by_ad_id | Récupère les créations associées à une publicité. |
| Informations et données de performance | |
| get_adaccount_insights | Récupère des informations sur les performances d'un compte publicitaire. |
| get_campaign_insights | Récupère des informations sur les performances d'une campagne. |
| get_adset_insights | Récupère des informations sur les performances d'un ensemble de publicités. |
| get_ad_insights | Récupère des informations sur les performances d'une publicité. |
| fetch_pagination_url | Récupère des données à partir d'une URL de pagination (par exemple, à partir d'insights). |
| Historique des activités/modifications | |
| get_activities_by_adaccount | Récupère l'historique des modifications pour un compte publicitaire. |
| get_activities_by_adset | Récupère l'historique des modifications pour un ensemble de publicités. |
(Remarque : la plupart des outils prennent en charge des paramètres supplémentaires tels que les champs, le filtrage, les limites, la pagination, les plages de dates, etc. Reportez-vous à la documentation détaillée de server.py pour obtenir la liste complète et la description des arguments de chaque outil)
(Note : Si votre jeton d'accès Meta expire, vous devrez en générer un nouveau et mettre à jour le fichier de configuration du client MCP avec le nouveau jeton pour continuer à utiliser les outils)
Dépendances
- mcp (>=1.6.0)
- requêtes (>=2.32.3)
Licence
Ce projet est sous licence MIT.
Installation via Smithery
Pour installer Facebook Ads Server pour Claude Desktop automatiquement via Smithery :
npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude