govtpress-mcp

Ein schreibgeschützter MCP-Server zum Abrufen von Pressemitteilungen von 12 südkoreanischen Regierungsbehörden. Implementiert mit Next.js App Router + mcp-handler und bereitgestellt auf Vercel.

• Planung: PRD.md · Design/Implementierungsplan: PLAN.md

Was dieser Server tut

Ein Index, der zeigt, welche Behörde wann was veröffentlicht hat. Er liefert Titel, Behörde, Veröffentlichungsdatum und Original-URL, jedoch keinen Volltext und keine Zusammenfassung. Für den Inhalt führt die Original-URL jedes Ergebnisses weiter.

Abgedeckte Behörden

ftc Fair Trade Commission · kca Korea Consumer Agency · fsc Financial Services Commission · fss Financial Supervisory Service · moef Ministry of Economy and Finance · msit Ministry of Science and ICT · molit Ministry of Land, Infrastructure and Transport · motie Ministry of Trade, Industry and Energy · mois Ministry of the Interior and Safety · mohw Ministry of Health and Welfare · mss Ministry of SMEs and Startups · mcst Ministry of Culture, Sports and Tourism

Related MCP server: korean-law-mcp

Tools

Beispiel

"최근 3개월 금융위·금감원의 가계부채 관련 발표 찾아줘"   → press_search
"어제 정부 보도자료 브리핑 만들어줘"                      → press_daily_briefing
"올해 부처별 보도자료 발행 추이 비교해줘"                 → press_stats
"데이터 어디까지 수집돼 있어?"                            → press_coverage

Grenzen der Daten — was Sie vor der Nutzung wissen sollten

1. Kein Volltext, keine Zusammenfassung. Erraten Sie den Inhalt nicht anhand des Titels, sondern prüfen Sie die Original-URL.

2. Die Suche umfasst nur Titel. Wörter, die nicht im Titel vorkommen, sind nicht auffindbar.

3. Am 2026-04-21 wurde das Erfassungssystem geändert. Um dieses Datum herum springt die tägliche Erfassungsmenge von ca. 25 auf 55 Einträge. Das ist keine Änderung der Regierungsveröffentlichungen, sondern eine Erweiterung des Erfassungsumfangs. Zeitreihenvergleiche über diesen Zeitpunkt hinweg sind nicht gültig; press_stats warnt automatisch.

4. Jede Behörde hat ein anderes Erfassungsstartdatum. Vergleichen Sie Behörden nicht über Zeiträume vor 2025-12-19.

5. Zuständige Abteilungen gibt es nur in Daten vor 2026-07-02 (Feld nur in der alten Erfassungspipeline).

6. Wochenendveröffentlichungen sind selten. Samstag im Schnitt 1,8 Einträge, Sonntag 8,4 (Wochentage 31~44).

Architektur

MCP 클라이언트 ──Streamable HTTP──> Vercel Function (Fluid Compute, icn1)
                                     app/[transport]/route.ts
                                     └ mcp-handler (stateless, Redis 불필요)
                                          │ supabase-js, anon key, 읽기 전용
                                          ▼
                                   Supabase Postgres
                                   └ VIEW press_releases_unified
                                        ├ govt_press_releases (현행 파이프라인)
                                        └ press_releases      (구 파이프라인, 이력)

Integriert zwei Generationen von Erfassungspipelines in einer Live-VIEW. Duplikate werden anhand von Behörde + normalisiertem Titel mit einer Toleranz von ±1 Tag um das Veröffentlichungsdatum entfernt; Aktualisierungen beider Pipelines werden automatisch übernommen.

Sicherheit

Es wird nur der anon-Schlüssel (publishable) verwendet. Da die RLS-Richtlinien der Zieltabellen und -Views nur SELECT erlauben, wird der service_role-Schlüssel nicht in der Deployment-Umgebung hinterlegt.

Entwicklung

npm install
cp .env.example .env.local   # SUPABASE_URL / SUPABASE_ANON_KEY 채우기
npm run dev                  # http://localhost:3000/mcp

Verifizierung

node scripts/smoke.mjs http://localhost:3000/mcp

Führt initialize → tools/list → Aufrufe von 13 Tool-Fällen aus und gibt die Anzahl der Antwortzeilen sowie die ungefähre Tokenmenge aus. Bei erfolgreichem Abschluss wird 전 케이스 통과 in der letzten Zeile ausgegeben.

Interaktive Prüfung ist auch mit dem MCP Inspector möglich.

npx @modelcontextprotocol/inspector

Deployment

vercel link
vercel env add SUPABASE_URL production
vercel env add SUPABASE_ANON_KEY production
vercel --prod

Nach dem Deployment lautet der Endpunkt https://<project>.vercel.app/mcp.

Client-Registrierung

claude mcp add --transport http govtpress https://<project>.vercel.app/mcp

Datenbankobjekte

Supabase-Objekte, von denen dieser Server abhängt (per Migration erstellt).

Leistungshinweis: Da die Datenbank-Collation en_US.UTF-8 ist, ist die Sortierung koreanischer Zeichenketten sehr langsam. Der Deduplizierungsschlüssel der View (title_key) ist auf COLLATE "C" festgelegt — als Schlüssel für normalisiertes Gruppieren ist keine sprachliche Sortierreihenfolge nötig, und diese eine Zeile reduziert die Abfragezeit von 10,3 s auf 0,2 s. Entfernen Sie diese Festlegung nicht. Sonst greift sofort das 3-Sekunden-Statement-Timeout von PostgREST.