NPM-Helfer MCP

📦 NPM Helper – Ein Tool, das Ihrem KI-Assistenten bei der NPM-Paketverwaltung hilft.🤖

Ein Model Context Protocol-Server für das NPM-Abhängigkeitsmanagement. Dieser Server bietet Tools für die NPM-Paketsuche und zum Aktualisieren von NPM-Paketen. So wird sichergestellt, dass die Abhängigkeiten Ihres Projekts stets aktuell und kompatible Versionen sind, ohne dass es zu Konflikten oder Problemen kommt.

Für ein sicheres Upgrade der package.json eines Projekts kann Ihr Assistent das Tool „upgradePackagets“ mit dem Parameter „peer“ auf „true“ aufrufen. Dadurch werden wahrscheinlich nicht alle Abhängigkeiten auf die neueste Version aktualisiert, aber sie werden sicher und fehlerfrei auf die neueste kompatible Version aktualisiert.

Wenn Sie ein vollständiges Upgrade aller Abhängigkeiten wünschen, bietet Ihnen Ihr Assistent zahlreiche Tools und Parameter zur sicheren Untersuchung. Parameteroptionen und Beispiele finden Sie weiter unten im Abschnitt „Verfügbare Tools“. Weitere Informationen finden Sie auch im Verzeichnis „docs“.

Es stehen auch Tools zum Suchen und Abrufen von Informationen aus npmjs zur Verfügung, wenn Sie Optionen für neue Pakete erkunden, die Sie Ihrem Projekt hinzufügen können, oder wenn Sie nach Informationen zu einem bestimmten Paket suchen.

✨ Funktionen

npm-check-updates Werkzeuge

🔍 checkUpdates : Durchsucht package.json nach veralteten Abhängigkeiten
🚀 upgradePackages : Aktualisieren Sie Abhängigkeiten auf die neuesten Versionen
🔎 filterUpdates : Überprüfen Sie Updates für bestimmte Pakete
🔄 resolveConflicts : Behandeln Sie Abhängigkeitskonflikte
⚙️ setVersionConstraints : Konfigurieren Sie Regeln für Versionsupgrades
🩺 runDoctor : Führen Sie iterativ Upgrades und Tests durch, um schwerwiegende Änderungen zu erkennen

NPM-Suchtools

🔍 searchPackages : Durchsuchen Sie das npmjs.org-Register nach Paketen
📝 fetchPackageContent : Scrapen und extrahieren Sie Inhalte von npm-Paketseiten
📋 getPackageVersions : Versionsverlauf von Paketen abrufen
📝 getPackageDetails : Detaillierte Paketmetadaten abrufen

🚀 npm-helper-mcp Installationsanleitung

Diese Anleitung hilft Ihnen beim Einrichten und Ausführen des npm-helper-mcp-Servers.

📋 Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Folgendes installiert ist:

Node.js (Version 18.x oder höher)
npm (Version 8.x oder höher)

🔧 Konfiguration

Der npm-helper-mcp-Server implementiert das Model Context Protocol, wodurch er mit LLM-Anwendungen kommunizieren kann, die das Protokoll unterstützen.

Die Konfiguration variiert je nach Anwendung. Die meisten MCP-Clientanwendungen verfügen in der Regel über eine JSON-Konfigurationsdatei oder einen Platz für den Befehl zum Ausführen des Servers. Eine dieser beiden Optionen sollte in den meisten Fällen funktionieren.

Option 1: Ausführen mit npx

Am einfachsten lässt sich der Server mit npx nutzen, da hierfür keine lokale Installation erforderlich ist. Abhängig von Ihrem MCP-Client verwenden Sie eine der folgenden zwei Methoden:

Kopieren Sie die JSON-Konfiguration und fügen Sie sie in die MCP-Konfigurationsdatei Ihrer Anwendung ein.

{
    "mcpServers": {
      "npm-helper": {
        "command": "npx",
        "args": [
            "-y",
            "@pinkpixel/npm-helper-mcp"
        ]
      }
    }
  }

Geben Sie den Befehl zum Ausführen des Servers in den MCP-Konfigurationseinstellungen Ihrer Anwendung ein.

  npx -y @pinkpixel/npm-helper-mcp

Option 2: Lokale Installation

Wenn Sie den Server lieber lokal installieren möchten, können Sie dies mit dem folgenden Befehl tun:

# Install the package globally
npm install -g npm-helper-mcp

Konfiguration:

Kopieren Sie die JSON-Konfiguration und fügen Sie sie in die MCP-Konfigurationsdatei Ihrer Anwendung ein.

{
    "mcpServers": {
      "npm-helper": {
        "command": "npx",
        "args": [
            "-y",
            "@pinkpixel/npm-helper-mcp"
        ]
      }
    }
  }

Geben Sie den Befehl zum Ausführen des Servers in den MCP-Konfigurationseinstellungen Ihrer Anwendung ein.

  npm-helper-mcp

Option 3: Von der Quelle installieren

