Familiar MCP Server
officielUn copilote IA pour Foundry VTT : gérez les combats, mettez en scène et faites parler les PNJ en discutant avec votre assistant. 193 outils répartis dans 24 domaines, fonctionne avec le contenu que vous possédez déjà.
Documentation
Apportez votre propre IA, parmi 23 fournisseurs. Conçu pour D&D 5e (2024).
Votre copilote IA pour Foundry VTT.
Vous avez acheté Foundry pour mener le jeu pour tout le monde. Familiar prend le parti du maître du donjon : les règles, les dés, les monstres, chaque PNJ avec sa propre voix. Pour qu'enfin, vous puissiez jouer. En solo, en duo, ou en groupe complet.
Installer dans FoundryRejoindre le Discord
Pause
Installer
Installer Familiar dans Foundry
Familiar est distribué directement depuis GitHub. Collez cette URL dans la boîte de dialogue d'installation de module de Foundry.
URL du manifeste : https://github.com/Ryanjansen92/familiar-releases/releases/latest/download/module.jsonCopier l'URL du manifeste
- Dans Foundry, ouvrez Configuration → Modules complémentaires
- Cliquez sur Installer un module
- Collez l'URL dans le champ URL du manifeste en bas, puis installez. Afficher la boîte de dialogue d'installation de module
Foundry VTT
v13, v14
Système de jeu
D&D 5e (règles 2024) : support complet. Les autres systèmes bénéficient des fonctionnalités générales (chat, journaux, scènes, audio) mais pas des outils spécifiques au système comme les feuilles de personnage ou l'automatisation des combats.
Au grand jour. Publié sur npm et GitHub, avec des questions répondues sur Discord.
- npmfamiliar-vtt
- GitHubreleases
- Discordposez toutes vos questions
Apportez votre propre IA
Connectez l'IA que vous utilisez déjà.
Collez une clé API, ou dirigez Familiar vers l'abonnement Claude ou ChatGPT que vous payez déjà. Les deux chemins mènent aux mêmes 193 outils ; la différence réside dans l'endroit où le modèle s'exécute et qui vous payez.
Chat intégré
Collez une clé API et commencez à parler à votre jeu.
Pas de serveur, pas de terminal, pas de fichiers de configuration. Le seul chemin avec la voix, la génération d'images et la transcription en plus du chat. Un contrôle de Réflexion vous permet de définir l'intensité du raisonnement du modèle, augmentée pour les combats difficiles, réduite pour les recherches rapides.
Chat (14 fournisseurs)
- OpenRouter
- Anthropic
- OpenAI
- Groq
- Mistral
- Together AI
- DeepSeek
- xAI
- Cohere
- Perplexity
- Fireworks AI
- Cerebras
- SambaNova
OpenRouter débloque plus de 300 modèles avec une seule clé.
Voix (3 fournisseurs)
- ElevenLabs
- Cartesia
- OpenAI TTS
Image (3 fournisseurs)
- OpenAI (GPT Image)
- fal.ai
- Leonardo AI
Transcription (3 fournisseurs)
- Gladia
- Deepgram
- AssemblyAI
Utilisez votre abonnement
Vous payez déjà pour Claude, ChatGPT/Codex, ou avez un compte Google ? Mettez-le au travail.
Connectez-vous via le Model Context Protocol et votre abonnement existant devient un assistant MD sans coût API supplémentaire. Le module est livré avec un assistant de configuration MCP qui détecte votre client et génère la configuration à coller. Idéal pour les longues chaînes en plusieurs étapes. Votre modèle et son effort de raisonnement sont définis dans votre propre client, pas ici.
Clients MCP (7 fournisseurs)
-
Claude Desktop
-
Claude Code
-
Codex CLI
-
Codex Desktop
-
Antigravity CLI
-
Antigravity Editor
-
LM Studio
Vos clés, votre coût.
La plupart des outils d'IA pour jeux de rôle passent par leurs serveurs, majorent les tokens et vous facturent par tour. Vous tombez à court de crédits en pleine session ? Dommage. Familiar ne proxyfie ni ne majore jamais rien : vos clés API vont directement de votre navigateur au fournisseur, et avec MCP, votre abonnement s'en charge. Pas d'intermédiaire, pas de compteur par tour.
Combat & IA
31 outils gèrent les rencontres de bout en bout : initiative, attaques, sorts, dégâts, états, jets de sauvegarde contre la mort et PX. Familiar résout chaque action de PNJ, y compris les attaques multiples et les actions légendaires, à partir d'un instantané du champ de bataille avec analyse des couverts.
- Initiative, tours, rounds : tout le déroulement de la rencontre
- Jets d'attaque, de sauvegarde et de dégâts, entièrement automatisés
- États, jets de sauvegarde contre la mort, PX
- Pilotez les tours des PNJ à partir d'un instantané du champ de bataille, quand vous le souhaitez
- Mouvement évalué avec analyse des couverts
- Attaques multiples et actions légendaires résolues
Lancez l'initiative pour tous les gobelins, faites-leur attaquer le joueur le plus proche et lancez une musique de combat.
Voix des PNJ
Donnez à chaque PNJ sa propre voix. Synthèse vocale multi-voix via ElevenLabs, Cartesia et OpenAI. Familiar se souvient de qui ressemble à qui, pour que l'aubergiste ait toujours la voix de l'aubergiste.
- Donnez à chaque PNJ sa propre voix
- Prononcez n'importe quelle réplique à voix haute avec la voix d'un personnage
- Doublez toute une scène, une voix différente par interlocuteur
- Attribuez une voix fixe à n'importe quel personnage
- Synthèse vocale multi-voix via trois fournisseurs
- ElevenLabs, Cartesia, OpenAI TTS
Tamisez les lumières, déclenchez la pluie et le tonnerre, et faites chuchoter à l'aubergiste un avertissement sur la route à venir, avec sa voix.
Scènes, canevas et illustrations
Construisez toute la scène sur demande : pions, murs et portes, éclairage, météo, brouillard de guerre, zones de déclenchement. Générez ensuite l'illustration pour la remplir, d'un fond de carte de combat au portrait de l'inconnu qui vient d'entrer. Familiar la place, vous la dirigez.
- Créez des scènes et faites apparaître des pions depuis n'importe quel compendium
- Dessinez des murs, des portes et des zones de déclenchement
- Définissez l'éclairage, l'obscurité et les effets météorologiques
- Brouillard de guerre, son ambiant et contrôle de la caméra
- Générez un fond de carte de combat à partir d'une description textuelle
- Générez des portraits de personnages et des illustrations d'objets en ligne
Générez une carte de combat de cimetière brumeux, donnez-moi trois options et utilisez la deuxième comme arrière-plan.
Audio et atmosphère
Lisez, arrêtez et gérez les listes de lecture et les pistes individuelles avec contrôle du volume et fondu. Lancez une musique de combat, créez des paysages sonores ambiants ou coupez tout sans toucher à la barre latérale de Foundry.
- Lisez, arrêtez et mettez en file d'attente des listes de lecture
- Contrôle individuel des pistes avec volume et fondu
- Fondu enchaîné entre les pistes
- Lancez une musique de combat au début du combat
- Créez des paysages sonores ambiants
- Coupez tout sans toucher à la barre latérale
Lancez la liste de lecture de la taverne, baissez les lumières et laissez le barde jouer une douce piste de luth en fond.
Connaissance et mémoire
Recherche sémantique dans tous les journaux, personnages, scènes et objets. Une banque de mémoire persistante stocke les faits importants de la campagne qui perdurent entre les sessions, avec une gestion complète des journaux pour les notes de session et les documents.
- Recherche sémantique dans les journaux, personnages, scènes, objets
- Banque de mémoire persistante entre les sessions
- Résumez les sessions quand vous dites avoir terminé
- Gestion complète des journaux et des documents
- Création et édition de repères sur carte
- Envoyez et lisez les messages du chat depuis n'importe quelle source
On a fini pour ce soir. Résume ce qui s'est passé cette session et sauvegarde-le.
Personnages et objets
Inspectez, créez, mettez à jour et clonez les acteurs, l'inventaire, les sorts, les capacités et les effets actifs. Importez depuis les compendiums, appliquez des bonus personnalisés et gérez la propriété des joueurs.
- Inspectez, créez, mettez à jour et clonez des acteurs
- Gérez l'inventaire, les sorts et les capacités
- Appliquez et activez/désactivez les effets actifs (bonus et malus)
- Importez depuis n'importe quel pack de compendium
- Configurez la propriété et les permissions des joueurs
- Faites des jets sur les tables pour les rencontres aléatoires et le butin
Trouve un loup-garou de FP 3 dans le compendium, place-le dans la scène comme boss et donne-lui une résistance aux armes non argentées.
Pilote automatique
Cliquez sur "Exécuter PNJ" et laissez faire. Familiar joue chaque tour ennemi pour vous, avec des limites de sécurité et une confirmation tour par tour optionnelle.
- Un clic exécute chaque tour de PNJ dans la rencontre
- Des limites de sécurité empêchent les boucles infinies
- Confirmation tour par tour quand vous le souhaitez
- Fonctionne avec le traqueur de combat standard
- Les instantanés du champ de bataille informent les décisions tactiques
- S'arrête au round ou au tour que vous indiquez
Exécute tous les tours des PNJ ce round. Arrête-toi après le passage du dragon.
Transcription en direct
Parlez au lieu de taper. Familiar transcrit votre session en temps réel via trois fournisseurs, code en couleur par interlocuteur et enregistre la transcription dans une entrée de journal Foundry que vous pourrez éditer et rechercher plus tard.
- Parlez au lieu de taper au milieu d'une scène
- Transcription en temps réel via trois fournisseurs
- Codage couleur par interlocuteur
- Sauvegarde directement dans une entrée de journal Foundry
- Éditez et recherchez la transcription par la suite
- Gladia, Deepgram, AssemblyAI
Commence à transcrire la session. Sauvegarde-la dans un journal appelé 'Session 12' quand on aura fini.
Chat multi-session
Épinglez, archivez et basculez entre des fils de discussion de campagne nommés. Chaque fil persiste en tant qu'entrée de journal Foundry avec un journal d'audit complet, vous permettant de revenir à n'importe quelle conversation plus tard, même des mois après.
- Épinglez, archivez et renommez les fils de campagne
- Chaque fil persiste en tant qu'entrée de journal Foundry
- Journal d'audit complet de chaque appel d'outil
- Basculez entre les fils sans perdre le contexte
- Recherchez dans les conversations passées
- Rouvrez une quête secondaire mise en pause en quelques secondes
Parcourez les 193 outils dans 24 domaines
Fonctionne ensemble
Construit autour du contenu que vous possédez déjà.
Familiar ne remplace pas vos modules, cartes ou campagnes. Il les lit, les exécute et reste discret.
-
Campagnes pré-écrites
Ouvrez Ember, Dragon of Icespire Peak ou toute aventure publiée. Familiar lit les entrées de journal, les PNJ et les rencontres qui l'accompagnent, et les exécute à la table sans inventer de contradictions.
-
Cartes de combat que vous utilisez déjà
Déposez une carte Czepeku ou Patreon. Familiar récupère les pions, lumières, murs et sons ambiants que vous avez configurés, et exécute le combat par-dessus le travail d'un autre.
-
Compendiums et votre propre contenu maison
Vos PNJ personnalisés, vos règles maison, vos imports D&D Beyond. Familiar lit ce qui est déjà dans votre monde au lieu d'inventer des choses.
Familiar ne fournit pas ses propres aventures, cartes ou compendiums. Le contenu est le vôtre. Votre IA raconte l'histoire que vous apportez, elle n'en invente pas une, et Familiar gère le côté maître du donjon de la table par-dessus.
Jouable à toute table
Jouez à D&D en solo, en duo ou en groupe complet.
Quel que soit le nombre de participants, vous pouvez jouer. Moins il y a d'humains à la table, plus Familiar gère d'aspects du monde, les règles, les dés, les monstres, chaque PNJ. Vous prenez place au jeu que vous menez habituellement pour les autres.
-
Solo
Juste vous
Vous jouez votre personnage. Familiar gère tout ce qui l'entoure : chaque PNJ avec sa propre voix, le tour de chaque monstre, la scène, avec les règles de D&D 5e 2024 appliquées. La mémoire de campagne transporte le monde d'une session à l'autre.
-
Duo
Vous et un autre
Aucun de vous n'a besoin d'être le MD. Familiar dirige le monde pour vous deux, les personnages, les rencontres, les décisions, pour que vous restiez joueurs et que l'histoire avance quand même.
-
Petite table
Vous et quelques autres
Les seconds rôles et les tours des monstres sont gérés pour vous, avec l'éclairage, la musique et les décisions, pour que personne ne sorte du jeu pour le faire avancer.
-
Groupe complet
Vous maîtrisez pour quatre ou plus
La charge tactique est retirée du MJ. Vous dirigez la rencontre et racontez l'histoire ; Familiar gère l'initiative, les tours des monstres et la tenue des comptes. Vous dirigez la scène, pas le tableur.
Un copilote, pas un MD de remplacement. Qui que ce soit à la table, c'est toujours vous qui racontez l'histoire, et les dés comme les calculs sont toujours justes. Pas de "vous avez fait 47".
Comment ça marche
Un message entré. Familiar exécute les actions Foundry en sortie.
Pas de nouvelle application à apprendre, ni de commandes à mémoriser. Familiar fonctionne depuis son propre chat dans Foundry, ou depuis un client MCP que vous utilisez déjà.
-
Vous parlez
Tapez dans le chat de Familiar à l'intérieur de Foundry, ou connectez un client MCP comme Claude, Codex ou Antigravity. Votre IA lit la scène et choisit lequel des 193 outils appeler.
2. ### Via un socket sécurisé
Les appels d'outils atteignent votre monde via un WebSocket authentifié. Votre clé API va directement de votre navigateur à votre fournisseur. Familiar ne la proxyfie ni ne la stocke jamais.
3. ### Familiar l'exécute
Le module exécute les mêmes opérations Foundry que vous feriez manuellement : lancer l'initiative, placer des pions, régler les lumières, lancer la musique. Vous restez dans votre personnage.
Le chat intégré ne nécessite rien de plus. MCP ajoute un petit serveur local que vous démarrez avec une seule commande.
Pourquoi j'ai construit cela
Un copilote pour le maître de jeu qui préfère diriger l'histoire plutôt que le tableur.
Je suis Ryan. Papa de deux jeunes enfants, marié à ma personne préférée, avec le temps libre que vous imaginez. Ma femme et moi jouons à D&D ensemble, rien que nous deux, des campagnes en tête-à-tête. C’est notre truc. Mais mener le jeu en solo, c’est lourd. Vous êtes le conteur, chaque PNJ, le moteur de règles, le technicien son et l’ambiance, tout à la fois. En plein monologue en tant qu’étranger mystérieux, je devais briser le personnage pour lancer l’initiative, vérifier la portée d’un sort, ajuster l’éclairage et retrouver cette piste d’ambiance de taverne que j’étais sûr d’avoir mise en favori. Le temps de revenir à la scène, l’instant était perdu.
Je voulais quelque chose qui puisse gérer le côté mécanique de la table pour que je puisse rester dans l’histoire. Pas un MJ de remplacement, un copilote. Quelque chose à qui je pourrais dire « lance l’initiative pour les gobelins, tamise les torches et lance la musique de combat », et qui s’en occuperait. Pendant que je continuais à parler.
Alors j’ai commencé à construire. D’abord une poignée d’outils pour déplacer les pions et lancer les dés. Ensuite j’ai ajouté le suivi des combats. Puis la gestion des scènes. Puis « et si ça pouvait aussi générer des portraits de PNJ à la volée ? » et « et si ça pouvait donner une voix au tavernier ? » C’est comme ça qu’on se retrouve avec 193 outils répartis sur 24 domaines et 23 fournisseurs d’IA.
J’ai pris mon temps. J’ai fait tourner Familiar à ma propre table, session après session, avant de l’ouvrir. Je ne voulais pas livrer une énième IA qui transforme votre campagne en n’importe quoi dès qu’elle oublie la semaine dernière.
Ça a commencé comme un petit bricolage personnel pour un père qui voulait mener de meilleures parties de D&D pour sa femme. Il s’avère que beaucoup de MJ ont la même envie.
Ryan, qui travaille sur Familiar
Tarifs
Un mois gratuit. Vos clés, votre coût.
4 $ par mois ou 36 $ par an assurent la maintenance de Familiar. Votre fournisseur d’IA vous facture directement les jetons que vous dépensez. Pas de majoration, pas d’intermédiaire, pas de limite par tour.
Nourrir le Familiar4 $par mois
Le faire tourner un an36 $par anéconomisez 3 mois
Gratuit le premier mois, puis 4 $.
Facturé mensuellement ou annuellement. Annulez à tout moment.
Installer dans Foundryou commencez votre mois gratuit
- Les 193 outils sur tous les systèmes Foundry pris en charge
- Chaque mise à jour. IA de combat, voix, image, transcription, mémoire
- BYOK ou MCP. Connectez n’importe quel fournisseur de la liste
- Rapports de bugs et idées de fonctionnalités bienvenus sur Discord
Ce que vous payez à votre fournisseur d’IA
Familiar ne proxyfie ni ne majore jamais les jetons. Anthropic, OpenAI, OpenRouter, votre abonnement MCP : vous configurez la clé, ils vous facturent. Une session D&D typique coûte entre 0,50 $ et 3 $ en frais d’API, selon le modèle. Ou rien : un abonnement via MCP ou un modèle local dans LM Studio ne vous coûte aucun jeton.
Questions fréquentes
Des réponses honnêtes.
Les questions que les joueurs et les MJ posent vraiment, avec des réponses directes. La liste complète est sur GitHub.
-
Qu’est-ce que Familiar ?
Familiar est un copilote IA pour Foundry VTT. Vous connectez l’IA que vous utilisez déjà, comme Claude ou ChatGPT, via le Model Context Protocol ou une clé API, et elle gère le côté maître du donjon d’une aventure D&D 5e publiée que vous importez : les règles, les dés, les monstres et les voix des PNJ. Vous restez le joueur et gardez l’histoire ; Familiar s’occupe de la table.
-
Comment connecter Claude ou ChatGPT à Foundry VTT ?
Deux façons, et vous apportez votre propre IA pour les deux. Utilisez l’abonnement Claude, ChatGPT ou Codex que vous payez déjà via le Model Context Protocol, et Familiar fonctionne comme un serveur MCP auquel ces clients se connectent. Ou collez une clé API dans le chat intégré. Les mêmes outils fonctionnent dans les deux cas ; la différence réside dans l’endroit où le modèle tourne et à qui vous payez.
Lire le guide de connexion
-
Familiar collecte-t-il mes données ?
Pas de télémétrie, pas d’analyse, pas d’appel vers l’extérieur. Familiar tourne dans votre monde Foundry ; les données ne sortent que lorsque vous envoyez un message au fournisseur d’IA choisi. Faites tourner un modèle local dans LM Studio via MCP pour jouer entièrement hors ligne.
-
L’IA peut-elle casser mon monde ?
Les mises à jour des documents sont assainies, donc l’IA ne peut pas changer la propriété, les permissions ou les identifiants internes. Les opérations destructrices exigent une confirmation, et la connexion WebSocket est authentifiée avec un secret partagé. Faites des sauvegardes quand même : une bonne pratique avec ou sans IA.
-
Est-ce que ça marche avec d’autres systèmes que D&D 5e ?
Le support complet est pour D&D 5e (règles 2024) uniquement. Les fonctionnalités génériques comme les dés, les journaux, les scènes et l’audio marchent partout, mais les outils spécifiques au système (feuilles de personnage, automatisation des combats) sont construits autour du modèle de données dnd5e. Pathfinder 2e, L’Appel de Cthulhu et Savage Worlds sont sur la feuille de route.
-
Quels modèles d’IA fonctionnent le mieux ?
N’importe quel modèle phare actuel d’Anthropic, OpenAI ou Google gère mieux l’utilisation d’outils ; consultez le guide « Choisir un modèle d’IA » pour les niveaux nommés. Apportez la clé ou l’abonnement que vous payez déjà. La marge de raisonnement est ce qui porte un combat difficile ou une scène embrouillée : le chat intégré a un contrôle Pensée que vous pouvez monter quand un moment le mérite, et via MCP ce réglage se trouve dans votre propre client.
-
Une IA peut-elle m’aider à jouer à D&D en solo ?
Oui, c’est une raison principale de son existence. La plupart des gens qui possèdent Foundry sont le MJ, celui qui n’a jamais l’occasion de jouer. Familiar gère les règles, les monstres et les PNJ, et se souvient de votre campagne d’une session à l’autre, pour que vous puissiez vous asseoir à votre propre table, en solo ou en tête-à-tête. C’est comme ça que Familiar a commencé : du D&D en tête-à-tête avec ma femme.
-
Ai-je besoin de ma propre campagne pour commencer ?
Non. Achetez une aventure prête pour Foundry (les modules D&D officiels coûtent environ 20 à 30 $, avec les cartes et l’éclairage déjà intégrés), ajoutez une ou deux cartes de combat, activez Familiar, et vous jouez. Familiar lit les journaux de l’aventure pour connaître l’histoire que vous allez découvrir, et pioche les monstres et les objets dans vos compendiums au fur et à mesure.
-
L’IA joue-t-elle un personnage à mes côtés ?
Pas encore. Familiar gère le côté MJ, les règles, les monstres et les PNJ, pour que vous jouiez votre propre personnage. Laisser l’IA gérer les tours d’un allié à vos côtés est sur la feuille de route, pas encore livré. Les surprises viennent de l’aventure et du brouillard de guerre de Foundry, pas de l’IA qui garde des secrets. Une IA ne peut pas cacher ce qu’elle peut lire.
-
Une IA peut-elle mener ma partie en tant que Maître du Donjon ?
Oui, avec une nuance honnête. Les IA sont mauvaises pour inventer une histoire, donc Familiar ne leur demande pas. Vous apportez une aventure publiée avec ses cartes et ses PNJ, votre IA la lit et la mène, et un humain peut reprendre la main à tout moment. Connectez votre propre IA et elle gère tout le côté MJ avec une mémoire de votre campagne d’une session à l’autre.
Feuille de route
Ce sur quoi je travaille.
Aucune promesse sur les délais. En gros par ordre de priorité.
Meilleur jeu en solo et en duo.
Pour le MJ qui mène la table pour tout le monde et veut jouer pour une fois. Familiar gère déjà le côté MJ ; ces améliorations l’affûtent pour une table d’une ou deux personnes.
- Remplissage de groupe par compagnon : laisser l’IA gérer les tours de combat d’un allié désigné
- Mise à l’échelle des rencontres : équilibrer un combat pour un groupe solo ou duo
- Mode solo : un préréglage en un clic pour les règles, les monstres et les voix des PNJ
Parler aux modules que vous utilisez déjà.
Laisser Familiar piloter le reste de votre stack Foundry : jets automatisés, animations, butin, effets.
- Midi-QOL : jets d’attaque et sauvegardes automatisés
- Sequencer + JB2A : orchestrer les animations de sorts
- Token Magic FX : effets de shader sur les pions et les tuiles
- Item Piles : butin et marchands
- DFreds Convenient Effects : effets de statut et buffs
Plus de systèmes, au-delà de D&D 5e.
Outils complets spécifiques au système : feuilles de personnage, automatisation des combats, résolution des sorts.
- D&D 5e (2024)Livré
- Pathfinder 2ePrévu
- L’Appel de CthulhuPrévu
- Savage WorldsPrévu
Campagnes prêtes à jouer.
Importez une aventure publiée et Familiar connaît déjà l’histoire, les PNJ, les cartes et les rencontres. En commençant par Ember.
Ember est la campagne bac à sable officielle de 500 heures de Foundry. D’autres aventures publiées suivront.
Affûter ce qui est déjà livré.
- IA de combat : retraite, moral, coordination de groupe
- Voix : contrôle des émotions, scènes multi-voix plus naturelles
- Image : portraits de personnages cohérents d’une session à l’autre
- MCP : retour de progression des outils en temps réel plus riche pour les clients externes
Vous avez une idée ? Discord est le meilleur endroit pour faire remonter quelque chose dans la liste.
Prêt à jouer pour une fois ?
Installez Familiar dans Foundry et votre premier mois est offert. Annulez à tout moment, votre monde reste le vôtre.
Je suis Ryan, j’ai construit Familiar. Rejoignez le Discord et je vous aiderai personnellement à démarrer.