MCP Fusion/Get started/Installation

Installation

Frag die KI über Vinkius

Installieren Sie @mcpfusion/core, erstellen Sie mit der CLI Ihr erstes Serverprojekt und lernen Sie die Zusatzpakete für Authentifizierung, Tests und Deployment kennen.

MCP Fusion erscheint als npm-Paket @mcpfusion/core mit einer Reihe optionaler Add-ons. Alles läuft auf Node.js 18 oder neuer mit TypeScript 5.7 oder neuer.

Core installieren

bash

npm install @mcpfusion/core @modelcontextprotocol/sdk

Das offizielle @modelcontextprotocol/sdk ist eine Peer Dependency: MCP Fusion implementiert das MCP-2.0-Protokoll darauf und bleibt vollständig kompatibel.

Ein Server-Scaffold erzeugen

bash

npx @mcpfusion/core create my-server

Das Scaffold stellt ein paar Fragen und erzeugt ein lauffähiges Projekt:

src/server.ts mit einsatzbereitem initMCPFusion()
src/tools/, wo dateibasiertes Routing Ihre Tools entdeckt
src/server.ts, wo startServer() Transport und Port setzt
Ein architektonischer SKILL.md-Vertrag, dem KI-Coding-Agenten automatisch folgen

Arbeiten Sie mit einem KI-Coding-Agenten wie Cursor, Claude Code, Copilot oder Windsurf? Die CLI injiziert den SKILL.md-Vertrag für Sie in .cursorrules, .windsurfrules und .clinerules. Der Agent schreibt dann MVA-artigen Code, ohne dass Sie es sagen müssen. Siehe Skills.

Lokal ausführen

bash

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

mcpfusion dev startet den Server mit Hot Reload. Verbinden Sie einen Client und probieren Sie es direkt aus:

bash

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

Add-on-Pakete

Jedes Add-on ist ein eigenes npm-Paket im @mcpfusion-Scope. Installieren Sie nur, was Sie brauchen.

Paket	Was es hinzufügt
`@mcpfusion/yaml`	Codefreie Tools, geschrieben in YAML
`@mcpfusion/jwt`	JWT-Verifizierung mit HS256, RS256 und JWKS
`@mcpfusion/oauth`	OAuth 2.0 Device Authorization Grant
`@mcpfusion/api-key`	Timing-sichere API-Key-Validierung
`@mcpfusion/skills`	Progressive `SKILL.md`-Offenlegung
`@mcpfusion/testing`	In-Memory-Test-Harness für die gesamte Pipeline
`@mcpfusion/vercel`	Deploy des gleichen Servers auf Vercel
`@mcpfusion/cloudflare`	Deploy des gleichen Servers auf Cloudflare Workers
`@mcpfusion/aws`	Macht Lambda-Funktionen und Step Functions zu Tools
`@mcpfusion/openapi-gen`	Generiert Models, Views und Agents aus OpenAPI-Specs
`@mcpfusion/prisma-gen`	Generiert Tools und Presenter aus einem Prisma-Schema

bash

npm install @mcpfusion/jwt

Server-Optionen

Es gibt keine separate Konfigurationsdatei: der Server-Eintrag ruft startServer() mit einem einfachen Optionsobjekt auf. Der transport ist stdio (Standard), http (Streamable HTTP mit Sessions, mit Port-, TTL-, Rate-Limit- und CORS-Optionen) oder stateless (MCP 2.0: pro Anfrage ein frischer Server, kein Handshake, jeder Load Balancer bedient jeden Aufruf).

Nächste Schritte

Quickstart: ein erstes Tool bauen und verbinden
Deploy: Ihren Connector kostenlos auf Vinkius Cloud bringen
CLI: jeder mcpfusion-Befehl erklärt