Serveur MCP modulaire pour Iris - 28 outils (ping, ollama, fs, git, cloud APIs, web, RAG v1/v2/hybride, journal de recherches opt-in, zone contentieux) avec auto-decouverte.
Server has 15 tools with explicit schemas and descriptions. Naming follows verb_noun pattern (dictionary-v1, fetch-url-v1, git-commit-v1). Descriptions are present (avg ~120 chars) but lack actionable context for LLM selection, many omit WHEN to use the tool or prerequisites. Input schemas use Zod with type definitions, but parameter descriptions are minimal (avg ~40 chars, baseline 72). Output schemas are undocumented, LLMs cannot predict response structure. Error handling is basic (errorResult() calls) without recovery guidance. Security is reasonable (SSRF guards in fetch-url-v1, path traversal checks in fs-read-v1) but no audit logging or permission gates. Tool composition is sound (single responsibility), but some tools lack pagination (news-v1 hardcaps at 10, no offset/limit pattern).
Retourne la definition d un mot en anglais (dictionaryapi.dev, sans cle API).
Retourne les taux de change pour une devise de base (open.er-api.com, sans cle API).
Recupere le contenu texte d une page web ou d une API publique en https (GET). Garde anti-SSRF : http, hotes locaux et IP privees refuses, redirections limitees a 3, texte plafonne (200 000 caracteres) avec indicateur de troncature. Le HTML est converti en texte.
Liste le contenu d'un repertoire dans les repertoires autorises (ALLOWED_ROOTS). Supporte un pattern glob simple optionnel.
Lit le contenu d'un fichier dans les repertoires autorises (ALLOWED_ROOTS). Securise contre le path traversal et les symlinks sortants.
Convertit un nom de ville en coordonnees GPS (latitude, longitude, fuseau horaire). Open-Meteo Geocoding, gratuit, sans cle API.
Output schemas undocumented. LLMs cannot predict response structure (fields, types, nesting). Baseline: 100% of A+ tools document return types.
Parameter descriptions are minimal (avg ~40 chars vs baseline 72). Many lack format/range guidance. E.g., 'Chemin absolu du repertoire' does not explain allowed roots, symlink behavior, or glob syntax limits.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
Cree un commit Git dans un repo local avec le message fourni. Commit uniquement les fichiers deja stages (pas de git add implicite).
Retourne la diff Git d un repo local. Mode staged, unstaged ou head (tout vs HEAD).
Retourne les N derniers commits d un repo Git local (hash court, auteur, date, message).
Retourne le statut Git d un repo local (staged, unstaged, untracked, branche courante).
Retourne les jours feries pour un pays et une annee (date.nager.at, sans cle API).
Retourne la geolocalisation d'une adresse IP (ip-api.com, sans cle API).
Healthcheck du serveur MCP Iris. Retourne version, uptime, nombre et liste des outils, timestamp.
Retourne l image astronomique du jour NASA (APOD). Cle DEMO_KEY integree, 30 requetes/heure.
Retourne les N articles en tete de Hacker News. Algolia HN API, gratuit, sans cle API.
Tool descriptions lack actionable context. Missing: WHEN to use (vs similar tools), prerequisites, side effects. E.g., git-commit-v1 does not state 'only commits staged files' until deep in description.
No error recovery guidance. errorResult() returns bare messages without actionable next steps. E.g., 'Mot introuvable' does not suggest search_* alternatives or clarify input format.
No pagination or result limits documented. news-v1 hardcaps at 10 items; fs-list-v1 may return unbounded directory listings. Baseline: tools returning lists should accept limit/offset and document caps.