govtpress-mcp

韓国12の政府機関のプレスリリースを照会する読み取り専用MCPサーバーです。 Next.js App Router + mcp-handler で実装し、Vercelにデプロイします。

• 企画: PRD.md · 設計/実装計画: PLAN.md

このサーバーが行うこと

「どの機関がいつ何を発表したか」を探すインデックスです。 タイトル・機関・発行日・原文URLを提供し、本文と要約は提供しません。 内容の確認は各結果の原文URLへつながります。

対象機関

ftc 公正取引委員会 · kca 韓国消費者院 · fsc 金融委員会 · fss 金融監督院 · moef 企画財政部 · msit 科学技術情報通信部 · molit 国土交通部 · motie 産業通商資源部 · mois 行政安全部 · mohw 保健福祉部 · mss 中小ベンチャー企業部 · mcst 文化体育観光部

Related MCP server: korean-law-mcp

ツール

例

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

データの制約 — 読む前に知っておくべきこと

1. 本文・要約はありません。 タイトルだけで内容を推測せず、原文URLを確認してください。

2. 検索はタイトルのみ対象です。 タイトルにない単語では見つけられません。

3. 2026-04-21に収集体制が変わりました。 この日の前後で1日の収集量が約25件 → 55件に 跳ね上がります。政府の発表量の変化ではなく、収集範囲の拡大です。この時点をまたぐ時系列比較は 有効ではなく、press_stats が自動的に警告します。

4. 機関ごとに収集開始日が異なります。 2025-12-19より前の期間で機関間比較をしてはいけません。

5. 担当部署は2026-07-02以前の資料にのみあります（旧収集パイプライン専用フィールド）。

6. 週末の発表は稀です。 土曜日は1日平均1.8件、日曜日は8.4件（平日31~44件）。

アーキテクチャ

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

2世代の収集パイプラインをライブVIEWで統合します。機関 + 正規化タイトルをキーに、発行日 ±1日の許容範囲で重複を除去し、どちらのパイプラインが更新されても自動反映されます。

セキュリティ

anon（publishable）キーのみを使用します。対象テーブルとビューのRLSポリシーがSELECTのみ許可するため、 service_roleキーをデプロイ環境に置きません。

開発

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

検証

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

initialize → tools/list → ツール13ケースの呼び出しを実行し、応答の行数とおおよそのトークン量を出力します。 正常終了時は전 케이스 통과を最後の行に出力します。

MCP Inspectorでの対話的な確認も可能です。

npx @modelcontextprotocol/inspector

デプロイ

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

デプロイ後のエンドポイントはhttps://<project>.vercel.app/mcpです。

クライアント登録

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

データベースオブジェクト

このサーバーが依存するSupabaseオブジェクトです（マイグレーションで作成）。

性能メモ: データベースのcollationがen_US.UTF-8のため、韓国語文字列のソートが非常に遅くなります。 ビューの重複除去キー（title_key）はCOLLATE "C"に固定されています — 正規化されたグルーピング 専用キーなので言語的なソート順は不要で、この1行が照会時間を10.3秒から0.2秒に短縮します。 この指定を削除しないでください。 PostgRESTの3秒statement timeoutに即座に掛かります。