WOLFRAM

Connexion à Wolfram Local MCP

Ce guide explique comment connecter un moteur Wolfram Engine, tel que Wolfram|One ou Mathematica, à un LLM à l'aide de Wolfram Local MCP. À partir de la version 15, le paquet qui assure cette fonctionnalité est intégré au produit.

Pour savoir comment vous connecter plutôt à Wolfram Cloud MCP, cliquez ici.

Table des matières

Clients de Chat

Pour les échanges courants, utilisez le serveur Wolfram (l'option par défaut). Il associe l'exécution de code au traitement du langage naturel.

Installation

Claude Desktop

Ouvrez une session Wolfram Language et exécutez :

PacletSymbol["Wolfram/AgentTools",
"WolframAgentToolsInstallMCPServer"]["ClaudeDesktop"]

Après l'installation, redémarrez complètement Claude Desktop pour charger les nouveaux outils.

Autres clients de Chat

Pour les autres clients compatibles MCP, générez la configuration JSON brute et adaptez-la manuellement :

MCPServerObject["Wolfram"]["JSONConfiguration"]

Vérification de l'installation

Après le redémarrage, demandez à votre assistant IA :

« Quelle est l'intégrale de sin(x)cos(x) ? »

Si l'IA utilise les outils Wolfram pour calculer la réponse, l'installation fonctionne.

Outils disponibles

Le serveur Wolfram met à disposition plusieurs outils. L'IA sélectionne automatiquement l'outil approprié en fonction de votre demande ; vous n'avez pas besoin de préciser lequel utiliser.

Outil Description
WolframLanguageContext Recherche sémantique parmi les ressources Wolfram (documentation, Wolfram|Alpha, dépôts, etc.)
WolframLanguageEvaluator Exécution du code Wolfram Language
WolframAlpha Requêtes en langage naturel pour Wolfram|Alpha
ReadNotebook Lecture des notebooks Wolfram (.nb) au format Markdown
WriteNotebook Conversion du format Markdown en notebooks Wolfram
SymbolDefinition Recherche des définitions de symboles dans un format lisible
CodeInspector Examen du code pour détecter des problèmes et renvoyer un rapport mis en forme
TestReport Exécution des fichiers de test Wolfram Language (.wlt)

Exemples de cas d'utilisation

Mathématiques et calcul

  • « Résous l'équation x³ - 6x² + 11x - 6 = 0. »
  • « Trouve les valeurs propres de la matrice {{1, 2}, {3, 4}}. »
  • « Calcule la série de Taylor de e^x au voisinage de x=0 à l'ordre 5. »
  • « Quelle est la dérivée de log(sin(x)) ? »

Données et faits

  • « Quelle est la population de la France ? »
  • « À quelle distance se trouve Mars de la Terre en ce moment ? »
  • « Quel est le point d'ébullition de l'éthanol à 0,5 atm ? »
  • « Compare le PIB du Japon et de l'Allemagne au cours des dix dernières années. »

Visualisation

  • « Trace sin(x) et cos(x) de 0 à 2π. »
  • « Crée un graphique à barres comparant la population des 10 plus grandes villes des États-Unis. »
  • « Affiche un tracé en 3D de sin(x*y) pour x et y allant de -pi à pi. »

Recherche de documentation

  • « Comment fonctionne la fonction NestList de Wolfram Language ? »
  • « Quelles options ListPlot prend-il en charge ? »
  • « Montre-moi des exemples sur l'utilisation d'Association avec GroupBy. »

Aide au codage

  • « Écris une fonction en Wolfram Language qui trouve tous les facteurs premiers d'un nombre. »
  • « Comment lire un fichier CSV et calculer les moyennes des colonnes avec Wolfram Language ? »
  • « Explique ce que fait ce code : FoldList[Plus, 0, Range[10]]. »

Consignes persistantes

Les consignes persistantes sont des textes personnalisés que votre client de Chat envoie à l'IA au début de chaque conversation, à la manière de consignes permanentes.

Configurez-les dans Claude Desktop

  1. Ouvrez Claude Desktop.
  2. Allez dans Paramètres (icône en forme d'engrenage).
  3. Sélectionnez l'onglet Général.
  4. Saisissez vos consignes dans la section Profil.
  5. Enregistrez les modifications.

Modèles prêts à l'emploi

Utilisation computationnelle générale

Lorsque je pose des questions mathématiques ou scientifiques, utilise les outils Wolfram pour calculer des réponses exactes plutôt que des approximations. Montre le code Wolfram Language que tu as utilisé afin que je puisse en tirer des leçons.

Pour les questions factuelles (population, distance, propriétés chimiques, etc.), utilise Wolfram|Alpha pour des données à jour.

Lorsque tu produis des tracés ou des visualisations, utilise des étiquettes et des légendes claires.

Apprentissage de Wolfram Language

Je suis en train d'apprendre Wolfram Language. Lorsque je demande comment effectuer une tâche :

1. Utilise d'abord WolframContext pour trouver les fonctions et la documentation pertinentes.
2. Écris le code à l'aide de WolframLanguageEvaluator et montre-moi le résultat.
3. Explique chaque partie du code.
4. Suggère des fonctions connexes susceptibles de m'être utiles.

Privilégie un style idiomatique de Wolfram Language. Utilise des modèles de programmation fonctionnelle (Map, Select, Fold, etc.) plutôt que des boucles procédurales lorsque cela est approprié.

Recherche et analyse de données

J'utilise les outils Wolfram pour la recherche et l'analyse de données. Lorsque je pose des questions :

- Utilise Wolfram|Alpha pour les données et faits actuels.
- Utilise WolframLanguageEvaluator pour les calculs, les statistiques et les visualisations.
- Cite toujours la source des données factuelles (par exemple : « Selon Wolfram|Alpha... »).
- Lors de la création de visualisations, exporte-les en haute résolution.

Pour l'analyse statistique, présente le code et interprète les résultats en langage clair. Inclus les mesures d'incertitude pertinentes le cas échéant.

Conseils pour la personnalisation

  • Soyez précis quant à votre domaine (par exemple : « Je travaille dans le traitement du signal »).
  • Indiquez les préférences d'affichage (par exemple : « Toujours afficher les équations au format LaTeX »).
  • Indiquez votre niveau d'expérience afin que les explications soient adaptées en conséquence.
  • Veillez à ce que les consignes soient concises ; des consignes trop longues risqueraient d'en diluer l'effet.

Conseils pour obtenir les meilleurs résultats

  • Soyez précis. « Trace la fonction de Bessel J0 de 0 à 20, » fonctionne mieux que : « Montre-moi une fonction de Bessel ».
  • Demandez des explications. « Résous ce problème et explique chaque étape, » produit des réponses plus utiles.
  • Itérez sur les visualisations. Commencez par un tracé de base, puis affinez : « Agrandis les axes et ajoute une grille. »
  • Combinez les outils. La consigne « Cherche la formule du rayonnement du corps noir et trace-la pour T = 3000 K, 5000 K et 7000 K » fait appel à la fois à la recherche documentaire et à l'exécution de code.
  • Demandez le code. Utilisez la commande : « Montre-moi le code Wolfram Language, » pour voir ce que l'IA exécute.

Applications de codage basées sur l'IA

Pour le développement en Wolfram Language, utilisez le serveur WolframLanguage. Il confère à l'IA la capacité de :

  • Rechercher parmi les ressources Wolfram, notamment la documentation, le dépôt de fonctions, le dépôt de données et bien plus encore.
  • Exécuter du code pour tester les implémentations et vérifier le comportement.
  • Lire et écrire des notebooks (fichiers .nb) au format Markdown.
  • Consulter les définitions des symboles pour comprendre le code existant.
  • Inspecter le code pour détecter les problèmes potentiels et les défauts de style.
  • Exécuter des tests pour valider les modifications par rapport à votre suite de tests.

Installation

Toutes les méthodes d'installation utilisent la fonction InstallMCPServer. Ouvrez une session Wolfram Language et exécutez la commande appropriée pour votre application.

Claude Code

Global (disponible dans tous les projets) :

InstallMCPServer["ClaudeCode", "WolframLanguage"]

Au niveau du projet (disponible uniquement dans un répertoire spécifique) :

InstallMCPServer[{"ClaudeCode", "/path/to/project"}, "WolframLanguage"]

Vérifiez depuis la ligne de commande :

claude mcp get WolframLanguage

Cline

InstallMCPServer["Cline", "WolframLanguage"]

Copilot CLI

InstallMCPServer["CopilotCLI", "WolframLanguage"]

Vérifiez : copilot -i "/mcp show".

Cursor

InstallMCPServer["Cursor", "WolframLanguage"]

Vérifiez : Paramètres → Outils et MCP → confirmez que « WolframLanguage » figure dans la liste.

Gemini CLI

InstallMCPServer["GeminiCLI", "WolframLanguage"]

Vérifiez : gemini -i "/mcp".

Google Antigravity

InstallMCPServer["Antigravity", "WolframLanguage"]

Vérifiez : vue de l'Éditeur → ... menu → panneau Agent → Serveurs MCP → Gérer les serveurs MCP.

OpenAI Codex

InstallMCPServer["Codex", "WolframLanguage"]

Vérifiez : codex mcp get WolframLanguage.

OpenCode

Global

InstallMCPServer["OpenCode", "WolframLanguage"]

Au niveau du projet

InstallMCPServer[{"OpenCode", "/path/to/project"}, "WolframLanguage"]

Vérifiez : opencode mcp list.

Visual Studio Code

Global

InstallMCPServer["VisualStudioCode", "WolframLanguage"]

Au niveau du projet

InstallMCPServer[{"VisualStudioCode", "/path/to/project"}, "WolframLanguage"]

Windsurf

InstallMCPServer["Windsurf", "WolframLanguage"]

Zed

InstallMCPServer["Zed", "WolframLanguage"]

Autres clients

Générez la configuration JSON brute et adaptez-la manuellement :

MCPServerObject["WolframLanguage"]["JSONConfiguration"]

Vérification de l'installation

Après l'installation, redémarrez votre outil de développement et interrogez l'IA :

« À quels outils de Wolfram Language as-tu accès ? »

L'IA devrait lister des outils tels que WolframLanguageEvaluator, WolframLanguageContext, TestReport, etc.

Configuration des conseils IA dans le fichier AGENTS.md

Les outils de codage basés sur l'IA débutent chaque session sans garder en mémoire les conversations précédentes. Un fichier AGENTS.md à la racine de votre projet fournit à l'IA le contexte essentiel concernant votre base de code, vos conventions et la manière d'utiliser efficacement les outils de Wolfram Language.

Remarque concernant Claude Code : Claude Code utilise CLAUDE.md plutôt qu'AGENTS.md. Pour les projets utilisant plusieurs outils de codage basés sur l'IA, vous pouvez soit inclure @AGENTS.md dans votre fichier CLAUDE.md pour en intégrer automatiquement le contenu, soit créer un lien symbolique pour CLAUDE.md : ln -s AGENTS.md CLAUDE.md.

Pourquoi c'est important ?

Sans directives, l'IA ne saura pas quand utiliser WolframLanguageContext pour consulter la documentation, elle risque de ne pas respecter les conventions de codage de votre projet et fera l'impasse sur les tests ainsi que sur l'inspection du code.

Ce qu'il faut inclure :

  1. Le guidage de l'outil pour savoir quand et comment utiliser chaque outil de Wolfram Language.
  2. L'agencement du projet pour la structure des répertoires, les fichiers clés, les points d'entrée.
  3. Le style de code pour les conventions de nommage, modèles de conception, approche de gestion des erreurs.
  4. L'exécution de tests pour exécuter les tests, trouver l'emplacement des fichiers de test, le format des tests.

Modèle d'AGENTS.md

# AGENTS.md

## Aperçu

Brève description de ce que fait votre projet.

## Développement

Utilise toujours l'outil WolframLanguageContext lorsque tu travailles avec du code Wolfram Language pour consulter la documentation et trouver les fonctions pertinentes avant d'écrire du code.

Lorsque tu apportes des modifications au code source, écris et exécute des tests à l'aide de l'outil TestReport et vérifie ton travail avec l'outil CodeInspector.

## Structure du projet

 - `Kernel` : fichiers sources principaux
   - `MyPaclet.wl` : point d'entrée
   - `Utilities.wl` : fonctions d'aide
 - `Tests` : fichiers de test (.wlt)
 - `Documentation` : notebooks et documents

## Style du code

- Utilise `UpperCamelCase` pour les noms de fonctions publiques
- Utilise `lowerCamelCase` pour les noms de fonctions internes
- Utilise `Enclose/Confirm` pour la gestion des erreurs :

{```wl
myFunction[arg_] := Enclose[
  Module[{result},
    result = ConfirmBy[computation[arg], StringQ];
    result
  ]
];
```}
## Tests d'écriture

Écris les tests selon ce format :

{```wl
VerificationTest[
  input,
  expected,
  TestID -> "DescriptiveTestID"
]
```}
Les fichiers de test sont placés dans le répertoire `Tests/` avec l'extension `.wlt`.

## Modèles clés

Décris les modèles, conventions ou décisions architecturales spécifiques au projet que l'IA doit respecter.

Mettez à jour AGENTS.md chaque fois que vous ajoutez de nouveaux fichiers ou répertoires, établissez de nouveaux modèles de codage, découvrez des cas limites dont l'IA devrait avoir connaissance ou modifiez les stratégies de test.

Meilleures pratiques

Développement piloté par les tests

Les outils de codage basés sur l'IA fonctionnent bien avec un flux de travail piloté par les tests :

  1. Écrivez d'abord des tests décrivant le comportement attendu.
  2. Demandez à l'IA d'implémenter la fonction pour réussir les tests.
  3. Exécutez des tests avec TestReport pour vérifier.
  4. Itérez jusqu'à ce que tous les tests réussissent.

Utilisation du mode planification

Pour les tâches complexes, demandez à l'IA d'élaborer un plan avant de passer à la mise en œuvre. De nombreuses applications intègrent un « mode planification » ; utilisez-le pour examiner l'approche proposée avant d'écrire le code.

Gestion du contexte lors de tâches de longue durée

Les outils de codage basés sur l'IA disposent de fenêtres de contexte limitées. Pour des fonctionnalités complexes s'étendant sur plusieurs sessions, une gestion manuelle du contexte donne souvent de meilleurs résultats que le recours à une compression automatisée.

Utilisez des séances structurées dans les cas suivants :

  • Fonctionnalités nécessitant plus d'une session de mise en œuvre.
  • Travail s'étalant sur plusieurs heures ou plusieurs jours.
  • Tâches pour lesquelles le maintien de la précision est critique.

Le flux de travail permet de tenir à jour trois documents de travail :

Document Objectif
Specs/FeatureName.md Spécification détaillée et conception de l'API
TODO/FeatureName.md Liste de contrôle des tâches : une tâche par session
Progress/FeatureName.md Journal de session consignant les décisions et les conclusions

Exemple de document de spécifications

# Fonctionnalité : importation de CSV avec validation de schéma

## Exigences
- Analyse des fichiers CSV pour les convertir en listes d'associations.
- Prise en charge des spécifications de type de colonne personnalisées.
- Validation des données par rapport au schéma fourni.
- Renvoi des objets d'échec pour les données invalides.

## Conception d'API
CSVImportValidated[file, schema]  
(* returns {<|...|>, ...} or Failure *)

## Format de schéma
<|"Name" →  "String", "Age" →  "Integer", "Score" → "Real"|>

## Cas limites
- Renvoi de fichiers vides {}
- Les colonnes manquantes entraînent un échec["MissingColumn", ...]
- Les incompatibilités de type renvoient un échec["TypeError", ...]

Invite par session (prompt.md)

## Contexte

@TODO/CSVImportValidated.md
@Specs/CSVImportValidated.md
@Progress/CSVImportValidated.md

## Consignes

1. Choisis la prochaine tâche inachevée dans la liste des tâches.
2. Étudie les spécifications de cette tâche.
3. Réalise la tâche.
4. Ajoute un rapport d'avancement au fichier Progress/CSVImportValidated.md.
5. Marque la tâche comme terminée dans le fichier TODO/CSVImportValidated.md.
6. Valide tes modifications (commit).
7. Arrête-toi et attends une intervention de l'utilisateur.

IMPORTANT : Effectuez UNE seule tâche par session.

Exécutez chaque session avec :

claude "$(cat prompt.md)"

Lancez une nouvelle session après chaque tâche plutôt que de poursuivre la même conversation. Examinez et modifiez manuellement le fichier de suivi pour vous assurer qu'il reflète le contexte approprié.

Considérations relatives à la sécurité

Les outils WolframLanguageEvaluator et TestReport exécutent du code Wolfram Language arbitraire. Cela signifie qu'ils peuvent lire, écrire et supprimer des fichiers, effectuer des requêtes en réseau, exécuter des commandes système et accéder aux variables d'environnement.

Configurez votre application pour exiger une approbation avant que l'IA n'exécute ces outils. La plupart des applications de codage basées sur l'IA prennent en charge des autorisations nécessitant une approbation à cette fin.

CodeInspector et ReadNotebook lisent le contenu des fichiers qui est envoyé à votre fournisseur de LLM. Si votre projet contient des informations sensibles, envisagez d'exiger une approbation pour ces outils également.

Injection d'invites

Si votre application de codage basée sur l'IA récupère du contenu sur le Web ou auprès d'autres sources non fiables, sachez que du contenu malveillant pourrait amener l'IA à utiliser d'autres outils de manière imprévue. En règle générale, si vous autorisez automatiquement les outils qui lisent du contenu externe non fiable, exigez une approbation pour tous les outils susceptibles d'exposer des informations sensibles.

Dépannage

Le serveur ne se connecte pas

  • Redémarrez complètement votre client de Chat ou votre application de codage après l'installation. Fermer la fenêtre se limite souvent à la réduire dans la zone de notification.
  • Consultez la documentation de votre client pour connaître l'emplacement des fichiers journaux et examinez-les à la recherche d'erreurs.

WolframContext ne fonctionne pas comme prévu

Pour obtenir les meilleurs résultats, assurez-vous d'être passé à la version 15 de Wolfram. Auparavant, WolframContext nécessitait un abonnement distinct pour bénéficier de toutes ses fonctionnalités. Sans cet abonnement, les résultats de Wolfram|Alpha ne sont pas inclus et la précision de la recherche dans la documentation est réduite. La version 15 intègre tout le nécessaire.

Délais d'attente de calcul

Par défaut, les évaluations sont limitées à 60 secondes. Demandez à l'IA d'augmenter ce délai ou de décomposer le calcul en étapes plus petites.

Le serveur utilise une version incorrecte de Wolfram Language.

Le serveur MCP installé utilise la même version de Wolfram Language que la session à partir de laquelle il a été installé. Pour utiliser une version différente, installez le serveur MCP depuis une session exécutant cette version ou modifiez manuellement le fichier de configuration pour le faire pointer vers un autre noyau Wolfram.

Source : Wolfram AgentTools Paclet Repository — © 2026 Wolfram Research