mcp-toolbox-plugins

Plugin-Quellen für mcp-toolbox – jedes Plugin wird als eigenes npm-Paket (plugin-<name>) in der Forgejo-Paket-Registry veröffentlicht. Der mcp-toolbox-Server findet die Pakete über die öffentliche Forgejo-API (dist-tags latest/dev) und bietet sie im Marktplatz zum direkten Download an – das Image muss sie nicht mehr enthalten.

Struktur

plugins/<name>/        ein Plugin pro Verzeichnis (package.json = Vertrag, index.js, optional eigene Dateien)
pack.mjs               baut dist/publish/* + dist/<name>-<version>.tgz (npm run pack, npm run pack:dev)
.forgejo/workflows/    Publish-Workflows (stable + dev Kanal via dist-tags)
docs/                  Wissensbasis – Einstieg: docs/README.md (Progressive Disclosure)

Quick Start

npm ci
npm run pack          # → dist/publish/plugin-<name>/ + dist/<name>-<version>.tgz + dist/summary.json
npm run pack:dev      # → Dev-Versionen mit Suffix -dev.<sha>

Veröffentlichung

• Dev: Push auf dev (Änderungen unter plugins/**) → nur geänderte Plugins werden mit Version <version>-dev.<short-sha> publiziert, dist-tag dev zeigt auf den neuesten Stand
• Main: Push auf main (Änderungen unter plugins/**) → alle Plugins mit ihren Versionen, dist-tag latest; es werden nur Versionen erstellt, die noch nicht als Paket existieren
• Die Kanäle bauen unabhängig voneinander; jedes Paket wird mit dem Repository verlinkt
• Auth: Repo-Secret REGISTRY_TOKEN (PAT mit write:package), sonst der Auto-Token

Entdecken der Plugins (öffentliche API)

GET https://git.waggeling.net/api/v1/packages/waggeling.net?type=npm      → alle Pakete
GET https://git.waggeling.net/api/packages/waggeling.net/npm/plugin-hello → Metadaten (dist-tags, dist.tarball)

Installation in mcp-toolbox

MCP_TOOLBOX_STORE_REPOS="https://git.waggeling.net/waggeling.net/mcp-plugins"

mcp-toolbox zeigt die Plugins im Marktplatz und installiert sie direkt aus der Registry.

Dokumentation

docs/ – Index mit Progressive Disclosure: GRUNDLAGEN, PLUGIN-API, RELEASES.

Lizenz

Boost Software License 1.0