mcp-frontdesk
Un petit serveur d'autorisation OAuth 2.1 et une vérification des jetons d'accès pour les serveurs MCP. Il connecte les personnes à votre serveur MCP comme le demande la spécification d'autorisation de MCP : les clients s'identifient par un Client ID Metadata Document, chaque code exige PKCE S256, et les jetons d'actualisation sont renouvelés à chaque usage. Il sert quand vous voulez être votre propre serveur d'autorisation, avec vos comptes, votre page de consentement et votre base de données. Il est né de la couche de connexion de notre propre serveur MCP.
Démarrage rapide
- installation
npm install mcp-frontdeskAjoute la bibliothèque à votre projet, et rien d'autre. Exige Node.js 22.18 ou une version plus récente. - lancer l'exemple
git clone https://github.com/distronode-corporation/mcp-frontdesk.git cd mcp-frontdesk npm ci && npm run build cd examples/basic-server npm ci npm startCompile le dépôt cloné et sert un serveur MCP d'exemple sur votre propre ordinateur : une connexion de démonstration, une page de consentement et trois outils sur des notes fictives. - le tester
npm testDans le même dossier, une fois npm start arrêté ou depuis un second terminal. Le test de bout en bout : découverte, connexion avec PKCE, appels d'outils, une actualisation, puis un jeton d'actualisation rejoué qui révoque la connexion; un jeton d'accès déjà émis reste valide jusqu'à son expiration.
La ligne d'installation du README (en anglais) et les commandes de sa section Example server. Son Quick start montre le code qui place mcp-frontdesk devant votre propre serveur.
Ce qu'il apporte à votre serveur MCP
Sans cadre applicatif, sur votre stockage
Chaque point de terminaison reçoit une Request Web et renvoie une Response, et sa seule dépendance d'exécution est jose. Votre stockage se branche par deux petites interfaces : des magasins en mémoire sont fournis dans le paquet, et une suite de tests de contrat vérifie les vôtres. Aucun réglage par défaut propre à un produit : vous configurez chaque URL, portée, hôte client et URI de redirection.
Protégé là où n'importe qui peut l'atteindre
La récupération des métadonnées client passe par une protection contre les SSRF, active par défaut, et les corps de requête sont plafonnés à mesure qu'ils arrivent. Chaque code ou jeton d'actualisation refusé reçoit la même réponse, si bien que le point de terminaison des jetons ne révèle rien. Par défaut, un jeton d'actualisation déjà renouvelé et présenté de nouveau révoque toute sa famille. Les magasins ne voient jamais que des empreintes SHA-256, et les jetons d'accès ne portent aucune adresse courriel, à moins que vous en ajoutiez une.
À côté du SDK officiel
Le SDK TypeScript officiel de MCP sert le protocole et la vérification des jetons, et garde ses propres outils de serveur d'autorisation dans un paquet hérité. mcp-frontdesk est le serveur d'autorisation : la découverte, les vérifications d'autorisation, les codes et le point de terminaison des jetons. Son appel authenticate protège la route MCP, et le SDK sert MCP derrière lui. Les pages de connexion et de consentement restent les vôtres.
- Licence
- Apache-2.0
- Construit avec
- TypeScript, ESM, sur Node.js 22.18 ou une version plus récente
- Normes
- OAuth 2.1, Client ID Metadata Documents, PKCE S256, et les métadonnées de ressource protégée (RFC 9728) et de serveur d'autorisation (RFC 8414)
- Non inclus
- L'inscription dynamique des clients, un point de terminaison JWKS, les clients confidentiels, et tout écran de connexion ou de consentement
- Installation
- npm install mcp-frontdesk. Un serveur d'exemple exécutable se trouve dans le dépôt, pas dans le paquet
- État
- Publié sur npm avec une attestation de provenance. L'API peut encore changer avant la version 1.0; lisez son SECURITY-MODEL.md avant de le placer devant de vrais comptes
Participer
Les tickets et les demandes de fusion sont les bienvenus sur GitHub. Signalez une vulnérabilité en privé, comme l'indique la politique de sécurité, et non dans un ticket public.
- Guide de contribution
- CONTRIBUTING.md
- Politique de sécurité
- SECURITY.md
- Journal des modifications
- CHANGELOG.md

