Tutoriel : Premiers pas avec MCP dans mini-me

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# Tutoriel : Premiers pas avec MCP dans mini-me

À la fin de ce tutoriel, vous aurez lancé mini-me avec des serveurs MCP configurés, et fait appeler au modèle un outil de l'un d'eux.

Aucune connaissance préalable de MCP n'est requise.

## Prérequis

- Le binaire `mm` compilé, et Docker Model Runner démarré avec le modèle téléchargé : voir [votre première session avec mini-me](getting-started.md).
- Un terminal ouvert à la racine du dépôt.
- Une connexion internet : les serveurs de ce tutoriel sont distants.

## Étape 1 — Regarder la configuration fournie

Affichez la section `mcp:` du fichier de configuration fourni :

```bash
grep -A3 "^mcp:" demos/dmr/agent.dmr.mcp.yaml
```

Vous devriez voir :

```yaml
mcp:
  enabled: true
  permissions: ask             # Ask before executing MCP tools (recommended for security)
  discoveryTimeout: 10s        # Timeout for discovering tools at startup
```

Plus bas, la même section déclare trois serveurs : `context7`, `wikipedia` et `github`.

## Étape 2 — Exporter vos clés API (facultatif)

Wikipedia ne nécessite pas de clé API : vous pouvez sauter cette étape et faire quand même les étapes 3 et 4. Pour utiliser aussi les deux autres serveurs, exportez leurs clés dans ce terminal :

```bash
export CONTEXT7_API_KEY="votre-clé-context7"
export GITHUB_PERSONAL_ACCESS_TOKEN="votre-token-github"
```

## Étape 3 — Lancer mini-me avec MCP activé

Exécutez mini-me avec le fichier de configuration fourni :

```bash
./mm -config demos/dmr/agent.dmr.mcp.yaml
```

Vous devriez voir dans la bannière de démarrage :

```
tools: bash, read_skill, read_file, write_file, edit_file, plan, ask_user, unload_model, wikipedia_search_wikipedia, wikipedia_get_article, wikipedia_get_summary, ...
```

> ✅ **Résultat attendu** : vous voyez les outils MCP (`wikipedia_*`) dans la liste. Chacun porte le nom de son serveur.

Un serveur sans sa clé est ignoré, avec un avertissement au-dessus de la bannière, et les autres fonctionnent quand même :

```
[warning: mcp server context7: discovery failed: initialize: missing token for env var CONTEXT7_API_KEY]
```

Si vous avez exporté les clés, les outils `context7_*` et `github_*` sont aussi dans la liste.

## Étape 4 — Tester avec Wikipedia (sans authentification)

À l'invite `>`, tapez :

```
Explique-moi ce qu'est le Model Context Protocol
```

Comme le fichier indique `permissions: ask`, mini-me demande confirmation avant chaque appel d'un outil MCP :

```
🔐 wikipedia: search_wikipedia
   [a] allow once · [s] allow wikipedia_search_wikipedia for this session · [r] reject · [n] never wikipedia_search_wikipedia
   ?
```

Tapez `a` puis Entrée, à chaque demande. En général, le modèle cherche d'abord, puis lit un article.

> ✅ **Résultat attendu** : le modèle répond à partir de ce qu'ont renvoyé `wikipedia_search_wikipedia` et `wikipedia_get_article`.

## Étape 5 — Tester avec Context7 (avec authentification)

Si vous avez exporté `CONTEXT7_API_KEY`, demandez au modèle :

```
Comment utiliser useEffect dans React ?
```

> ✅ **Résultat attendu** : le modèle utilise `context7_resolve_library_id` puis `context7_query_docs` pour trouver la documentation.

## Étape 6 — Tester avec GitHub (avec authentification)

Si vous avez exporté `GITHUB_PERSONAL_ACCESS_TOKEN`, demandez au modèle :

```
Quels sont mes dépôts sur GitHub ?
```

> ✅ **Résultat attendu** : le modèle utilise les outils `github_*` pour accéder à vos dépôts.

## Étape 7 — Quitter

À l'invite `>`, tapez :

```
/quit
```

## Que faire maintenant ?

Vous avez configuré avec succès MCP dans mini-me. Pour aller plus loin :

- Pour accomplir des tâches spécifiques → consultez les [guides pratiques](../how-to/)
- Pour comprendre le fonctionnement → consultez les [explications](../explanation/)
- Pour la référence technique → consultez la [référence](../reference/)