Bergbahn-Info – Demo-MCP-Server

Lernprojekt: ein eigener MCP-Server (Model Context Protocol) auf Cloudflare Workers, eingebunden als Plugin bzw. Connector in Claude und ChatGPT.

• Bahnen, Lifte, Pisten, Schneebericht: erfundenes Skigebiet «Eigerblick» mit zwei Gebieten (sonnenhang, gletscherblick), Testdaten in src/daten.json.

• Zugverbindungen: echte Fahrplandaten über transport.opendata.ch.

Inoffizielles Demoprojekt, keine Verbindung zu einer echten Bergbahn.

Tools

Alle Tools lesen nur (readOnlyHint).

Related MCP server: SnowSure

Lokal

npm install
npm test           # Tests
npm run dev        # Worker lokal: http://localhost:8787/mcp
npx @modelcontextprotocol/inspector   # zum Ausprobieren im Browser

Veröffentlichen (Cloudflare Workers)

Jeder Push nach main testet und veröffentlicht den Worker automatisch (.github/workflows/deploy.yml). Einmalig nötig:

1. Cloudflare-Konto (Gratis-Plan genügt). Die Account-ID steht in wrangler.toml (kein Geheimnis).

2. API-Token erstellen: My Profile → API Tokens → Vorlage «Edit Cloudflare Workers».

3. Im GitHub-Repo unter Settings → Secrets and variables → Actions das Secret CLOUDFLARE_API_TOKEN anlegen.

Danach ist der Server unter https://bergbahn-mcp.stefan-eicher.workers.dev/mcp erreichbar.

Einbinden

Claude.ai / Claude Desktop: Einstellungen → Connectors → «Custom Connector» → URL https://bergbahn-mcp.stefan-eicher.workers.dev/mcp.

ChatGPT: Developer Mode einschalten, dann App/Connector mit derselben URL anlegen.

Claude Code als Plugin:

/plugin marketplace add stefaneicher/bergbahn-mcp
/plugin install bergbahn-info@bergbahn

Öffentliches Verzeichnis

Angaben für die Einreichung bei Anthropic und OpenAI: docs/einreichung.md. Datenschutz: https://bergbahn-mcp.stefan-eicher.workers.dev/privacy, Nutzungsbedingungen: https://bergbahn-mcp.stefan-eicher.workers.dev/terms.

Aufbau

src/index.ts      Worker: Endpunkt /mcp (Streamable HTTP, zustandslos)
src/tools.ts      die fünf Tools
src/seiten.ts     Startseite, Datenschutz, Nutzungsbedingungen, Icon
src/daten.json    Testdaten
test/             Tests (Vitest)
assets/           Icon (SVG, PNG)
docs/             Einreichung Verzeichnisse
wrangler.toml     Cloudflare-Konfiguration
.claude-plugin/   Plugin und Marketplace für Claude Code
.mcp.json         MCP-Konfiguration des Plugins (URL des Workers)