avemguvern

avemguvern

Provides read-only access to the current government status of Romania via the get_government_status tool.

Category
Visit Server

README

avemguvern.ro

A one-question site: does Romania currently have a (full, non-interim) government? Current answer: Nu! — Inca e interimar Bolojan!

Everything runs in a single Cloudflare Worker (free tier):

  • Static page — minimalist verdict, served from public/.
  • Public API — GET /api/status (read), POST /api/status (admin, token-protected).
  • Crowd-sourced jokes — POST /api/joke (public, body {"combo":["AUR","UDMR"],"joke":"..."}) lets visitors submit a joke for a party combination; stored but never shown live. Review them with GET /api/jokes (admin token): curl .../api/jokes -H "Authorization: Bearer $ADMIN_TOKEN".
  • MCP server — read-only get_government_status tool at /mcp (Streamable HTTP).

State is one Cloudflare KV key (current). If KV is empty the Worker serves DEFAULT_STATUS from src/index.ts, so it works before seeding.

Project layout

public/index.html   # the page (no build step)
src/index.ts        # Worker: routes /api/status, /mcp, else static assets
wrangler.jsonc      # Worker + assets + KV config
seed.json           # initial KV value

Local development

npm install
npx wrangler dev

Then:

# read
curl http://localhost:8787/api/status

# MCP: list tools
curl -X POST http://localhost:8787/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# MCP: call the tool
curl -X POST http://localhost:8787/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_government_status"}}'

For a local admin token during wrangler dev, create .dev.vars:

ADMIN_TOKEN=some-local-token

Deploy

npm install
npx wrangler login

# 1. Create the KV namespace, then paste the returned id into wrangler.jsonc
npx wrangler kv namespace create GOV_STATUS

# 2. Create the D1 database for joke suggestions, paste its database_id into
#    wrangler.jsonc, then apply the schema to the remote database
npx wrangler d1 create avemguvern-suggestions
npx wrangler d1 execute avemguvern-suggestions --remote --file=./schema.sql

# 3. Set the admin token (used to authorize POST /api/status and GET /api/jokes)
npx wrangler secret put ADMIN_TOKEN

# 4. Deploy
npx wrangler deploy

# 5. (optional) Seed the KV value — default already matches
npm run seed

For local development, apply the schema to the local D1 once:

npx wrangler d1 execute avemguvern-suggestions --local --file=./schema.sql

Custom domain

After the first deploy, attach avemguvern.ro in the Cloudflare dashboard (Workers & Pages → avemguvern-ro → Settings → Domains & Routes), or add to wrangler.jsonc:

"routes": [{ "pattern": "avemguvern.ro", "custom_domain": true }]

(DNS for the domain must be on Cloudflare.)

Updating the status

When the political situation changes, patch the status (only send fields that change):

curl -X POST https://avemguvern.ro/api/status \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"hasGovernment": true, "answer": "Da!", "subtitle": "Avem guvern plin!", "interim": false, "primeMinister": "..."}'

updatedAt is stamped automatically.

Using the MCP server with Claude

Visit https://avemguvern.ro/mcp in a browser for setup instructions, or add it directly:

claude mcp add --transport http avemguvern https://avemguvern.ro/mcp

It exposes one read-only tool, get_government_status, that returns the current answer plus the raw status JSON.

Abuse protection

Built into the Worker:

  • Edge caching — GET /api/status is cached at the Cloudflare edge via the Cache API (caches.default) for CACHE_TTL_SECONDS (default 60), so a read flood hits KV at most ~once/minute per data center. A successful POST purges the cache so updates show immediately. The Cache API is per-colo, so a write purges only the data center that served it; other regions refresh when their TTL expires (hence the modest default — raise it in wrangler.jsonc vars for more offload if you can tolerate longer cross-region staleness after a change).
  • Per-IP rate limiting — native Workers rate-limit bindings: reads 120/min, writes 10/min (the write limit also throttles token guessing). Over-limit → 429.
  • Hardened writes — POST only accepts the known fields (hasGovernment, interim, answer, subtitle, primeMinister) with correct types, clamps strings to 200 chars, rejects bodies over 2 KB (413), and compares the admin token in constant time. A leaked token can't store arbitrary or huge data.

Recommended at the Cloudflare edge (dashboard):

  • WAF Rate Limiting rule (e.g. per-IP threshold on /api/* and /mcp) — this is the layer that drops abusive traffic before it counts against your quota.
  • Bot Fight Mode under Security → Bots.

Note: a zone-level Cache Rule cannot bypass the Worker here — for a Worker-owned route the Worker always executes before the cache is checked (docs). The in-Worker Cache API above is the effective edge-cache mechanism; it saves KV operations but each request still counts as one Worker invocation. To cut invocations themselves, use the WAF rate-limit rule.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured