us-govdata-mcp

MCP-Server für US-Regierungsdaten — durchsuchen Sie Baugenehmigungen, Bundesvertragsmöglichkeiten (SAM.gov) und das nationale Gesundheitsdienstleisterverzeichnis (NPI/NPPES) von Claude, Cursor oder jedem Model Context Protocol-Client.

Alle drei Datenquellen sind offizielle Regierungsveröffentlichungen (städtische Open-Data-Portale, der öffentliche Auszug von SAM.gov, die CMS NPPES API) — kein HTML-Scraping, keine Anmeldungen, keine fragilen Selektoren. Die schwere Arbeit wird von drei produktiven Apify-Actoren erledigt, die auf Ihrem eigenen Apify-Konto laufen.

Testen Sie es in 30 Sekunden — kein Konto, keine Kosten

Bevor Sie entscheiden, ob dies einen API-Token wert ist, führen Sie es ohne einen aus:

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_DRY_RUN": "1" }
    }
  }
}

Das ist die gesamte Einrichtung. Im Trockenlaufmodus gibt jedes Tool realistische Beispieldatensätze zurück plus die genaue Apify-API-Anfrage, die es gesendet hätte — so können Sie die tatsächliche Form der Daten sehen, bestätigen, dass Ihr Agent die Tools korrekt aufruft, und die Preisangaben in jeder Toolbeschreibung lesen, ohne ein Konto zu erstellen, einen Token einzufügen oder etwas auszugeben.

Fragen Sie Ihren Agenten etwas wie "finde Baugenehmigungen über 500.000 $, die diesen Monat in Austin ausgestellt wurden" und beobachten Sie den Tool-Aufruf von Anfang bis Ende. Wenn Sie Live-Daten wünschen, löschen Sie die Zeile APIFY_DRY_RUN und fügen Sie einen APIFY_TOKEN hinzu (siehe unten).

Related MCP server: DOL WHD MCP

Tools

* Ehrliche Preisangabe: Diese Tools verwenden kostenpflichtige, pro-Ergebnis abgerechnete Apify-Actoren, die von CBLU veröffentlicht werden. Ihr Apify-Konto wird nur für tatsächlich zurückgegebene Datensätze belastet — es gibt keine Abonnements oder Startgebühren. Jedes Tool gibt standardmäßig 25 Ergebnisse pro Aufruf zurück, sodass ein typischer Aufruf einen Bruchteil eines Cents kostet (25 Genehmigungen ≈ $0,13; 25 Vertragsbekanntmachungen ≈ $0,10; 25 Anbieter ≈ $0,05). Der kostenlose Plan von Apify enthält monatliches Plattformguthaben, das ausreicht, um diese Tools gelegentlich kostenlos zu nutzen. Actor-Seiten mit vollständigen Preisdetails:

• US Building Permits Scraper

• SAM.gov Contract Opportunities Scraper

• NPI Registry Scraper

Schnellstart

1. Apify-Token besorgen (kostenlos, ~2 Minuten)

1. Registrieren Sie sich unter https://console.apify.com/sign-up (der kostenlose Plan funktioniert).

2. Kopieren Sie Ihren API-Token von https://console.apify.com/settings/integrations.

Der Server startet und listet seine Tools ohne Token — der Token wird nur benötigt, wenn ein Tool tatsächlich aufgerufen wird.

2. Server zu Ihrem MCP-Client hinzufügen

Claude Desktop (claude_desktop_config.json → Einstellungen → Entwickler → Konfiguration bearbeiten):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": {
        "APIFY_TOKEN": "your_apify_token_here"
      }
    }
  }
}

Claude Code:

claude mcp add us-govdata -e APIFY_TOKEN=your_apify_token_here -- npx -y github:CBLU2005/us-govdata-mcp

Cursor / Windsurf / andere MCP-Clients (gleiche Struktur wie Claude Desktop):

{
  "mcpServers": {
    "us-govdata": {
      "command": "npx",
      "args": ["-y", "github:CBLU2005/us-govdata-mcp"],
      "env": { "APIFY_TOKEN": "your_apify_token_here" }
    }
  }
}

Aus einem lokalen Klon:

git clone https://github.com/CBLU2005/us-govdata-mcp.git
cd us-govdata-mcp
npm install && npm run build
# then point your client at: node /path/to/us-govdata-mcp/dist/index.js

Docker:

docker build -t us-govdata-mcp .
docker run -i --rm -e APIFY_TOKEN=your_apify_token_here us-govdata-mcp        # stdio
docker run --rm -p 3000:3000 -e APIFY_TOKEN=... us-govdata-mcp --http 3000    # Streamable HTTP

3. Fragen Sie Ihren KI-Agenten Dinge wie

• "Finde Baugenehmigungen für Neubauten über 500.000 $, die diesen Monat in Austin ausgestellt wurden, mit Auftragnehmernamen."

• "Gibt es aktuelle Ausschreibungen für Cybersicherheit mit Kleinunternehmensvorbehalt, deren Antwortfrist nach heute liegt? Inklusive E-Mail des Vertragsbeauftragten."

• "Liste Zahnärzte im Großraum Miami (PLZ 331) mit ihren Praxis-Telefonnummern auf."*

Transporte

• stdio (Standard) — was Desktop-MCP-Clients verwenden: us-govdata-mcp

• Streamable HTTP — zustandsloser Endpunkt unter POST /mcp, Gesundheitscheck unter GET /healthz: us-govdata-mcp --http 3000 (oder setzen Sie MCP_HTTP_PORT=3000)

Umgebungsvariablen

So funktioniert es

Jedes Tool validiert seine Argumente (zod), erstellt die Actor-Eingabe und ruft den Endpunkt run-sync-get-dataset-items der Apify-API mit Ihrem Token über einen Authorization: Bearer-Header auf (niemals in der URL). Der Actor läuft auf der Apify-Plattform unter Ihrem Konto und die resultierenden Datensätze werden direkt als Tool-Ergebnis zurückgegeben. Dieser Server speichert keinen Zustand und sieht keine Daten außer der Durchleitung.

Entwicklung

npm install
npm test          # builds + runs the full smoke suite (introspection, tokenless
                  # error path, dry-run request construction, HTTP transport)

Die Testsuite benötigt kein Apify-Konto und kein Netzwerk — sie verwendet APIFY_DRY_RUN=1.

Verwandte Themen

• Apify Store-Profil mit allen CBLU-Actoren: https://apify.com/cblu

• Model Context Protocol: https://modelcontextprotocol.io

Lizenz

MIT © CBLU