# Clone the repository
git clone https://github.com/pinkpixel-dev/npm-helper-mcp.git
cd npm-helper-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Optionally run/test the server
npm start

Konfiguration:

Kopieren Sie die JSON-Konfiguration und fügen Sie sie in die MCP-Konfigurationsdatei Ihrer Anwendung ein.

{
    "mcpServers": {
      "npm-helper": {
        "command": "node",
        "args": [
            "/path/to/npm-helper-mcp/dist/index.js"
        ]
      }
    }
  }

Geben Sie den Befehl zum Ausführen des Servers in den MCP-Konfigurationseinstellungen Ihrer Anwendung ein.

 node /path/to/npm-helper-mcp/dist/index.js

Verwendung mit LLMs

Dieser Server folgt dem Model Context Protocol und kann daher von LLMs wie Claude verwendet werden. Der LLM kann die Tools des Servers nutzen, um verschiedene npm-Operationen auszuführen.

Verfügbare Tools

Werkzeug: check_updates

Durchsucht package.json nach veralteten Abhängigkeiten.

Parameter:

packagePath (optional): Pfad zur Datei package.json (Standard: ./package.json)
filter (optional): Liste der zu prüfenden Paketnamen
reject (optional): Liste der auszuschließenden Paketnamen
target (optional): Zielversion, auf die aktualisiert werden soll (neueste, neuste, beste, Nebenversion, Patch, Semver)
interactive (optional): Aktiviert den interaktiven Modus zur Auswahl von Updates
peer (optional): Überprüfen Sie die Peer-Abhängigkeiten der installierten Pakete
minimal (optional): Aktualisieren Sie keine neueren Versionen, die bereits durch den Versionsbereich abgedeckt sind
packageManager (optional): Zu verwendender Paketmanager (npm, yarn, pnpm, deno, bun, staticRegistry)

Beispiel:

{
  "name": "check_updates",
  "arguments": {
    "packagePath": "./package.json",
    "filter": ["react", "lodash"],
    "peer": true,
    "minimal": true,
    "packageManager": "npm"
  }
}

Werkzeug: upgrade_packages

Aktualisiert Abhängigkeiten auf die neuesten Versionen.

Parameter:

packagePath (optional): Pfad zur Datei package.json (Standard: ./package.json)
upgradeType (optional): Zielversion, auf die aktualisiert werden soll (neueste, neuste, beste, Nebenversion, Patch, Semver)
interactive (optional): Aktiviert den interaktiven Modus zur Auswahl von Updates
peer (optional): Überprüfen Sie die Peer-Abhängigkeiten der installierten Pakete
minimal (optional): Aktualisieren Sie keine neueren Versionen, die bereits durch den Versionsbereich abgedeckt sind
packageManager (optional): Zu verwendender Paketmanager (npm, yarn, pnpm, deno, bun, staticRegistry)

Beispiel:

{
  "name": "upgrade_packages",
  "arguments": {
    "upgradeType": "minor",
    "peer": true,
    "minimal": true,
    "packageManager": "yarn"
  }
}

Werkzeug: filter_updates

Überprüft Updates für bestimmte Pakete.

Parameter:

packagePath (optional): Pfad zur Datei package.json (Standard: ./package.json)
filter (erforderlich): Liste der zu prüfenden Paketnamen
upgrade (optional): Ob die Datei package.json aktualisiert oder nur überprüft werden soll
minimal (optional): Aktualisieren Sie keine neueren Versionen, die bereits durch den Versionsbereich abgedeckt sind
packageManager (optional): Zu verwendender Paketmanager (npm, yarn, pnpm, deno, bun, staticRegistry)

Beispiel:

{
  "name": "filter_updates",
  "arguments": {
    "filter": ["react", "react-dom"],
    "upgrade": false,
    "minimal": true
  }
}

Werkzeug: Konflikte lösen

Behandelt Abhängigkeitskonflikte mithilfe von Peer-Abhängigkeiten.

Parameter:

packagePath (optional): Pfad zur Datei package.json (Standard: ./package.json)
upgrade (optional): Ob die Datei package.json aktualisiert oder nur überprüft werden soll
minimal (optional): Aktualisieren Sie keine neueren Versionen, die bereits durch den Versionsbereich abgedeckt sind
packageManager (optional): Zu verwendender Paketmanager (npm, yarn, pnpm, deno, bun, staticRegistry)

Beispiel:

{
  "name": "resolve_conflicts",
  "arguments": {
    "upgrade": true,
    "packageManager": "npm"
  }
}

Werkzeug: set_version_constraints

Konfiguriert Regeln für Versionsupgrades.

Parameter:

packagePath (optional): Pfad zur Datei package.json (Standard: ./package.json)
target (erforderlich): Strategie zur Einschränkung der Zielversion (neueste, neuste, beste, Nebenversion, Patch, Semver)
removeRange (optional): Entfernt Versionsbereiche aus der endgültigen Paketversion
upgrade (optional): Ob die Datei package.json aktualisiert oder nur überprüft werden soll
minimal (optional): Aktualisieren Sie keine neueren Versionen, die bereits durch den Versionsbereich abgedeckt sind
packageManager (optional): Zu verwendender Paketmanager (npm, yarn, pnpm, deno, bun, staticRegistry)

