govtpress-mcp

Сервер MCP только для чтения для поиска пресс-релизов 12 государственных ведомств Республики Корея. Реализован на 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: nara-bid-mcp

Инструменты

Пример

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

Ограничения данных — прочтите перед использованием

1. Текста и аннотаций нет. Не стройте догадок только по заголовку — переходите к оригиналу по URL.

2. Поиск идёт только по заголовку. Слова, которых нет в заголовке, найти невозможно.

3. Схема сбора изменилась 2026-04-21. До и после этой даты дневной объём — примерно 25 и 55 записей соответственно. Это не изменение объёма публикаций ведомств, а расширение охвата сбора. Поэтому сравнение временных рядов, пересекающих эту дату, некорректно, и press_stats автоматически выдаст предупреждение.

4. Дата начала сбора у ведомств разная. Сравнивать ведомства между собой на отрезке до 2025-12-19 нельзя.

5. Поле «отдел» есть только в данных до 2026-07-02 (поле только старого конвейера сбора).

6. По выходным публикаций мало. В субботу в среднем 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      (구 파이프라인, 이력)

Объединяет два поколения конвейеров сбора в единое представление (VIEW). Дубликаты устраняются по ключу «ведомство + нормализованный заголовок» с допустимым расхождением даты публикации ±1 день; изменения в любом из конвейеров автоматически отражаются в представлении.

Безопасность

Используется только ключ anon (публикуемый). Политики 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" — это нормализованный ключ группировки, для которого порядок сортировки по языку не нужен; именно эта одна строка сокращает время запроса с 10,3 до 0,2 секунды. Не удаляйте эту строку. Иначе запрос немедленно упрётся в 3-секундный таймаут PostgREST.