govtpress-mcp

A read-only MCP server that retrieves press releases from 12 South Korean government agencies. Implemented with Next.js App Router + mcp-handler and deployed on Vercel.

• Planning: PRD.md · Design/implementation plan: PLAN.md

What this server does

It is an index that finds "which agency announced what and when." It provides title, agency, publication date, and original URL, but does not provide full text or summaries. To check content, follow the original URL in each result.

Target agencies

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

Example

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

Data limitations — what to know before reading

1. No full text or summaries. Don't guess content from the title alone; check the original URL.

2. Search covers titles only. Words not in the title cannot be found.

3. The collection system changed on 2026-04-21. Around that date, the daily collection volume jumps from about 25 to 55 items. This is not a change in government announcement volume but an expansion of collection scope. Time-series comparisons spanning this point are not valid, and press_stats warns about it automatically.

4. Each agency has a different collection start date. Do not compare agencies over periods before 2025-12-19.

5. The responsible department field exists only in data before 2026-07-02 (a field specific to the legacy collection pipeline).

6. Weekend publications are sparse. Saturday averages 1.8 items per day, Sunday 8.4 (weekdays 31~44).

Architecture

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      (구 파이프라인, 이력)

It integrates two generations of collection pipelines into a live VIEW. Using agency + normalized title as the key, duplicates are removed within a ±1 day tolerance of the publication date, and updates from either pipeline are reflected automatically.

Security

Only the anon (publishable) key is used. Since the RLS policies on the target tables and views allow SELECT only, the service_role key is not placed in the deployment environment.

Development

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

Verification

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

It runs initialize → tools/list → calls for 13 tool cases and prints the response line count and approximate token usage. On successful completion, it prints 전 케이스 통과 as the last line.

Interactive inspection is also possible with MCP Inspector.

npx @modelcontextprotocol/inspector

Deployment

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

After deployment, the endpoint is https://<project>.vercel.app/mcp.

Client registration

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

Database objects

Supabase objects this server depends on (created via migration).

Performance note: Because the database collation is en_US.UTF-8, sorting Korean strings is very slow. The view's deduplication key (title_key) is fixed with COLLATE "C" — it is a key dedicated to normalized grouping, so linguistic sort order is unnecessary, and this single line reduces query time from 10.3 seconds to 0.2 seconds. Do not remove this specification. It will immediately hit PostgREST's 3-second statement timeout.