picgo-mcp

Schnellstart: Senden Sie den folgenden Prompt an Ihren Coding Agent: 请从 https://github.com/timerring/PicGo-MCP 安装并配置 PicGo MCP Server。

Ein MCP-stdio-Server, der PicGo Core direkt in den Prozess einbettet. Er ermöglicht es MCP-Clients wie Codex und Claude Desktop, vorhandene PicGo-Bildhost-Konfigurationen wiederzuverwenden – ohne dass die PicGo-Desktop-Anwendung ausgeführt werden muss und ohne Umweg über 127.0.0.1:36677.

Funktionsumfang

• Direkter Aufruf von PicGo Core 3, keine Abhängigkeit vom Desktop-Client.

• Unterstützt lokale Dateien, file://-URLs und HTTP(S)-Bild-URLs.

• Unterstützt Einzelbild- und Stapel-Uploads mit bis zu 20 Bildern.

• Automatische Erkennung von PicGo-Desktop-, PicGo-Core- und CLI-Konfigurationen.

• Unterstützt benutzerdefinierte Upload-Dateinamen und Rückgabeformate.

• Gleichzeitige Aufrufe werden automatisch in eine Warteschlange gestellt, um die variablen PicGo-Upload-Zustände nicht gegenseitig zu verunreinigen.

• Statustools geben keine Konfigurationswerte wie Token oder Geheimnisse zurück und zeigen das Benutzerverzeichnis als ~ an.

Related MCP server: flin-imgbb-mcp

Umgebungsanforderungen

• Node.js >=20.19.0

• Eine funktionierende PicGo-Konfigurationsdatei

Installation

Installation aus dem Quellcode:

npm install
npm run build
npm install -g .

Stellen Sie sicher, dass der Befehl verfügbar ist:

picgo-mcp --help

Installation in Codex

codex mcp add picgo -- picgo-mcp
codex mcp get picgo

Nachhinzufügen des MCP-Servers eine neue Aufgabe starten oder den Client aktualisieren, damit die Werkzeugliste neu geladen wird.

Andere MCP-Clients

Nach der globalen Installation kann die folgende stdio-Konfiguration verwendet werden:

{
  "mcpServers": {
    "picgo": {
      "command": "picgo-mcp"
    }
  }
}

Wenn eine Konfigurationsdatei explizit angegeben werden muss:

{
  "mcpServers": {
    "picgo": {
      "command": "picgo-mcp",
      "args": ["--config", "/path/to/picgo/config.json"]
    }
  }
}

Sie können auch die Umgebungsvariable PICGO_CONFIG_PATHsetzen. --config hat dabei Priorität gegenüber der Umgebungsvariable und der automatischen Erkennung.

PicGo-Konfiguration

Standardmäßig wird in folgender Reihenfolge gesucht:

• macOS: ~/Library/Application Support/picgo/data.json

• Windows: %APPDATA%/picgo/data.json

• Linux: $XDG_CONFIG_HOME/picgo/data.json oder ~/.config/picgo/data.json

• Alle Plattformen: ~/.picgo/config.json

Beispiel für einen GitHub-Bildhost (GitHub)

Das folgende Beispiel lädt Bilder in das Verzeichnis images/ des Repositorys hoch und liefert über js Delibr – also über jsDelivr – die CDN-Adresse zurück:

{
  "picBed": {
    "uploader": "github",
    "current": "github",
    "github": {
      "repo": "OWNER/REPOSITORY",
      "branch": "main",
      "path": "images/",
      "customUrl": "https://cdn.jsdelivr.net/gh/OWNER/REPOSITORY@main",
      "token": "YOUR_GITHUB_TOKEN"
    }
  },
  "picgoPlugins": {},
  "settings": {
    "picgoMcp": {
      "uploadNameTemplate": "${dateTime}-${fileName}${extName}",
      "outputFormat": "${url}"
    }
  }
}

Der GitHub-Token benötigt Schreibrechte für das Zielrepo.Repository. Übergeben Sie den Token nicht mit Git, in Issues, Protokolle oder Chats bezeichnet und beschränken Sie die Berechtigungen der Konfigurationsdatei auf den aktuellen Benutzer:

chmod 600 ~/.picgo/config.json

PicGo Core 3 kann beim ersten Lesen von älteren Konfigurationen die uploader-Konfiguration und interne Winkeldaten ergänzen – das ist eine normale automatische Migration.

Dateinamenvorlage

Konfigurationsort:

{
  "settings": {
    "picgoMcp": {
      "uploadNameTemplate": "${dateTime}-${fileName}${extName}"
    }
  }
}

Unterstützte Variablen:

