Smithery CLI Skill

Agenten-Skill zum Entdecken, Konfigurieren und Aufrufen von MCP-Servern und Werkzeugen direkt über die Smithery-Kommandozeile.

Der Smithery CLI Skill ist ein von Smithery und Arcade AI entwickelter Steuerungs-Skill für autonome KI-Agenten. Er vermittelt Sprachmodellen wie Claude Code, Codex oder Cursor die genauen Abläufe und Syntaxregeln, um über die globale Kommandozeile nach neuen MCP-Servern zu suchen, Server-Endpunkte zu registrieren, Werkzeuge hierarchisch zu inspizieren und Aufrufe direkt auszuführen. Das offizielle Quellcode-Repository liegt unter github.com/arcadeai-labs/smithery-cli (vormals smithery-ai/cli), der Skill selbst ist im Repository unter skills/smithery-ai-cli/SKILL.md definiert.

Was der Skill einem Agenten beibringt

Viele KI-Agenten kennen das Model Context Protocol abstrakt, wissen jedoch nicht, wie sie während einer laufenden Arbeitsaufgabe eigenständig neue Werkzeuge im System bereitstellen oder remote ansprechen. Dieser Skill schließt genau diese Wissenslücke. Sobald eine Nutzeranfrage eine externe Integration erfordert, beispielsweise Zugriff auf GitHub-Issues, Jira-Tickets, PostgreSQL-Datenbanken, Notizen oder Cloud-Monitoring, aktiviert der Agent den Skill und führt mehrere strukturierte Schritte durch.

Zunächst sucht der Agent über den Befehl smithery mcp search im Smithery-Ökosystem nach qualifizierten Server-Namen oder URLs für den gewünschten Dienst. Anschließend registriert er den gefundenen Server über smithery mcp add unter einer prägnanten lokalen Kennung.

Für die gezielte Werkzeugauswahl nutzt der Agent smithery tool list. Dieser Befehl zeigt hierarchisch gegliederte Gruppen an, sodass der Agent gezielt in Unterbereiche wie github issues vordringen kann, statt hunderte Definitionen auf einmal ins Kontextfenster zu laden. Vor der tatsächlichen Ausführung liest smithery tool get die exakte Schema-Struktur für Eingabeparameter aus, was Fehlaufrufe und Ratenlimit-Verluste verhindert. Schließlich führt smithery tool call das Werkzeug mit validierten Nutzdaten über die Befehlszeile aus.

Abgrenzung zwischen Skill, Server und CLI-Programm

Der Skill ist weder ein eigenständiger MCP-Server noch enthält er die eigentliche Programmlogik der CLI. Er stellt eine handlungsleitende Wissensbasis dar. Zur praktischen Ausführung muss das CLI-Programm smithery über den Paketmanager npm global installiert sein. Für interaktive Authentifizierungen bei Diensten leitet der Skill den Agenten an, den Nutzer zur Bestätigung über den Browser aufzufordern, anstatt Passwörter im Terminal abzufragen.

Sicherheit, Berechtigungen und Least Privilege

Weil der Agent über die CLI Werkzeuge anbinden und ausführen kann, die möglicherweise schreibenden Zugriff auf externe Dienste wie Repositories oder Datenbanken ausüben, betont der Skill strikte Sicherheitsregeln. Jeder schreibende Befehl erfordert vorab die menschliche Freigabe oder eine bewusste Eingrenzung. Die Smithery-Authentifizierung speichert Session-Tokens lokal. Der Agent wird angewiesen, Tokens und Anmeldedaten niemals in Logdateien, Prompts oder Versionskontrollen auszugeben.

Installation und Befehle

Die Installation erfolgt mit npm install -g smithery@latest und verlangt Node.js 20 oder neuer. Die Befehle gliedern sich in mcp (search, add, list, remove, publish), tool (list, find, get, call), auth (login, logout, whoami, token) und namespace (list, use). Veröffentlichen lassen sich Server per Adresse oder als .mcpb-Bundle mit smithery mcp publish. Das Projekt steht unter der AGPL-3.0-Lizenz.

Lizenz und Einordnung im Katalog

Das zugrundeliegende CLI-Repository wird unter der GNU Affero General Public License Version 3 (AGPL-3.0) bereitgestellt. Am 09.09.2026 wies das Repository 833 Sterne auf GitHub auf. Diese Metrik gilt für das gesamte CLI-Repository und nicht isoliert für den Skill-Ordner. Die Nutzung der CLI und des Skills ist quelloffen und lizenzkostenfrei. Für bestimmte über Smithery gehostete Remote-Endpunkte können separate Konditionen der jeweiligen Anbieter anfallen, weshalb dieser Katalogeintrag keine konkreten Preise nennt.

Installationsanleitung

Was die Smithery CLI Skill ist

