Servidor MCP de anuncios de Facebook

Este proyecto proporciona un servidor MCP que actúa como interfaz para los anuncios de Facebook, lo que permite el acceso programático a los datos de los anuncios de Facebook y a las funciones de gestión.

Su navegador no soporta la etiqueta de vídeo.

Configuración sencilla con un solo clic

Para una experiencia de configuración más sencilla, ofrecemos instaladores listos para usar:

⊞ Windows: 👉 Descargar gomarble_mcp_tools.exe
 MacOS: 👉 Descargar gomarble_mcp_tools.pkg

Qué hace

Instala y configura el servidor MCP localmente
Maneja automáticamente la configuración del entorno
Solicita la autenticación del token de Facebook durante el proceso, lo cual es opcional.
Si no se proporciona el token de acceso de Facebook, conéctese al servidor de GoMarble para crear el token en su nombre

Aviso importante

Esta configuración no requiere que obtengas manualmente un token de acceso de desarrollador de Facebook.

En su lugar, se conecta de forma segura al servidor de GoMarble para crear el token en su nombre . GoMarble no almacena su token; este se guarda localmente en su equipo para su uso con el servidor MCP.

Configuración

Prerrequisitos

Python 3.10+
Dependencias enumeradas en requirements.txt

(Opcional pero recomendado) Crear y activar un entorno virtual:
python3 -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
El uso de un entorno virtual ayuda a gestionar las dependencias del proyecto de forma limpia [Fuente] .
Dependencias de instalación:
pip install -r requirements.txt
Obtener un token de acceso de Facebook: Consigue un token de acceso de usuario de Facebook con los permisos necesarios (p. ej., ads_read ). Puedes generarlo a través del portal para desarrolladores de Facebook. Sigue este enlace .

Uso con clientes MCP (por ejemplo, Cursor, Claude Desktop)

Para integrar este servidor con un cliente compatible con MCP, agregue una configuración ( Claude ) similar a la siguiente. Reemplace YOUR_FACEBOOK_ACCESS_TOKEN con su token actual y ajuste la ruta a server.py si es necesario.

{
  "mcpServers": {
    "fb-ads-mcp-server": {
      "command": "python",
      "args": [
        "/path/to/your/fb-ads-mcp-server/server.py",
        "--fb-token",
        "YOUR_FACEBOOK_ACCESS_TOKEN"
      ]
      // If using a virtual environment, you might need to specify the python executable within the 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_FACEBOOK_ACCESS_TOKEN"
      // ]
    }
  }
}

Reinicie la aplicación MCP Client después de realizar la actualización en la configuración.

(Nota: en Windows, es posible que necesites ajustar la estructura del comando o usar cmd /k dependiendo de tu configuración).

Depuración del servidor

Ejecute server.py , proporcionando el token de acceso a través del argumento --fb-token .

python server.py --fb-token YOUR_FACEBOOK_ACCESS_TOKEN

Herramientas MCP disponibles

Este servidor MCP proporciona herramientas para interactuar con objetos y datos de anuncios de Facebook:

Nombre de la herramienta	Descripción
Lectura de cuenta y objeto
`list_ad_accounts`	Enumera las cuentas publicitarias vinculadas al token.
`get_details_of_ad_account`	Recupera detalles de una cuenta publicitaria específica.
`get_campaign_by_id`	Recupera detalles de una campaña específica.
`get_adset_by_id`	Recupera detalles de un conjunto de anuncios específico.
`get_ad_by_id`	Recupera detalles de un anuncio específico.
`get_ad_creative_by_id`	Recupera detalles de una creatividad publicitaria específica.
`get_adsets_by_ids`	Recupera detalles de múltiples conjuntos de anuncios por sus ID.
Obteniendo colecciones
`get_campaigns_by_adaccount`	Recupera campañas dentro de una cuenta publicitaria.
`get_adsets_by_adaccount`	Recupera conjuntos de anuncios dentro de una cuenta de anuncios.
`get_ads_by_adaccount`	Recupera anuncios dentro de una cuenta publicitaria.
`get_adsets_by_campaign`	Recupera conjuntos de anuncios dentro de una campaña.
`get_ads_by_campaign`	Recupera anuncios dentro de una campaña.
`get_ads_by_adset`	Recupera anuncios dentro de un conjunto de anuncios.
`get_ad_creatives_by_ad_id`	Recupera creatividades asociadas a un anuncio.
Información y datos de rendimiento
`get_adaccount_insights`	Recupera información sobre el rendimiento de una cuenta publicitaria.
`get_campaign_insights`	Recupera información sobre el rendimiento de una campaña.
`get_adset_insights`	Recupera información sobre el rendimiento de un conjunto de anuncios.
`get_ad_insights`	Recupera información sobre el rendimiento de un anuncio.
`fetch_pagination_url`	Obtiene datos de una URL de paginación (por ejemplo, de Insights).
Historial de actividades/cambios
`get_activities_by_adaccount`	Recupera el historial de cambios de una cuenta publicitaria.
`get_activities_by_adset`	Recupera el historial de cambios de un conjunto de anuncios.

(Nota: la mayoría de las herramientas admiten parámetros adicionales como fields , filtering , limit , paginación, rangos de fechas, etc. Consulte la documentación detallada en server.py para obtener la lista completa y la descripción de los argumentos para cada herramienta).

(Nota: Si su token de acceso de Facebook caduca, deberá generar uno nuevo y actualizar el archivo de configuración del cliente MCP con el nuevo token para continuar usando las herramientas).

Dependencias

mcp (>=1.6.0)
solicitudes (>=2.32.3)

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Instalación mediante herrería

Para instalar Facebook Ads Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @gomarble-ai/facebook-ads-mcp-server --client claude

Facebook-Ads-MCP-Server

Integrations