govtpress-mcp

Servidor MCP de solo lectura para consultar los comunicados de prensa de 12 organismos gubernamentales de Corea del Sur. Implementado con Next.js App Router + mcp-handler y desplegado en Vercel.

• Planificación: PRD.md · Plan de diseño/implementación: PLAN.md

Qué hace este servidor

Es un índice que permite encontrar «qué organismo anunció qué y cuándo». Proporciona título, organismo, fecha de publicación y URL del original; no proporciona el texto completo ni resúmenes. Para ver el contenido, siga la URL del original de cada resultado.

Organismos incluidos

ftc Comisión de Comercio Justo · kca Agencia de Consumidores de Corea · fsc Comisión de Servicios Financieros · fss Servicio de Supervisión Financiera · moef Ministerio de Estrategia y Finanzas · msit Ministerio de Ciencia y TIC · molit Ministerio de Territorio, Infraestructura y Transporte · motie Ministerio de Comercio, Industria y Energía · mois Ministerio del Interior y Seguridad · mohw Ministerio de Salud y Bienestar · mss Ministerio de PYMES y Startups · mcst Ministerio de Cultura, Deportes y Turismo

Related MCP server: nara-bid-mcp

Herramientas

Ejemplo

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

Limitaciones de los datos: lo que debe saber antes de leer

1. No hay texto completo ni resúmenes. No deduzca el contenido solo por el título; consulte la URL del original.

2. La búsqueda solo cubre el título. No se pueden encontrar palabras que no aparezcan en el título.

3. El sistema de recopilación cambió el 2026-04-21. Alrededor de esa fecha, el volumen diario recopilado pasó de unas 25 a 55 publicaciones. No se trata de un cambio en el volumen de anuncios del Gobierno, sino de una ampliación del alcance de la recopilación. Las comparaciones de series temporales que crucen ese punto no son válidas, y press_stats lo advierte automáticamente.

4. La fecha de inicio de recopilación difiere según el organismo. No compare organismos entre sí en el período anterior a 2025-12-19.

5. El departamento responsable solo existe en los datos anteriores al 2026-07-02 (campo exclusivo del antiguo pipeline de recopilación).

6. Las publicaciones de fin de semana son escasas. El sábado promedian 1,8 al día y el domingo 8,4 (entre 31 y 44 en días laborables).

Arquitectura

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

Integra dos generaciones de pipelines de recopilación en una VISTA en vivo. Elimina duplicados usando organismo + título normalizado como clave, con una tolerancia de ±1 día en la fecha de publicación, y se actualiza automáticamente cuando cualquiera de los dos pipelines se actualiza.

Seguridad

Solo se utiliza la clave anon (publicable). Como las políticas RLS de las tablas y vistas de destino solo permiten SELECT, no se coloca la clave service_role en el entorno de despliegue.

Desarrollo

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

Verificación

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

Ejecuta initialize → tools/list → llamadas a 13 casos de herramientas y muestra el número de líneas de respuesta y la cantidad aproximada de tokens. Si finaliza correctamente, imprime 전 케이스 통과 en la última línea.

También se puede realizar una comprobación interactiva con MCP Inspector.

npx @modelcontextprotocol/inspector

Despliegue

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

Tras el despliegue, el endpoint es https://<project>.vercel.app/mcp.

Registro del cliente

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

Objetos de base de datos

Objetos de Supabase de los que depende este servidor (creados mediante migraciones).

Nota de rendimiento: como la collation de la base de datos es en_US.UTF-8, la ordenación de cadenas en coreano es muy lenta. La clave de deduplicación de la vista (title_key) está fijada con COLLATE "C" — al ser una clave exclusiva para agrupación normalizada, no necesita orden alfabético lingüístico, y esta sola línea reduce el tiempo de consulta de 10,3 s a 0,2 s. No elimine esta especificación. De lo contrario, se superará inmediatamente el tiempo de espera de 3 s de PostgREST.