Meta AI Demos MCP

Serveur MCP pour utiliser les outils Meta AI Demos (aidemos.meta.com) directement depuis Cursor, sans installer les modèles localement.

Avertissement : client non officiel, reverse-engineered. Non affilié à Meta. Utilisez conformément aux Conditions d'utilisation de Meta AI Demos.

Fonctionnalités

• Authentification par cookies de session (fair_sess, fair_csrf, datr)
• Rafraîchissement automatique des tokens page (lsd, fb_dtsg)
• API GraphQL Relay vers https://www.aidemos.meta.com/api/graphql/
• Outils MCP pour Segment Anything (SAM3) :
  • Vérifier la session
  • Lister / détailler les templates galerie
  • Upload média vers les serveurs Meta
  • Appels GraphQL génériques (31 opérations Relay connues)

Prérequis

• Node.js 18+
• Compte Meta connecté sur aidemos.meta.com/segment-anything/gallery

Installation

git clone https://github.com/ErrorNoName/MetaAPI.git
cd MetaAPI
npm install
npm run build

Configuration des cookies

Option A — Fichier (recommandé)

1. Connectez-vous sur aidemos.meta.com
2. Ouvrez DevTools (F12) → Application → Cookies → https://www.aidemos.meta.com
3. Copiez fair_sess, fair_csrf, datr
4. Créez cookies.json à partir de l'exemple :

copy cookies.example.json cookies.json

{
  "fair_sess": "VOTRE_FAIR_SESS",
  "fair_csrf": "VOTRE_FAIR_CSRF",
  "datr": "VOTRE_DATR"
}

Option B — Variables d'environnement

set META_AIDEMOS_FAIR_SESS=...
set META_AIDEMOS_FAIR_CSRF=...
set META_AIDEMOS_DATR=...

Ou META_AIDEMOS_COOKIES_FILE=C:\chemin\vers\cookies.json

Cursor — configuration MCP

Ajoutez dans .cursor/mcp.json (ou les paramètres MCP globaux) :

{
  "mcpServers": {
    "meta-ai-demos": {
      "command": "node",
      "args": ["C:\\chemin\\vers\\MetaAPI\\dist\\index.js"],
      "env": {
        "META_AIDEMOS_COOKIES_FILE": "C:\\chemin\\vers\\MetaAPI\\cookies.json"
      }
    }
  }
}

Redémarrez Cursor. Les outils aidemos_* apparaissent dans le chat Agent.

Outils MCP disponibles

Outil	Description
aidemos_check_session	Vérifie login + acceptation TOS
aidemos_list_templates	Templates SAM3 de votre galerie
aidemos_get_template	Détails d'un template par ID
aidemos_list_community_templates	Templates communautaires
aidemos_upload_media	Upload image/vidéo/audio
aidemos_get_media	Statut et URL CDN d'un média
aidemos_graphql	Appel GraphQL Relay arbitraire
aidemos_list_operations	Liste des 31 opérations connues
aidemos_refresh_session	Force le refresh des tokens

Exemple d'utilisation dans Cursor

Vérifie ma session Meta AI Demos, puis liste les templates SAM disponibles.

Upload l'image C:\Photos\test.jpg via Meta AI Demos (SAM3_IMAGE).

Architecture

Browser cookies (fair_sess, fair_csrf, datr)
        ↓
MetaAIDemos MCP Server
        ↓
GET aidemos.meta.com → extract lsd + fb_dtsg
        ↓
POST /api/graphql/ (RelayModern + x-csrf-token)
        ↓
Serveurs Meta FAIR (Segment Anything, etc.)

Opérations Relay connues

Les doc_id GraphQL sont extraits des bundles JS Meta et mappés dans src/constants.ts. Exemples :

• SAMRootViewerQuery — session utilisateur
• SAM3DemoRootTemplateGalleryQuery — galerie templates
• useSAMUploadMediaMutation — upload média
• SAM3EditorContextProviderSessionQuery — session éditeur

Limitations

• Inférence SAM (masques) : une partie du pipeline (streaming WASM streamMasks) s'exécute côté navigateur. Ce MCP couvre l'API serveur (upload, templates, GraphQL). L'inférence complète en headless nécessiterait un navigateur automatisé (hors scope v1).
• Expiration cookies : fair_sess expire périodiquement — re-exportez depuis le navigateur si les requêtes échouent.
• Région : aidemos.meta.com peut être indisponible selon la région.

Développement

npm run dev          # build + start
node scripts/test-graphql.js   # test GraphQL manuel (cookies hardcodés — dev only)

Licence

MIT — voir LICENSE.