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.

Related MCP server: mcp-servers

Configuración

Prerrequisitos

• Python 3.10+

• Dependencias enumeradas en requirements.txt

1. (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] .

2. Dependencias de instalación:

   pip install -r requirements.txt

3. 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:

(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