Référence des outils MCP disponibles

  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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238

# Référence des outils MCP disponibles

Ce document liste les outils disponibles depuis divers serveurs MCP qui peuvent être connectés à mini-me.

## Aperçu

Chaque serveur MCP fournit son propre ensemble d'outils. Une fois connectés, ces outils sont préfixés avec le nom du serveur pour éviter les collisions. Par exemple, l'outil `list_repositories` du serveur GitHub devient `github_list_repositories`.

## Découverte des outils

Les outils sont découverts au démarrage de mini-me. Le processus de découverte :

1. Se connecte à chaque serveur MCP configuré
2. Demande la liste des outils disponibles via le protocole MCP
3. Filtre les outils qui utilisent des entrées/sorties binaires (mini-me ne prend en charge que le texte)
4. Filtre optionnellement selon la liste `tools` dans la configuration du serveur
5. Nettoie les noms des outils pour s'assurer qu'ils sont des identifiants valides

## Outils par serveur

### Serveur MCP Wikipedia

**Nom du serveur :** `wikipedia`

| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `search_wikipedia` | `wikipedia_search_wikipedia` | Rechercher des articles Wikipedia |
| `get_article` | `wikipedia_get_article` | Obtenir le contenu complet d'un article |
| `get_summary` | `wikipedia_get_summary` | Obtenir un résumé d'article |
| `get_sections` | `wikipedia_get_sections` | Obtenir les sections/plan d'un article |
| `get_links` | `wikipedia_get_links` | Obtenir les liens d'un article |
| `get_coordinates` | `wikipedia_get_coordinates` | Obtenir les coordonnées géographiques |
| `get_related_topics` | `wikipedia_get_related_topics` | Obtenir les sujets liés |
| `summarize_article_for_query` | `wikipedia_summarize_article_for_query` | Résumer les sections pertinentes |
| `summarize_article_section` | `wikipedia_summarize_article_section` | Résumer une section spécifique |
| `extract_key_facts` | `wikipedia_extract_key_facts` | Extraire les faits clés |
| `test_wikipedia_connectivity` | `wikipedia_test_wikipedia_connectivity` | Tester la connexion |
| `list_supported_countries` | `wikipedia_list_supported_countries` | Lister les langues prises en charge |
| `multi_search_wikipedia` | `wikipedia_multi_search_wikipedia` | Recherche multi-langues |

### Serveur MCP Context7

**Nom du serveur :** `context7`

| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `resolve-library-id` | `context7_resolve_library_id` | Résoudre un nom de bibliothèque en ID |
| `query-docs` | `context7_query_docs` | Interroger la documentation pour une bibliothèque |

**Conseils d'utilisation :**
- Appelez d'abord `resolve-library-id` pour obtenir un ID de bibliothèque
- Utilisez l'ID de bibliothèque avec `query-docs` pour rechercher dans la documentation

**Exemple de workflow :**
```
1. context7_resolve_library_id(query="React hooks", libraryName="react")
2. context7_query_docs(libraryId="/facebook/react", query="exemples useEffect")
```

### Serveur MCP GitHub

**Nom du serveur :** `github`

#### Outils de dépôt
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `get_me` | `github_get_me` | Obtenir le profil utilisateur authentifié |
| `list_repositories` | `github_list_repositories` | Lister les dépôts de l'utilisateur |
| `list_repository_collaborators` | `github_list_repository_collaborators` | Lister les collaborateurs d'un dépôt |
| `create_repository` | `github_create_repository` | Créer un nouveau dépôt |
| `fork_repository` | `github_fork_repository` | Forker un dépôt |

#### Outils de code
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `get_file_contents` | `github_get_file_contents` | Obtenir le contenu d'un fichier |
| `create_or_update_file` | `github_create_or_update_file` | Créer ou mettre à jour un fichier |
| `delete_file` | `github_delete_file` | Supprimer un fichier |
| `list_branches` | `github_list_branches` | Lister les branches d'un dépôt |
| `list_commits` | `github_list_commits` | Lister les commits |
| `get_commit` | `github_get_commit` | Obtenir les détails d'un commit |
| `create_branch` | `github_create_branch` | Créer une nouvelle branche |
| `update_pull_request_branch` | `github_update_pull_request_branch` | Mettre à jour la branche d'une PR |
| `push_files` | `github_push_files` | Pousser plusieurs fichiers |

