Cycleo MCP server

Verteilbarer, schreibgeschützter MCP-Adapter für Cycleo. Der Server stellt eine kleine, auf eine Zulassungsliste beschränkte Tool-Oberfläche bereit und ruft Cycleos versionierte JSON-API mit dem benutzerbezogenen OAuth-Bearer-Token auf.

Dieses Repository enthält nur den MCP-Ressourcenserver. Cycleo bleibt der Autorisierungsserver und Dateneigentümer; die /oauth/*-Integration ist in docs/auth-integration.md dokumentiert und muss vor dem Produktionseinsatz eingerichtet werden.

Lokale Ausführung

cp .env.example .env
npm start

Der lokale Endpunkt ist http://localhost:8787/mcp. Öffnen Sie http://localhost:8787/connect einmal, um sich über Cycleo anzumelden. Der Server speichert nur den OAuth-Token-Satz lokal mit restriktiven Dateiberechtigungen und aktualisiert Zugriffstokens automatisch. Setzen Sie CYCLEO_API_BASE_URL auf eine lokale Cycleo-API, wenn Sie gegen ein lokales Checkout entwickeln.

Related MCP server: sprout-mcp

Produktionsgrenze

Der MCP server empfängt oder speichert niemals Cycleo-Passwörter und verbindet sich niemals mit der Cycleo-Datenbank. Er akzeptiert ein OAuth-Bearer-Token, validiert die Identität über GET /auth/me und leitet nur die auf der Zulassungsliste stehenden Lese-Routen in src/tools.mjs weiter.