Skip to main content
Glama

mister-parc-mcp

Serveur MCP en lecture seule sur l'état du parc mister-guiiug : le tableau de bord et le socle dev-pwa-config. Écrit avec FastMCP 4, hébergé sur Prefect Horizon.

Il répond, depuis n'importe quel client MCP, à « qu'est-ce qui est à faire sur le parc ? » sans qu'on recopie le tableau de bord, et à « le socle a-t-il déjà ceci ? » avant qu'un agent ne le réécrive dans une application.

Les outils

Outil

Ce qu'il rend

parc_etat

chiffres clés du dernier relevé, version du socle, rubriques « À faire », ce qui a bougé

parc_a_faire

la liste « À faire » avec son détail, filtrable par niveau ou par rubrique

parc_depots

une ligne par dépôt : CI, alertes, CodeQL, PR, site, version du socle, ruleset

parc_depot

tout ce que le relevé sait d'un dépôt

parc_echecs

les workflows rouges sur la branche par défaut, avec job et étape

parc_prs

les PR ouvertes sur tout le compte, avec l'état de leur CI

parc_alertes

les alertes Dependabot (CVE, GHSA, part en production) et CodeQL (règles), par dépôt

parc_sites

les sites en ligne : code HTTP, temps de réponse, production face à main, URL mortes

parc_renovate

ce que Renovate attend dans chaque dépôt, et ce qu'il ne sait pas résoudre

parc_librairie

une librairie : ses versions, et quel dépôt est sur laquelle

parc_librairies_en_retard

les librairies en retard sur l'amont, les plus en retard d'abord

parc_chercher

un nom exact de dépôt ou de librairie, à partir d'un bout de nom ou de description

parc_tendances

l'historique quotidien : taux de vert, rouges, alertes

parc_journal

les dernières transitions vues par le relevé

socle_offre

modules par catégorie, outils, workflows réutilisables et dépendances pairs du socle

socle_module

un module : ce qu'il emporte, ce qui l'emporte, qui l'importe

socle_workflow

un workflow réutilisable : la ligne uses:, ses défauts, qui l'appelle et avec quoi

socle_usage

ce qu'un dépôt prend au socle : version, modules, outils, workflows et leurs entrées

socle_doc

README, CONFIG, CONTRIBUTING ou STRATEGIE du socle, à la version publiée

socle_chercher

un terme dans les noms du socle et les sections de sa documentation

Chaque outil se déclare en lecture seule (readOnlyHint), porte un titre lisible et annonce la forme de sa réponse (outputSchema, tiré de mister_parc/sorties.py). Les tests exigent les trois, et valident chaque réponse réelle contre le schéma qu'elle annonce.

Related MCP server: odoo-sh-readonly-mcp

Protocole

Le serveur parle MCP 2026-07-28, par la bibliothèque mcp 2.3 et FastMCP 4 : sans état, server/discover, resultType sur chaque résultat. Ce qui revient au serveur lui-même :

  • son identité : serverInfo porte son nom et sa version, celle de pyproject.toml ;

  • la fraîcheur de ses listes (SEP-2549) : ttlMs d'une heure et cacheScope private. Derrière Horizon, la liste arrive pourtant avec ttlMs 0 : c'est la passerelle qui la réécrit (constaté le 29/10 : 3 600 000 en HTTP local, 0 par fastmcp.app) ;

  • une liste d'outils dans un ordre fixe, que les clients peuvent garder en cache ;

  • des schémas JSON Schema 2020-12 en entrée comme en sortie.

FastMCP annonce encore la capacité logging, dépréciée par cette version (SEP-2577) : le serveur ne journalise rien par MCP, ses journaux vont sur la sortie d'erreur, que Horizon recueille.

D'où viennent les réponses

