MCPort

MCPort ist ein lokales MCP-Tool für die Arbeit mit Projekten über KI. Es ermöglicht einem KI-Client, Code zu lesen, Dateien zu durchsuchen, Symbole zu verstehen, Git zu prüfen, Dateien zu bearbeiten und – wenn ausdrücklich autorisiert – kontrollierte Entwicklungsbefehle in ausgewählten Workspaces auszuführen.

Projektdateien, Laufzeitzustand und Anmeldedaten bleiben standardmäßig auf deinem Rechner. Du kannst MCP lokal verwenden oder OAuth-/Bearer-Token-Zugriff für ausgewählte Workspaces über das öffentliche Internet aktivieren.

中文说明：README.zh-CN.md

Funktionen

• Projektdateien, Quellcode, Bilder und Verzeichnisse lesen und durchsuchen

• Code-Indexierung sowie Unterstützung für Definitionen, Referenzen, Hover und Dokument-Symbole

• Git-Status, Diffs, Verlauf und Blame

• Eingeschränkte Dateierstellung, -bearbeitung, -import, -kopie, -verschiebung und -löschung

• Checkpoints, Aufgaben, Validierung und Wiederherstellung für Dateiänderungen

• Kontrollierte Befehlsausführung mit Whitelists, Timeouts, Ausgabelimits und lokaler Bestätigung

• Lokaler oder öffentlicher MCP-Zugriff für einen oder mehrere Workspaces

• Sprachspezifische LSP-Installation und -Updates mit Unterstützung für benutzerdefinierte Server

Related MCP server: Project Navigator MCP Server

Einen KI-Client verbinden

Füge in MCPort unter Projekte ein Projekt hinzu, aktiviere MCP für den Workspace und kopiere dann dessen Verbindungsinformationen. Füge die kopierte MCP-Adresse zu den MCP-Einstellungen deines KI-Clients hinzu. Für öffentlichen Zugriff verwende die öffentliche Adresse des Workspace und dessen konfigurierte OAuth- oder Bearer-Token-Authentifizierung.

Zu den gängigen Clients, die MCP unterstützen, gehören Claude Desktop, Cursor, Windsurf, Cline, Continue und andere MCP-kompatible Clients. Die Speicherorte der Einstellungen und Konfigurationsformate variieren; folge der aktuellen MCP-Dokumentation des Clients und füge die von MCPort bereitgestellte Adresse oder Konfiguration ein.

Nach der Installation oder Aktualisierung eines LSP bitte den KI-Client, server_info erneut aufzurufen, damit er die verfügbaren Sprachfunktionen aktualisieren kann.

macOS-Installation

Das aktuelle macOS-Release ist nicht signiert. Nachdem du MCPort.app in /Applications gezogen hast, führe Folgendes aus:

xattr -dr com.apple.quarantine "/Applications/MCPort.app"

Führe dies nur für den offiziellen Download durch, nachdem du SHA256SUMS.txt überprüft hast.

Verbindungen

Lokaler Zugriff akzeptiert standardmäßig Loopback-Anfragen. Öffentlicher Zugriff kann Cloudflare Tunnel, TryCloudflare, FRP Client oder einen externen Tunnel mit OAuth (empfohlen) oder Bearer-Token-Authentifizierung verwenden.

Öffentliche Workspaces verwenden Routen wie:

https://mcp.example.com/w/<workspace>/mcp

Dateien, Code und LSP

Dateioperationen bleiben nach Realpath- und Symlink-Prüfungen innerhalb des ausgewählten Workspace. Der integrierte Code-Index unterstützt TypeScript, TSX, JavaScript, JSX, MJS und CJS.

Sprachserver werden unabhängig verwaltet und können bei Bedarf installiert oder aktualisiert werden. Unterstützte Sprachen umfassen TypeScript/JavaScript, HTML, CSS/SCSS/LESS, Python, JSON, YAML, Markdown, Go, Rust, Java, C, C++ und PHP. Für andere Sprachen können benutzerdefinierte LSP-Definitionen hinzugefügt werden.

Berechtigungsstufen

• readonly: Projektnavigation, Suche, Code-Verständnis, schreibgeschütztes Git und Verlauf

• standard: Dateiänderungen, Importe, Checkpoints, Aufgaben und schnelle Validierung

• full: kontrollierte Befehle, Befehlssitzungen, Wiederherstellung und vollständige Validierung

Befehle verwenden einen ausführbaren Namen plus ein Argument-Array, niemals einen beliebigen Shell-String. Sie unterliegen weiterhin dem globalen Befehls-Schalter, der exakten Whitelist, Timeouts, Ausgabelimits und der Bestätigung bei hohem Risiko.

Sicherheit

Workspace-Grenzen werden nach der Auflösung realer Pfade und Symlinks überprüft. Dateiänderungen unterstützen SHA256-Baselines, transaktionales Rollback und Checkpoints. Öffentliche Workspaces erfordern immer eine Authentifizierung. Tokens, Tunnel-Anmeldedaten und andere Geheimnisse verwenden den sicheren Systemspeicher und werden aus Protokollen und Traces entfernt.

Die Runtime läuft als angemeldeter Betriebssystem-Benutzer. Die Befehls-Whitelist ist keine Betriebssystem-Sandbox.

Dokumentation

• Desktop-Anleitung

• KI-Client-Anleitung

• MCP-Tools

• LSP-Anleitung

• Sicherheit

• Öffentliches Gateway und OAuth

• Tools und Berechtigungen

• Release-Anleitung

Mitwirken

MCPort wird von Sky gepflegt und unter der MIT-Lizenz veröffentlicht. Issues und Pull Requests sind willkommen. Siehe CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, Datenschutzhinweise und Drittanbieter-Hinweise.

Drittanbieter-LSPs werden über ihre eigenen offiziellen Paketmanager oder Release-Kanäle installiert und sind nicht in MCPort gebündelt. Beachte die Lizenz und Bedingungen jedes Projekts.