Smithery ist ein Registrierungsdienst und Werkzeugkatalog für den Model Context Protocol Standard, kurz MCP, der es KI-Agenten erlaubt, standardisiert auf externe Werkzeuge und Datenquellen zuzugreifen. Die zugehörige Smithery CLI, entwickelt im Repository arcadeai-labs/smithery-cli, ist laut Anbieter das Kommandozeilenwerkzeug, mit dem Nutzer ihre Agenten direkt vom Terminal aus mit tausenden Skills und MCP-Servern verbinden können. Statt jede Integration einzeln von Hand zu konfigurieren, bündelt die CLI Suche, Installation, Verwaltung und Aufruf von MCP-Werkzeugen in einem einzigen Kommandozeilenprogramm. Damit richtet sich die Skill vor allem an Entwicklerinnen und Entwickler, die mehrere KI-Agenten mit unterschiedlichen externen Diensten verdrahten wollen, ohne für jede Anbindung eine eigene Konfigurationsdatei von Hand zu pflegen.

Schritt 1: Installation und Grundfunktionen

Die Installation erfolgt laut offiziellem README über den Node-Paketmanager npm mit dem Befehl npm install global smithery latest, wobei Node.js in Version 20 oder neuer vorausgesetzt wird. Nach der Installation stehen mehrere Befehlsgruppen zur Verfügung. Der Bereich für MCP-Server erlaubt es, die Smithery-Registry nach passenden Servern zu durchsuchen, gefundene Server per URL hinzuzufügen, bestehende Verbindungen aufzulisten und nicht mehr benötigte Verbindungen zu entfernen. Eine zweite Befehlsgruppe dreht sich um die eigentlichen Werkzeuge, sogenannte Tools, die von den verbundenen MCP-Servern bereitgestellt werden: Man kann verfügbare Tools auflisten, per Stichwort oder Absicht danach suchen, Details zu einem einzelnen Tool einsehen und es schließlich mit passenden Parametern aufrufen.

Schritt 2: Authentifizierung, Namespaces und Skills-Verwaltung

Für den Zugriff auf geschützte Bereiche der Registry und zum Veröffentlichen eigener Server bringt die CLI einen Authentifizierungsbereich mit, der eine Anmeldung per OAuth im Browser, eine Abmeldung, eine Identitätsprüfung sowie das Ausstellen von Service-Tokens mit optional eingeschränkten Berechtigungen ermöglicht. Ergänzend dazu lassen sich über Namespace-Befehle mehrere Arbeitsbereiche verwalten und zwischen ihnen wechseln, was insbesondere für Teams nützlich ist, die getrennte Umgebungen etwa für Entwicklung und Produktion pflegen. Neben MCP-Servern unterstützt Smithery auch eine eigene Skills-Registry, die separate, wiederverwendbare Fähigkeitsmodule für Agenten enthält und mit einem vorgelagerten Installer namens npx skills add durchsucht und installiert wird.

Schritt 3: Praktischer Einsatz: Server verbinden und veröffentlichen

Im Alltag beginnt die Nutzung meist mit einer Suche, etwa nach einem GitHub-Werkzeug, gefolgt vom Hinzufügen des gefundenen Servers unter einer selbst gewählten Kennung. Anschließend kann man Tools des verbundenen Servers suchen und direkt mit strukturierten Argumenten aufrufen, etwa um ein neues Issue in einem Repository anzulegen. Wer selbst einen MCP-Server betreibt, kann diesen über den Publish-Befehl entweder direkt per URL oder als gebündeltes MCP-Bundle-Archiv in der Registry veröffentlichen, sodass er für andere Nutzer auffindbar wird. Für die Weiterentwicklung der CLI selbst steht der Quellcode offen zur Verfügung und kann über git clone, den Paketmanager pnpm und einen lokalen Build-Schritt getestet werden.

Sicherheit, Best Practices und Grenzen

Weil die CLI Zugangs-Tokens für Drittanbieter-Dienste verwaltet und Agenten Zugriff auf potenziell sensible Werkzeuge gewährt, sollte die Authentifizierung stets über die vorgesehenen OAuth- und Token-Mechanismen erfolgen und niemals durch das händische Kopieren von Zugangsdaten in Konfigurationsdateien ersetzt werden. Eingeschränkte Service-Tokens mit definierter Policy sind vorzuziehen, wenn ein Agent nur begrenzte Rechte benötigen soll, statt ihm vollen Kontozugriff zu geben. Ein bekannter Risikofaktor bei MCP-Integrationen generell ist, dass verbundene Server im Namen des Agenten Aktionen ausführen können, weshalb nur vertrauenswürdige, aus offizieller Quelle stammende Server verbunden werden sollten. Die Grenze der Smithery CLI liegt darin, dass sie als reines Verbindungs- und Verwaltungswerkzeug fungiert: Sie liefert weder Garantien für die Qualität einzelner registrierter Server noch übernimmt sie inhaltliche Verantwortung für deren Verhalten, sodass eine Prüfung der einzelnen Werkzeuge vor dem produktiven Einsatz sinnvoll bleibt.

Kostenlos
Anbieter
Smithery
Lizenz
AGPL-3.0
Zuletzt geprüft
09.09.2026

Repository und Dokumentation

Kategorien

Kompatibel mit

Claude Code Codex Cursor