Le serveur lit ce que le parc publie déjà, et ne recalcule rien :

  • donnees.json et a-faire.json, que le tableau de bord publie à chaque relevé, au mieux toutes les heures (parc-dashboard#57). La liste « À faire » sort de la fonction même de la page (aFairePublie) : la règle n'existe qu'en un endroit. Chaque réponse porte genere, la date du relevé.

  • la documentation du socle sous l'étiquette de sa version publiée (v6.28.1…), lue sur raw.githubusercontent.com.

Tout est public : le serveur n'a aucun jeton et aucune variable d'environnement.

Se connecter

Le serveur est en ligne à https://mister-parc-mcp.fastmcp.app/mcp, derrière l'authentification de Horizon : seuls les membres de l'organisation Horizon mister-guiiug s'y connectent, par une connexion OAuth que le client ouvre lui-même. Sans authentification, le gateway répond 401.

claude mcp add --transport http mister-parc https://mister-parc-mcp.fastmcp.app/mcp

Un client sans connexion interactive (un script, une CI) passe une clé d'API Horizon (fmcp_…) comme jeton porteur.

En local, sans Horizon, sur stdio :

claude mcp add mister-parc-local -- uv run --directory <chemin du dépôt> fastmcp run serveur.py:mcp

Déployer sur Horizon

Le projet Horizon mister-parc-mcp (organisation mister-guiiug) a été créé le 29/10/2026 par l'API de Horizon. Sa source est la branche main de ce dépôt, lue par l'application GitHub de Horizon, qui n'a accès qu'à ce dépôt. Ses réglages :

Réglage

Valeur

Point d'entrée

serveur.py:mcp

Dépendances

pyproject.toml

Python

3.14, lue dans .python-version : la plus récente que Horizon accepte (3.11 à 3.14)

Authentification

activée (le défaut)

Variables

aucune

Chaque push sur main redéploie la production : la cible production suit main. Chaque PR a son déploiement d'aperçu, derrière la même authentification. Un retour en arrière se fait depuis le tableau de bord de Horizon, ou par l'API (rollback d'un déploiement précédent), pendant trente jours.

Les limites de Horizon qui comptent ici : 170 secondes par requête, 6 Mo par réponse, 1 Go de mémoire, disque effacé entre deux requêtes, pas de tâche de fond. donnees.json pèse environ 470 Ko ; chaque instance le garde cinq minutes en mémoire. Rendre le serveur public (sans authentification) demande le plan Developer de Horizon.

Développer

uv sync
uv run pytest
uv run ruff check
uv run ruff format --check
uv run fastmcp inspect serveur.py:mcp

Les tests ne touchent pas le réseau : tests/conftest.py sert un relevé réel réduit à quatre dépôts. tests/engendrer-donnees.mjs le régénère, avec le code du tableau de bord.

Ce qu'il ne fait pas, exprès

  • Écrire. Ni fusion, ni campagne, ni commentaire : dans ce parc, une fusion attend la décision du propriétaire.

  • Recalculer. Un chiffre qui manque s'ajoute à la publication du tableau de bord, pas ici.

  • Les dépôts privés. Le relevé publié ne les contient pas.

Licence

MIT

Available Tools

20 tools
parc_a_faireÀ faire, en détailA
Read-onlyIdempotent

La liste « À faire » du tableau de bord, avec le détail de chaque rubrique : dépôts concernés, PR à relire, montées de librairies (paquet, cible, dépôts et versions).

C'est la liste que la page affiche, calculée par le relevé ; rien n'est recalculé ici. Niveaux, du plus urgent au moins urgent : critique, attention, decision, entretien.

Inputs: niveau, rubrique. Returns: page, items, genere

parc_alertesAlertes de sécuritéA
Read-onlyIdempotent

Les alertes ouvertes, dépôt par dépôt : vulnérabilités Dependabot (avec leurs identifiants CVE ou GHSA, et combien touchent la production) et alertes CodeQL (avec la règle en cause). Sans depot, seuls les dépôts qui ont au moins une alerte.

Inputs: depot. Returns: depots, genere, lisibles

parc_chercherChercher dans le parcA
Read-onlyIdempotent

Les dépôts dont le nom ou la description contient le terme, et les librairies dont le nom le contient, sans égard à la casse. Pour retrouver un nom exact avant d'appeler depot ou librairie.

Inputs: terme (required). Returns: terme, depots, genere, librairies

parc_depotFiche d'un dépôtA
Read-onlyIdempotent

Tout ce que le relevé sait d'un dépôt : dernier commit, workflows et leur dernier état, PR ouvertes, alertes, CodeQL, ruleset, site et production, pile technique, usage du socle.

Inputs: nom (required). Returns: depot, genere

parc_depotsLes dépôtsB
Read-onlyIdempotent

Les dépôts publics du compte, une ligne chacun : famille, CI (verts, rouges, en cours), alertes de vulnérabilité, alertes CodeQL, PR ouvertes, site en ligne, version du socle, état du ruleset, date du dernier commit.

Inputs: famille. Returns: depots, genere

parc_echecsÉchecs de CIA
Read-onlyIdempotent

Les workflows rouges sur la branche par défaut : dépôt, workflow, job et étape en échec, lien du run. Une liste vide veut dire que tout est vert.

Inputs: no named parameters. Returns: echecs, genere

parc_etatÉtat du parcA
Read-onlyIdempotent

L'état du parc en une réponse : chiffres clés du dernier relevé, version du socle, rubriques « À faire » (sans leur détail) et ce qui a bougé depuis la photo du jour.

À appeler en premier. genere date le relevé : il passe au mieux toutes les heures. Le détail d'une rubrique s'obtient par a_faire.

Inputs: no named parameters. Returns: page, socle, genere, a_faire, +2 more

parc_journalJournal des transitionsA
Read-onlyIdempotent

Les dernières transitions vues par le relevé, la plus récente d'abord : CI passée au rouge ou au vert, nouvelle version en amont, alertes qui montent ou descendent.

Inputs: n. Returns: journal

parc_librairieLibrairieC
Read-onlyIdempotent

Une librairie du parc : ses versions, quels dépôts sont sur laquelle, la dernière version publiée en amont et le retard.

Inputs: paquet (required). Returns: genere, librairie

parc_librairies_en_retardLibrairies en retardA
Read-onlyIdempotent

Les librairies dont au moins un dépôt est en retard sur l'amont, les plus en retard d'abord. Pour le détail par dépôt, appeler librairie.

Inputs: ecosysteme. Returns: genere, librairies

parc_prsPull requests ouvertesA
Read-onlyIdempotent

Les pull requests ouvertes sur tout le compte, les plus anciennes d'abord : dépôt, numéro, titre, branche, auteur, brouillon ou non, et l'état de leur CI.

Dans ce parc, une PR ne se fusionne que sur la décision du propriétaire : cet outil les liste, il ne fusionne rien.

Inputs: robots. Returns: prs, genere

parc_renovateRenovate en attenteA
Read-onlyIdempotent

Ce que Renovate attend dans chaque dépôt, lu dans son « Dependency Dashboard » : les mises à jour en attente (majeures signalées) et les paquets qu'il ne sait pas résoudre. Avant de monter une librairie à la main, vérifier ici qu'une PR Renovate ne la couvre pas.

Inputs: no named parameters. Returns: depots, genere

parc_sitesSites en ligneA
Read-onlyIdempotent

Les sites GitHub Pages du parc : répondent-ils (code HTTP, temps de réponse, titre), la production est-elle à jour face à main, et sert-elle des morceaux fugaces ou des URL mortes.

Inputs: en_panne. Returns: sites, genere

parc_tendancesTendancesA
Read-onlyIdempotent

L'historique quotidien du parc, du plus ancien au plus récent : taux de vert, rouges, alertes, socle en retard. Un jour sans changement n'a pas de point.

Inputs: jours. Returns: historique

socle_chercherChercher dans le socleA
Read-onlyIdempotent

Le socle a-t-il déjà ceci ? Cherche le terme, sans égard à la casse, dans les noms des modules, outils et workflows, puis dans les sections de README.md, CONFIG.md et CONTRIBUTING.md. À appeler AVANT d'écrire dans une app ce qui pourrait y être.

Inputs: terme (required). Returns: terme, outils, modules, version, +3 more

socle_docDocument du socleA
Read-onlyIdempotent

Un document du socle, en entier, à la version publiée : README.md (l'API et la stack cible), CONFIG.md (secrets et variables), CONTRIBUTING.md (ce qui entre au socle), STRATEGIE.md (le découpage en trois couches). README.md dépasse 100 Ko : pour une question précise, chercher coûte moins.

Inputs: fichier (required). Returns: url, texte, fichier, version

socle_moduleModule du socleC
Read-onlyIdempotent

Un module du socle : sa catégorie, les modules qu'il emporte avec lui, ceux qui l'emportent, et les dépôts qui l'importent directement.

Inputs: nom (required). Returns: nom, emporte, version, categorie, +2 more

socle_offreCe que le socle offreB
Read-onlyIdempotent

Ce que la dernière version publiée du socle offre : ses modules rangés par catégorie (composants, crochets React, configs Vite, outillage…), ses outils en ligne de commande, ses workflows réutilisables, et les dépendances pairs qu'il attend des applications.

Inputs: no named parameters. Returns: pairs, outils, modules, version, +1 more

socle_usageCe qu'un dépôt prend au socleB
Read-onlyIdempotent

Ce qu'un dépôt prend au socle, mesuré dans son code par le relevé : la version qu'il verrouille, les modules qu'il importe, les outils de ses scripts et ceux que la CI partagée lance pour lui, les workflows réutilisables qu'il appelle et avec quelles entrées.

Inputs: depot (required). Returns: depot, socle, appels, genere, +5 more

socle_workflowWorkflow réutilisable du socleB
Read-onlyIdempotent

Un workflow réutilisable du socle : la ligne uses: à écrire (étiquette majeure roulante), ses entrées par défaut quand le relevé les connaît, les outils qu'il lance, et les dépôts qui l'appellent, avec les entrées qu'ils lui passent.

Inputs: nom (required). Returns: nom, uses, outils, defauts, +2 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 20 tools

    Disambiguation5/5

    The tools divide cleanly into `parc_*` observability queries and `socle_*` shared-foundation queries, with list/detail distinctions made explicit (`depots` vs `depot`, `etat` vs `a_faire`, `offre` vs `module`/`workflow`/`usage`). The two search tools, `parc_chercher` and `socle_chercher`, target different domains and their descriptions clarify the boundary.

    Naming Consistency4/5

    Names consistently use a domain prefix (`parc_` or `socle_`) plus a French noun or verb phrase, and singular/plural forms are used meaningfully. The set is not a strict verb_noun convention and mixes nouns with verbs like `chercher`, but it remains predictable and readable.

    Tool Count4/5

    Twenty tools is on the heavy side, but the server covers several distinct subdomains: repository health, alerts, sites, trends, libraries, Renovate, and the shared socle. Each tool appears to earn its place rather than duplicating another, though the surface is broad enough to be slightly unwieldy.

    Completeness4/5

    The read-only monitoring and socle-inspection surface is largely complete: repository summaries and details, CI failures, PRs, alerts, sites, Renovate, libraries, trends, journal, and socle modules/workflows/docs are all covered. Minor gaps may remain for deep per-PR or per-workflow-run inspection, but agents can work around them.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Read-only MCP server for MOJAQ: give any AI assistant natural-language access to your EU-hosted app's deploys, errors, logs, uptime and incidents.
      MIT
    • F
      license
      A
      quality
      B
      maintenance
      Provides coding agents read-only access to Depot's CI failure diagnoses, container build forensics, run history, cache effectiveness, registry contents, and usage data through MCP tools.
      28
      66 npm
      1
      -
    • A
      license
      B
      quality
      C
      maintenance
      Enables users to inspect ephemeral GitHub Actions runner fleet status, SLOs, incidents, capacity recommendations, and cost evidence through read-only MCP tools, without allowing infrastructure or cluster mutations.
      5
      MIT