Beispiel:

{
  "name": "set_version_constraints",
  "arguments": {
    "target": "minor",
    "removeRange": false,
    "upgrade": true,
    "packageManager": "pnpm"
  }
}

Werkzeug: run_doctor

Installiert iterativ Upgrades und führt Tests durch, um fehlerhafte Upgrades zu identifizieren. Fehlerhafte Upgrades werden automatisch rückgängig gemacht, während funktionierende Upgrades erhalten bleiben.

Parameter:

packagePath (optional): Pfad zur Datei package.json (Standard: ./package.json)
doctorInstall (optional): Zu verwendendes benutzerdefiniertes Installationsskript (Standard: „npm install“ oder „yarn“)
doctorTest (optional): Zu verwendendes benutzerdefiniertes Testskript (Standard: „npm test“)
packageManager (optional): Zu verwendender Paketmanager (npm, yarn, pnpm, deno, bun, staticRegistry)

Beispiel:

{
  "name": "run_doctor",
  "arguments": {
    "packagePath": "./package.json",
    "doctorInstall": "npm ci",
    "doctorTest": "npm run test:ci",
    "packageManager": "npm"
  }
}

Werkzeug: search_npm

Sucht nach npm-Paketen.

Parameter:

query (erforderlich): Suchanfrage für npm-Pakete
maxResults (optional): Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 10)

Beispiel:

{
  "name": "search_npm",
  "arguments": {
    "query": "react state management",
    "maxResults": 5
  }
}

Werkzeug: fetch_package_content

Rufen Sie detaillierte Inhalte von einer NPM-Paketseite ab und analysieren Sie sie.

Parameter:

url (erforderlich): URL der npm-Paketseite

Beispiel:

{
  "name": "fetch_package_content",
  "arguments": {
    "url": "https://www.npmjs.com/package/react"
  }
}

Werkzeug: get_package_versions

Ruft verfügbare Versionen für ein NPM-Paket ab.

Parameter:

packageName (erforderlich): Name des npm-Pakets

Beispiel:

{
  "name": "get_package_versions",
  "arguments": {
    "packageName": "react"
  }
}

Werkzeug: get_package_details

Ruft detaillierte Informationen zu einem npm-Paket ab.

Parameter:

packageName (erforderlich): Name des npm-Pakets

Beispiel:

{
  "name": "get_package_details",
  "arguments": {
    "packageName": "react"
  }
}

📝 Antwortformat

Alle Tools geben Antworten in einem Standardformat zurück:

{
  "status": "success" | "error",
  "data": {}, // Tool-specific data
  "message": "Human-readable message"
}

🆘 Fehlerbehebung

Verbindungsprobleme**:

Stellen Sie sicher, dass Ihre LLM-Anwendung für die Verwendung des Model Context Protocol richtig konfiguriert ist.
Überprüfen Sie Ihre JSON-Datei auf Fehler oder stellen Sie sicher, dass Ihr Startbefehl korrekt ist.
Überprüfen Sie bei lokaler Ausführung den Pfad zur Datei index.js. Verwenden Sie bei Bedarf absolute Pfade.

Hilfe bekommen

Wenn Sie auf Probleme stoßen, die hier nicht behandelt werden:

Suchen Sie in den GitHub-Problemen nach ähnlichen Problemen und Lösungen.
Erstellen Sie ein neues Problem mit einer detaillierten Beschreibung Ihres Problems.

📄 Lizenz

MIT

🙏 Credits

Hergestellt mit ❤️ von Pink Pixel

NPM Helper MCP

Integrations

📦 NPM Helper – Ein Tool, das Ihrem KI-Assistenten bei der NPM-Paketverwaltung hilft.🤖

✨ Funktionen

npm-check-updates Werkzeuge

NPM-Suchtools

🚀 npm-helper-mcp Installationsanleitung

📋 Voraussetzungen

🔧 Konfiguration

Option 1: Ausführen mit npx

Option 2: Lokale Installation

Option 3: Von der Quelle installieren

Verwendung mit LLMs

Verfügbare Tools

Werkzeug: check_updates

Werkzeug: upgrade_packages

Werkzeug: filter_updates

Werkzeug: Konflikte lösen

Werkzeug: set_version_constraints

Werkzeug: run_doctor

Werkzeug: search_npm

Werkzeug: fetch_package_content

Werkzeug: get_package_versions

Werkzeug: get_package_details

📝 Antwortformat

🆘 Fehlerbehebung

Verbindungsprobleme**:

Hilfe bekommen

📄 Lizenz

🙏 Credits

Related MCP Servers

Node Omnibus MCP Server

Linear MCP Server

Codebase MCP

NPM MCP Server

New MCP Servers