MCP Fusion/Get started/Installation

Installation

Demandez à l’IA à propos de Vinkius

Installez @mcpfusion/core, générez votre premier serveur avec la CLI et découvrez quels paquets additionnels existent pour l’authentification, les tests et le déploiement.

MCP Fusion est distribué comme le paquet npm @mcpfusion/core avec un ensemble d’add-ons optionnels. Tout fonctionne sur Node.js 18 ou supérieur avec TypeScript 5.7 ou supérieur.

Installer le core

bash

npm install @mcpfusion/core @modelcontextprotocol/sdk

Le @modelcontextprotocol/sdk officiel est une peer dependency : MCP Fusion implémente le protocole MCP 2.0 par-dessus et reste entièrement conforme.

Générer un serveur

bash

npx @mcpfusion/core create my-server

Le scaffold pose quelques questions et génère un projet fonctionnel :

src/server.ts avec initMCPFusion() prêt à tourner
src/tools/, où le routing basé sur les fichiers découvre vos tools
src/server.ts où startServer() définit le transport et le port
Un contrat d’architecture SKILL.md que les agents de codage IA suivent automatiquement

Vous travaillez avec un agent de codage IA comme Cursor, Claude Code, Copilot ou Windsurf ? La CLI injecte le contrat SKILL.md dans .cursorrules, .windsurfrules et .clinerules pour vous. L’agent écrit alors du code style MVA sans qu’on le lui demande. Voir Skills.

Lancer en local

bash

mcpfusion dev --server ./src/server.ts

mcpfusion dev démarre le serveur avec hot reload. Connectez un client pour l’essayer tout de suite :

bash

claude mcp add my-server npx tsx src/server.ts

Paquets additionnels

Chaque add-on est un paquet npm distinct sous le scope @mcpfusion. N’installez que ce dont vous avez besoin.

Paquet	Ce qu’il ajoute
`@mcpfusion/yaml`	Tools sans code écrites en YAML
`@mcpfusion/jwt`	Vérification JWT avec HS256, RS256 et JWKS
`@mcpfusion/oauth`	OAuth 2.0 Device Authorization Grant
`@mcpfusion/api-key`	Validation d’API keys résistante aux attaques temporelles
`@mcpfusion/skills`	Divulgation progressive de `SKILL.md`
`@mcpfusion/testing`	Harness de tests en mémoire pour tout le pipeline
`@mcpfusion/vercel`	Déploie le même serveur sur Vercel
`@mcpfusion/cloudflare`	Déploie le même serveur sur Cloudflare Workers
`@mcpfusion/aws`	Transforme des fonctions Lambda et Step Functions en tools
`@mcpfusion/openapi-gen`	Génère des Models, Views et Agents à partir de specs OpenAPI
`@mcpfusion/prisma-gen`	Génère des tools et des Presenters à partir d’un schema Prisma

bash

npm install @mcpfusion/jwt

Options du serveur

Il n’y a pas de fichier de configuration séparé : l’entrée du serveur appelle startServer() avec un simple objet d’options. Le transport est stdio (par défaut), http (Streamable HTTP avec sessions, avec options de port, TTL, limite de débit et CORS) ou stateless (MCP 2.0 : un serveur neuf par requête, sans handshake, tout équilibreur de charge sert toute requête).

Prochaines étapes

Quickstart : construisez et connectez une première tool
Deploy : placez votre connecteur sur Vinkius Cloud gratuitement
CLI : chaque commande mcpfusion expliquée