Empfohlen:

${dateTime}-${fileName}${extName}

Die Verwendung nur mit ${dateTime}${extName} kann bei Bildern, die innerhalb derselben Sekunde hochgeladen werden, zu Namenskonflikten führen. Die Vorlage führt nur Whitelist-Platzhalterersetzungen aus, kein JavaScript, und es ist nicht möglich, zusätzliche Pfade wie ../ über den Dateinamen zu schreiben. Entfernte Verzeichnisse sollten über die path-Konfiguration des Uploaders festgelegt werden.

Ausgabevorlage

Konfigurationsort:

{
  "settings": {
    "picgoMcp": {
      "outputFormat": "${url}"
    }
  }
}

Unterstützte Variablen:

• ${url} – die Bild-URL nach dem Upload.

• ${uploadedName} – der Dateiname nach dem Upload, ohne Erweiterung.

Häufige Formate:

${url}
![${uploadedName}](${url})

Die Tool-Antwort enthält immer Bildinformationen, URL-Array, Markdown und die via Vorlage zusammengestellte formattedOutput, sodass der Aufrufer je nach Bedarf Felder auswählen kann.

MCP-Tools

upload_image

Lädt ein lokales oder entferntes Bild hoch:

{
  "source": "/path/to/image.png"
}

upload_images

Lädt 1–20 Bilder im Massen-Upload hoch:

{
  "sources": [
    "/path/to/first.png",
    "https://example.com/second.jpg"
  ]
}

get_picgo_status

Liefert zurück, ob die Datei vorhanden ist, die PicGo-Version, den aktuellen Uploader, die konfigurierten Feldnamen sowie die verfügbaren Uploader. Dieses Tool gibt sich nicht zu Datumswerten noch Hochladen-Berechtigungen zurück.

Beispiel eines Upload-Ergebnisses

{
  "images": [
    {
      "url": "https://cdn.example.com/images/2026-08-23-17-34-47-example.png",
      "fileName": "2026-08-23-17-34-47-example.png",
      "width": 800,
      "height": 600,
      "size": 123456
    }
  ],
  "urls": [
    "https://cdn.example.com/images/2026-08-23-17-34-47-example.png"
  ],
  "markdown": "![2026-08-23-17-34-47-example.png](https://cdn.example.com/images/2026-08-23-17-34-47-example.png)",
  "formattedOutput": "https://cdn.example.com/images/2026-08-23-17-34-47-example.png"
}

Funktionsmechanismus

MCP-Clients starten in der Regel einen picgo-mcp-stdio-Prozess und verwenden ihn für die Dauer der Client-Sitzung erneut. Nur wenn ein Upload-Tool (Upload-Werkzeug) aufgerufen wird, werden Bilder gelesen und die Bildquelle sowie das Bildhostservice aufgerufen; Danach, wenn der Client die Verbindung oft schließt, beendet sich der Serverprozess und gibt Speicher frei.

PicGo hält einen veränderlichen Ein- und Ausgabezustand; daher dieses Projekt wird gleichzeitige Uploadanfragen seriell aus.

Sicherheitshinweise

• Keine Tokens in Befehlsparametern angeben; Zugangsdaten sollten aus der PicGo-Konfiguration verwaltet werden.

• MCP-Tools geben keine Zugangsdaten weiter; Statustools liefern nur Feldnamen.

• Der Pfpour das Home-Verzeichnis wird in Tool-Antworten als ~ angezeigt.

• HTTP(S)-Bilder werden zuerst von PicGo heruntergeladen und danach in den konfigurierten Bildhost hochgeladen.

• PicGo lädt Plugins gemäß der Konfiguration– laden Sie nur vertrauenswürdige und aktivieren Sie diese.

• Kann den stdio-Server nicht zu nicht vertrauenswürdige Clients bekannt.

Picugo 3.0.1-Abhangigkeitsbaum enthält derzeit noch npm-Sicherheitabschränkungen zu image-size und alten inquirer/tmp. Der te erstere kann bei speziell präparierten Bildern zu Denial-of-Service-Prozessen führen; Letztere liegt im Pfad der PicGo-CLI-Interaktion, die von diesem Projekt nicht aufgerufen wird. Diese Abhängigkeiten müssen durch das PicGo-Upstream aktualisiert werden.

Entwicklung und Verifikation

npm install
npm test
npm run check
npm run build

Die Tests decken derzeit Konfigurationserkennung, Registrierung der MCP-Tools, Statusschwärzung, Upload-Eingabevalidierung, Namevorlagen, Ausgabevorlagen und Datenschutzprüfung für veröffentlichte Dateien ab.

Lizenz

License