Desktop Extensions (DXT): Paketierungswerkzeug zur Vereinfachung der lokalen MCP-Server-Installation

Desktop Extensions (kurz DXT) ist ein von Anthropic entwickeltes Tool, das native MCP-Server (Model Context Protocol) in einfach zu installierende.dxtDXT ist in einem ZIP-komprimierten Format erhältlich und enthält alle Dateien für den MCP-Server und eine Es ermöglicht Entwicklern die schnelle Integration des MCP-Servers in Desktop-Anwendungen, und Benutzer können ihn mit einem einzigen Klick ohne komplexe Konfiguration installieren.DXT wird in einem ZIP-komprimierten Format geliefert und enthält alle Dateien für den MCP-Server und einemanifest.jsonAnthropic ermutigt Entwickler, sich an Verbesserungen zu beteiligen, indem sie die DXT-Spezifikation und die Toolchain offenlegen, um die Popularität von KI-Tools für Desktop-Anwendungen zu fördern. DXT unterstützt Anwendungen wie Claude Desktop und bietet Funktionen wie automatische Aktualisierungen und eine einfache Konfiguration, wodurch die Nutzungsbarriere sowohl für Entwickler als auch für Unternehmensanwender gesenkt wird.

Funktionsliste

• Ein-Klick-Installation des MCP-ServersBenutzer können auf die Website zugreifen, indem sie auf das Symbol.dxtDatei, um den lokalen MCP-Server zu installieren, ohne dass die Umgebung manuell konfiguriert werden muss.
• Erzeugen von ErweiterungsdateienCLI-Tools, mit denen Entwickler mit einfachen Befehlen Pakete erstellen und verpacken können.dxtErweiterte Dokumentation.
• Unterstützt mehrere BetriebsumgebungenKompatibel mit Node.js, Python und anderen Laufzeiten, unterstützt macOS, Windows, Linux-Plattform.
• Sicherer AuthentifizierungsmechanismusGewährleistung der Betriebssicherheit durch Überprüfung der erweiterten Integrität mittels kryptografischem Hashing.
• Automatische AktualisierungsfunktionUnterstützung für erweiterte automatische Updates, um den Server auf dem neuesten Stand zu halten.
• Verwaltung der Benutzerkonfiguration: durchmanifest.jsonDefinieren Sie Benutzerkonfigurationselemente wie API-Schlüssel, Verzeichniszugriffsrechte usw.
• Offene ökologische UnterstützungOpen-Source-Spezifikation und Toolchain, die es Entwicklern ermöglicht, das DXT-Format anzupassen und zu erweitern.
• Fehlerbehandlung und ProtokollierungBereitstellung von eindeutigen Fehlermeldungen und Debugging-Protokollen für Entwickler zur Fehlerbehebung.

Hilfe verwenden

Einbauverfahren

Um DXT zu verwenden, müssen Entwickler das DXT CLI-Tool installieren und dann die Erweiterung erstellen und verpacken. Nachfolgend finden Sie die detaillierten Schritte:

1. Installation von Node.js
   DXT CLI hängt von der Node.js-Umgebung ab. Besuchen Sie die Node.js-Website, um die neueste Version herunterzuladen und zu installieren (Node.js >= 16.0.0 empfohlen).
2. Installation der DXT CLI
   Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus, um das DXT CLI-Tool global zu installieren:

   npm install -g @anthropic-ai/dxt
   

3. DXT-Erweiterungen erstellen
   • Erstellen Sie einen lokalen Projektordner, z. B.my-extension.
   • Rufen Sie den Ordner auf und führen Sie den folgenden Befehl aus, um die Erweiterung zu initialisieren:

     dxt init my-extension
     

     Das System fordert Sie auf, den Namen der Erweiterung, die Autoreninformationen und die Erweiterungs-ID einzugeben.package.jsonwerden einige der Informationen automatisch ausgefüllt. Wenn Sie fertig sind, erzeugen Siemanifest.jsonDokumentation.

4. manifest.json konfigurieren
   manifest.jsonist die Kerndatei der DXT-Erweiterung, die die Metadaten und die Serverkonfiguration der Erweiterung definiert. Im Folgenden finden Sie ein Beispiel:

   {
   "dxt_version": "0.1",
   "name": "My MCP Extension",
   "version": "1.0.0",
   "description": "一个简单的MCP服务器扩展",
   "server": {
   "type": "node",
   "entry_point": "server/index.js",
   "mcp_config": {
   "command": "node",
   "args": ["server/index.js"]
   }
   },
   "user_config": {
   "allowed_directories": {
   "type": "directory",
   "title": "允许访问的目录",
   "multiple": true,
   "required": true,
   "default": ["${HOME}/Desktop"]
   }
   }
   }
   

   • Feld Beschreibung::
     • dxt_versionDXT: Die Version der DXT-Spezifikation, der die Erweiterung folgt.
     • nameim Gesang antwortenversionDer Name und die Versionsnummer der Erweiterung.
     • serverMCP-Server: Definieren Sie, wie der MCP-Server läuft, z. B. mit Node.js zur Ausführungserver/index.js.
     • user_configDefinieren Sie benutzerkonfigurierbare Elemente, wie z. B. Verzeichnisse, auf die zugegriffen werden darf.