#### Outils d'issues et de Pull Requests
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `list_issues` | `github_list_issues` | Lister les issues d'un dépôt |
| `issue_read` | `github_issue_read` | Lire les détails d'une issue |
| `issue_write` | `github_issue_write` | Créer/mettre à jour une issue |
| `list_pull_requests` | `github_list_pull_requests` | Lister les PRs |
| `pull_request_read` | `github_pull_request_read` | Lire les détails d'une PR |
| `pull_request_write` | `github_pull_request_write` | Écrire une revue de PR |
| `pull_request_review_write` | `github_pull_request_review_write` | Créer/soumettre une revue de PR |
| `create_pull_request` | `github_create_pull_request` | Créer une nouvelle PR |
| `merge_pull_request` | `github_merge_pull_request` | Fusionner une PR |
| `update_pull_request` | `github_update_pull_request` | Mettre à jour une PR |
| `create_or_update_issue` | `github_issue_write` | Créer ou mettre à jour une issue |
| `add_issue_comment` | `github_add_issue_comment` | Ajouter un commentaire à une issue |
| `update_issue_comment` | `github_update_issue_comment` | Mettre à jour un commentaire d'issue |
| `add_comment_to_pending_review` | `github_add_comment_to_pending_review` | Ajouter un commentaire de revue |
| `add_reply_to_pull_request_comment` | `github_add_reply_to_pull_request_comment` | Répondre à un commentaire de PR |
| `add_pull_request_comment` | `github_add_pull_request_comment` | Ajouter un commentaire de PR |
| `get_copilot_job_status` | `github_get_copilot_job_status` | Obtenir l'état d'un job Copilot |
| `request_copilot_review` | `github_request_copilot_review` | Demander une revue Copilot |

#### Outils de recherche
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `search_code` | `github_search_code` | Rechercher du code |
| `search_issues` | `github_search_issues` | Rechercher des issues |
| `search_pull_requests` | `github_search_pull_requests` | Rechercher des PRs |
| `search_repositories` | `github_search_repositories` | Rechercher des dépôts |
| `search_commits` | `github_search_commits` | Rechercher des commits |
| `search_users` | `github_search_users` | Rechercher des utilisateurs |

#### Outils de labels et de jalons
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `get_label` | `github_get_label` | Obtenir un label spécifique |
| `get_team_members` | `github_get_team_members` | Obtenir les membres d'une équipe |
| `get_teams` | `github_get_teams` | Obtenir les équipes de l'utilisateur |
| `list_issue_fields` | `github_list_issue_fields` | Lister les champs d'issue |
| `list_issue_types` | `github_list_issue_types` | Lister les types d'issue |
| `list_releases` | `github_list_releases` | Lister les versions |
| `list_tags` | `github_list_tags` | Lister les tags git |
| `get_release_by_tag` | `github_get_release_by_tag` | Obtenir une version par tag |
| `get_latest_release` | `github_get_latest_release` | Obtenir la dernière version |
| `get_tag` | `github_get_tag` | Obtenir les détails d'un tag |

#### Outils Copilot
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `create_pull_request_with_copilot` | `github_create_pull_request_with_copilot` | Créer une PR avec Copilot |
| `assign_copilot_to_issue` | `github_assign_copilot_to_issue` | Assigner Copilot à une issue |

#### Outils de sous-issues
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `sub_issue_write` | `github_sub_issue_write` | Ajouter/supprimer/reprioritiser des sous-issues |

#### Analyse de secrets
| Nom de l'outil | Nom préfixé | Description |
|----------------|-------------|-------------|
| `run_secret_scanning` | `github_run_secret_scanning` | Exécuter l'analyse de secrets |

## Préfixage des noms d'outils

Tous les outils MCP sont préfixés avec le nom de leur serveur pour éviter les collisions de noms. Le format est :

