BlipBeat MCP-server

Lokal MCP-server (stdio) som låter en AI-klient (Claude Code m.fl.) arbeta mot ditt BlipBeat-konto via det publika API:t (/api/public/v1) — med en vanlig API-nyckel, ingen OAuth eller molntjänst.

Fungerar mot vilken BlipBeat-instans som helst, även self-hostad.

Verktyg

Verktyg	Argument	Kräver scope
`list_monitors`	`status?` (`up`/`down`/`paused`)	read
`get_monitor`	`id` — status, mål, uptime 24 h, snittsvar, öppen incident	read
`list_incidents`	`id`, `limit?` (1–500, default 50)	read
`pause_monitor`	`id` — probarna slutar, inga larm	write
`resume_monitor`	`id` — övervakningen startar igen	write

Paus/återuppta med en read-scope-nyckel ger ett tydligt fel från servern (API:et nekar allt utom GET för read-nycklar).

Köra servern manuellt

MR_API_KEY=mr_... npm run mcp
# eller direkt:
MR_API_KEY=mr_... npx tsx mcp-server.ts

Miljövariabler:

Variabel	Default	Betydelse
`MR_API_KEY`	— (obligatorisk)	API-nyckel, `mr_...` (Konto → API-nyckel)
`MR_API_URL`	`http://localhost:8788/api/public/v1`	Bas-URL till API:t
`MR_TIMEOUT_MS`	`10000`	Timeout per API-anrop

Protokollet är newline-delimited JSON-RPC 2.0 (MCP over stdio) — samma tråd som officiella MCP-servrar; initialize ekar klientens protokollversion.

Registrera hos en MCP-klient

Servern är en vanlig lokal stdio-process — registrera den hos t.ex. Claude Code med claude mcp add:

claude mcp add blipbeat --env MR_API_KEY=mr_... -- npx tsx /sökväg/till/blipbeat-next/mcp-server.ts

Verktygen dyker upp som mcp__blipbeat__list_monitors osv.

Fel som kan dyka upp

Fel	Orsak
`MR_API_KEY saknas` (exit 1)	Nyckeln inte satt i miljön
`Ogiltig eller återkallad API-nyckel`	Fel/tappad nyckel — skapa en ny
`... kräver en nyckel med scope write`	Read-nyckel används för paus/återuppta
`Kunde inte nå BlipBeat-API:t på ...`	Fel `MR_API_URL` eller nere-server; kontrollera `requestId` i API-fel mot serverloggen

Arkitektur (kort)

Claude Code ──stdio/JSON-RPC──▶ mcp-server.ts
                                  ├─ server/mcp/protocol.ts (framing + dispatch, ingen I/O)
                                  ├─ server/mcp/tools.ts    (5 verktyg, textformatering)
                                  └─ server/mcp/client.ts   (fetch mot /api/public/v1)

Noll nya beroenden — protokollet är handrullat, ~200 rader.

← Tillbaka till dokumentationen