5. Schreiben von MCP-Servercode
   existierenserverErstellen Sie einen Ordner imindex.jsdie die MCP-Serverlogik implementiert. Die MCP-Serverlogik kann mit Hilfe des@modelcontextprotocol/sdkHandhabung der Kommunikation mit KI-Modellen. Ein einfaches Beispiel ist unten dargestellt:

   const { MCP } = require('@modelcontextprotocol/sdk');
   const server = new MCP();
   server.registerTool({
   name: 'search_files',
   description: '搜索指定目录中的文件',
   execute: async (params) => {
   // 实现文件搜索逻辑
   return { result: '文件列表' };
   }
   });
   server.start();
   

6. Erweiterung der Verpackung
   Nachdem Sie den Code und die Konfiguration abgeschlossen haben, führen Sie den folgenden Befehl aus, um das Projekt als.dxtDokumentation:

   dxt pack my-extension my-extension.dxt
   

   verpackt.dxtDie Datei ist ein ZIP-Archiv, das alle Dateien und Abhängigkeiten enthält.

7. Überprüfung und Unterschrift
   • Überprüfen Sie die Erweiterung: rundxt verify my-extension.dxtPrüfen Sie die Integrität des Dokuments.
   • Signaturerweiterung (optional): rundxt sign my-extension.dxtHinzufügen von Signaturen zu Erweiterungen für zusätzliche Sicherheit.
8. Installation auf Claude Desktop
   • Stellen Sie sicher, dass Claude Desktop auf die neueste Version aktualisiert wurde (die Version, die DXT unterstützt).
   • Öffnen Sie die Claude Desktop-Einstellungen und suchen Sie den Abschnitt "Erweiterungen".
   • Klicken Sie auf "Erweiterung installieren" und wählen Sie.dxtDatei, um eine Ein-Klick-Installation durchzuführen.

Hauptfunktionen

• Erweiterungen erstellen: Verwendungdxt initBefehl zur schnellen Generierungmanifest.jsonund folgen Sie den Aufforderungen, um die erweiterten Informationen zu konfigurieren.
• Erweiterungen der Validierung: Laufdxt validate manifest.jsonÜberprüfen Sie, ob die Konfigurationsdatei mit der DXT-Spezifikation übereinstimmt.
• Betrieb des MCP-ServersNachdem die Erweiterung installiert wurde, wird Claude Desktop sie verwenden, um eine neue Erweiterung zu erstellen, die auf demmanifest.jsonden Nagel auf den Kopf treffenserverKonfiguration zum Starten des lokalen MCP-Servers. Benutzer können über die Schnittstelle API-Schlüssel oder Verzeichnisberechtigungen festlegen.
• Fehlersuche und ProtokollierungDer MCP-Server erzeugt bei seiner Ausführung Protokolle, und Entwickler können die Protokolle auf Toolaufrufe oder Fehlermeldungen überprüfen.
• Unterstützung für dynamische WerkzeugeDXT unterstützt die dynamische Registrierung von Werkzeugen, wie z.B. Dateisuche oder API-Aufrufe, die Entwickler in dermanifest.jsonDefinieren Sie den Werkzeugnamen und die Parameter in der

caveat

• sichermanifest.jsonim Pfad (z. B.server/index.js) mit der tatsächlichen Dokumentstruktur übereinstimmt.
• Das Paket sollte alle Abhängigkeiten enthalten (node_modules), um sicherzustellen, dass die Erweiterung in verschiedenen Umgebungen ordnungsgemäß funktioniert.
• Enterprise-Benutzer können in der Anthropic Enterprise-Dokumentation nachlesen, wie man DXT-Erweiterungen einsetzt.

Anwendungsszenario

1. Schnelle Verbreitung von MCP-Servern durch Entwickler
   Entwickler können komplexe MCP-Server als.dxtDatei, die mit dem Benutzer geteilt wird, und der Benutzer muss die Umgebung nicht konfigurieren, um sie zu verwenden.
2. Unternehmensintegration von KI-Tools
   Unternehmen können maßgeschneiderte DXT-Erweiterungen entwickeln, die sich in interne KI-Workflows wie Datenanalysen oder Automatisierungsaufgaben integrieren lassen.
3. Bildung und Forschung
   Forscher können DXT nutzen, um experimentelle MCP-Server zu erstellen und KI-Modelle zu testen, die mit lokalen Daten interagieren.
4. Persönliche Produktivitätswerkzeuge
   Benutzer können die DXT-Erweiterung auf Claude Desktop installieren, um schnell die Dateisuche, Codegenerierung und andere Funktionen aufzurufen und so die Arbeitseffizienz zu steigern.

QA

1. Wie werden DXT-Erweiterungen gesichert?
   DXT prüft die erweiterte Integrität durch kryptografisches Hashing, um Manipulationen zu verhindern. Die Laufzeitumgebung verwendet eine isolierte Umgebung mit eingeschränktem Serverzugriff.
2. Welche Plattformen werden von DXT unterstützt?
   DXT ist kompatibel mit macOS, Windows und Linux und unterstützt Node.js- und Python-Laufzeiten.
3. Wie kann man DXT-Erweiterungen debuggen?
   Prüfen Sie die Protokolldatei, oder verwenden Sie diedxt info my-extension.dxtÜberprüfen Sie die Erweiterungsinformationen, um sicherzustellen, dass die Konfiguration und der Code korrekt sind.
4. Muss ich die Erweiterung manuell aktualisieren?
   DXT unterstützt automatische Aktualisierungen, so dass die Benutzer nicht manuell neu installieren müssen.
5. Funktioniert DXT auch für andere Anwendungen als Claude?
   Ja, DXT ist ein Open-Source-Format und andere Desktop-Anwendungen, die MCP unterstützen, können DXT integrieren.