```
{nom_serveur}_{nom_original_outil}
```

Par exemple :
- Serveur : `wikipedia`, Outil : `search_wikipedia` → Préfixé : `wikipedia_search_wikipedia`
- Serveur : `github`, Outil : `list_repositories` → Préfixé : `github_list_repositories`
- Serveur : `context7`, Outil : `resolve-library-id` → Préfixé : `context7_resolve_library_id` (remarque : les tirets deviennent des underscores)

## Nettoyage des noms d'outils

Les noms d'outils sont nettoyés pour être des identifiants Go valides :

1. Les caractères non alphanumériques sont remplacés par des underscores (`_`)
2. Les underscores de début/fin sont supprimés
3. Les underscores consécutifs multiples sont réduits à un seul
4. Si le résultat est vide, il devient `"tool"`

Exemples :
- `resolve-library-id` → `resolve_library_id`
- `query-docs` → `query_docs`
- `add-comment_to-pending-review` → `add_comment_to_pending_review`

## Paramètres requis

Chaque outil a son propre schéma d'entrée définissant les paramètres requis et optionnels. Les paramètres requis doivent être fournis lors de l'appel de l'outil.

Pour voir les paramètres requis pour un outil spécifique, utilisez :
```
Utilisez l'outil {nom_outil}
```

Mini-me vous affichera la description de l'outil incluant les paramètres requis.

### Ce que reçoit le modèle

Chaque outil MCP est déclaré au modèle avec le schéma d'entrée du serveur : le modèle connaît le nom, le type et la description de chaque paramètre.

| Partie du schéma du serveur | Déclarée au modèle |
|---|---|
| `properties` (noms, `type`, `description`, `items`, objets imbriqués) | Telle quelle, à tous les niveaux. |
| `enum` | Déplacé dans la description de la propriété : `How recent. One of: day, week, month.` |
| `required` | Écarté ; listé dans la description de l'outil (`Required parameters: query, language`) et vérifié par mini-me avant l'appel. |
| `additionalProperties: false`, `$schema` | Écartés. |

Ces contraintes sont écartées parce que l'appel du modèle est validé contre le schéma déclaré avant que l'outil ne s'exécute, et qu'un appel rejeté termine le tour. Vérifié par mini-me à la place, un paramètre manquant revient au modèle sous la forme `[mcp error: missing required parameters: …]`, qu'il peut lire et corriger.

Sans schéma déclaré, un modèle dont le serveur analyse les appels d'outils d'après les paramètres déclarés — le format XML des appels d'outils de Qwen sur llama.cpp (`dmr`, `llamacpp`, `llmman`) — envoie chaque appel vide.

## Filtrage des outils

Vous pouvez filtrer les outils d'un serveur qui sont exposés en spécifiant une liste `tools` dans la configuration du serveur :

```yaml
servers:
  - name: github
    transport: http
    url: https://api.githubcopilot.com/mcp/
    auth:
      type: bearer
      tokenEnv: GITHUB_PERSONAL_ACCESS_TOKEN
    tools:  # Seuls ces outils seront disponibles
      - get_me
      - list_repositories
      - search_code
```

## Filtrage des outils binaires

Mini-me **ne prend en charge que les entrées/sorties texte** pour les outils MCP. Tout outil qui nécessite des données binaires (images, audio, etc.) est automatiquement filtré et un avertissement est affiché au démarrage.

Cci est une mesure de sécurité pour garantir la compatibilité avec l'architecture texte uniquement de mini-me.

## Exécution des outils

Lorsque vous utilisez un outil MCP :

1. **Vérification des permissions :** Si les permissions sont définies sur `ask`, il vous sera demandé de confirmer
2. **Validation des entrées :** Les paramètres requis sont validés
3. **Délai d'attente :** Le délai d'attente configuré du serveur s'applique
4. **Sortie :** Les résultats sont retournés sous forme de texte (le contenu non texte est ignoré)
5. **Troncature :** La sortie peut être tronquée si elle dépasse `maxOutput` caractères

## Voir aussi

- [Configuration MCP](configuration.md)
- [Architecture MCP](explanation/architecture.md)