pshare-share-mcp

MCP-Server, der jedem KI-System (Claude Code, Claude Desktop oder anderen MCP-Clients) das Hochladen von Dateien/Ordnern auf Pshare und das Erhalten eines Share-Links ermöglicht — genau wie bei manueller Bedienung: über die UI hochladen und dann die Schaltfläche Share drücken, um den Link zu kopieren.

Keine Anmeldung oder Token erforderlich — konsistent mit der aktuellen Architektur von Pshare (auch der Web-Client führt keine echte Authentifizierung durch, sondern verwendet nur eine selbst generierte X-Browser-Id).

Anforderung: Es muss bereits eine Pshare-Instanz irgendwo laufen (localhost oder im LAN) — dieses Repo ist nur ein MCP-Server, der die REST-API von Pshare aufruft, und führt Pshare nicht selbst aus.

Bereitgestellte Tools

pshare_upload

Rückgabewert: Share-Link im Format http://<pshare-host>/?share=<N> zusammen mit der Dateianzahl und dem Passwortstatus.

Dateien > 90MB werden automatisch auf Chunked-Upload umgestellt (wie beim LAN-Upload des Web-Clients), ohne dass weitere Schritte nötig sind.

Related MCP server: vnsh-mcp

Installation

Einfach dieses Repo klonen — Pshare muss nicht heruntergeladen werden:

git clone https://github.com/ntanhprt/Pshare-mcp.git
cd Pshare-mcp
pnpm install
pnpm build      # biên dịch ra dist/

Konfiguration (Umgebungsvariablen)

localhost ist nur korrekt, wenn der MCP-Server auf genau dem Rechner läuft, auf dem Pshare läuft. localhost zeigt immer auf „den Rechner, auf dem der Prozess läuft" — wenn Sie diesen MCP also auf einem anderen Rechner/Laptop installieren als dem, auf dem Pshare läuft (auch im selben LAN), müssen Sie die IP des Pshare-Rechners angeben. Wenn Pshare beispielsweise auf einem Rechner mit der IP 192.168.3.7 läuft:

PSHARE_BASE_URL=http://192.168.3.7:5173 claude mcp add pshare-share -- node "$(pwd)/dist/index.js"

Behalten Sie den Standardwert localhost nur bei, wenn Sie den MCP (stdio) direkt auf demselben Rechner ausführen, auf dem Pshare läuft.

Eigenständiger Testlauf

# stdio (mặc định)
pnpm start

# HTTP/SSE — AI ở máy khác trong LAN cũng gọi được
pnpm start:http
# → nghe tại http://<PSHARE_MCP_HOST>:<PSHARE_MCP_PORT>/mcp

Integrationsanleitung für andere Entwickler

1. Verwendung mit Claude Code (stdio-Transport — empfohlen, wenn die KI auf demselben Rechner/Host wie Pshare läuft)

Nach dem Klonen + Build (siehe Abschnitt Installation oben), aus dem Verzeichnis Pshare-mcp heraus:

claude mcp add pshare-share -- node "$(pwd)/dist/index.js"

Um auf Pshare auf einem anderen Rechner zu verweisen, übergeben Sie die Umgebungsvariable mit -e (siehe Hinweis zu localhost im Abschnitt Konfiguration):

claude mcp add pshare-share \
  -e PSHARE_BASE_URL=http://192.168.3.7:5173 \
  -- node "$(pwd)/dist/index.js"

Prüfen, ob die Registrierung erfolgreich war:

claude mcp list

2. Verwendung mit Claude Desktop (stdio-Transport)

Öffnen Sie die Konfigurationsdatei (~/Library/Application Support/Claude/claude_desktop_config.json unter macOS, %APPDATA%\Claude\claude_desktop_config.json unter Windows) und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "pshare-share": {
      "command": "node",
      "args": ["/đường/dẫn/tuyệt/đối/tới/Pshare-mcp/dist/index.js"],
      "env": {
        "PSHARE_BASE_URL": "http://localhost:5173"
      }
    }
  }
}

Starten Sie Claude Desktop neu, um das Tool pshare_upload zu erhalten.

3. Verwendung über HTTP/SSE (wenn die KI auf einem anderen Rechner im selben LAN läuft)

Führen Sie den MCP-Server auf dem Rechner aus, der Pshare hostet (oder auf einem beliebigen Rechner, der Pshare erreichen kann):

PSHARE_BASE_URL=http://localhost:5173 pnpm start:http

Auf dem Client-Rechner (Claude Code oder ein beliebiger MCP-Client mit HTTP-Transport-Unterstützung) zeigen Sie auf:

http://<IP-máy-chạy-mcp>:7317/mcp

Beispiel mit Claude Code:

claude mcp add --transport http pshare-share http://192.168.3.7:7317/mcp

4. Verwendung mit jedem anderen KI-/Agent-Framework

MCP ist ein standardisiertes JSON-RPC-Protokoll — jeder MCP-Client (LangChain MCP-Adapter, benutzerdefinierter Agent usw.) kann sich verbinden, es genügt:

• stdio: Befehl node dist/index.js starten und über stdin/stdout kommunizieren.

• HTTP: POST http://<host>:<port>/mcp gemäß der Streamable-HTTP-Transport-Spezifikation von MCP aufrufen.

Sicherheitshinweis

Dieser MCP-Server führt keine Authentifizierung durch — jeder, der ihn erreichen kann (über stdio, wenn er Prozesse ausführen darf, oder über HTTP, wenn er Zugriff auf host:port hat), kann Dateien auf die echte Pshare-Instanz hochladen/teilen. Dies ist konsistent mit Pshare selbst (keine Auth auf der Upload-/Share-API), sollte aber beachtet werden, wenn der HTTP-Transport über das LAN hinaus geöffnet wird.