Skip to main content
Glama
Youth Policy Navigator

Youth Policy Navigator

by todayoneul

๐Ÿงญ Youth Policy Navigator

์ฒญ๋…„ ์ •์ฑ… ๊ฒ€์ƒ‰ยท์ž๊ฒฉ ํŒ์ •์„ ์œ„ํ•œ MCP Server

Search โ†’ Eligibility Check โ†’ Missing Info โ†’ Memory โ†’ Re-evaluation

Python MCP SQLite Docker Tests

Kakao PlayMCP ๊ณต๋ชจ์ „ ํ”„๋กœ์ ํŠธ

์ฒญ๋…„ ์ •์ฑ…ยท์ง€์›๊ธˆ์„ ๋‹จ์ˆœ ๊ฒ€์ƒ‰ํ•˜๋Š” ๋ฐ์„œ ๋๋‚˜์ง€ ์•Š๊ณ , ์‚ฌ์šฉ์ž์˜ ์ƒํ™ฉ๊ณผ ์ •์ฑ… ์กฐ๊ฑด์„ ๋น„๊ตํ•ด ์ ๊ฒฉ / ๋ถ€์ ๊ฒฉ / ์ •๋ณด๋ถ€์กฑ์„ ์ด์œ ์™€ ํ•จ๊ป˜ ํŒ์ •ํ•˜๋Š” MCP ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

Why this project?

Feature

What it does

๐Ÿ”Ž Hybrid Search

์˜จํ†ต์ฒญ๋…„ API + ๋‚ด์žฅ corpus๋ฅผ Contextual BM25๋กœ ๊ฒ€์ƒ‰

โœ… Deterministic Eligibility

๋‚˜์ดยท์ง€์—ญยท์†Œ๋“ยท์ทจ์—… ์ƒํƒœ๋ฅผ ๊ตฌ์กฐํ™” ์กฐ๊ฑด์œผ๋กœ ํŒ์ •

โ“ Missing-info Loop

์ •๋ณด๊ฐ€ ๋ถ€์กฑํ•˜๋ฉด ๋‹ค์Œ ์งˆ๋ฌธ์„ ๋งŒ๋“ค์–ด host LLM์ด ๋˜๋ฌป๊ฒŒ ํ•จ

๐Ÿง  User Memory

SQLite์— ์‚ฌ์šฉ์ž ์ƒํ™ฉ์„ ์ €์žฅํ•˜๊ณ  ํ•„์š”ํ•œ ์ •๋ณด๋ฅผ ํšŒ์ƒ

๐Ÿงฉ MCP Tools

์ž์—ฐ์–ด ์ƒ์„ฑ์€ host LLM, ๋ฐ์ดํ„ฐยทํŒ์ •์€ server๊ฐ€ ๋‹ด๋‹น

Related MCP server: gov-support-mcp

Agent Loop

flowchart LR
    U[User Query] --> S[Policy Search]
    S --> E[Eligibility Check]
    E -->|Enough info| R[Reasoned Result]
    E -->|Missing info| Q[Follow-up Question]
    Q --> M[Remember Profile]
    M --> E

์„œ๋ฒ„๊ฐ€ โ€œ๋‹ต๋ณ€ ๋ฌธ์žฅโ€์„ ๋งˆ์Œ๋Œ€๋กœ ์ƒ์„ฑํ•˜์ง€ ์•Š๊ณ , ๊ทผ๊ฑฐ ๋ฐ์ดํ„ฐ์™€ ๊ฒฐ์ •๋ก ์  ํŒ์ • ๊ฒฐ๊ณผ๋ฅผ ์ œ๊ณตํ•˜๋„๋ก ์—ญํ• ์„ ๋ถ„๋ฆฌํ•œ ๊ฒƒ์ด ํ•ต์‹ฌ์ž…๋‹ˆ๋‹ค.

MCP Tools

Tool

Role

search_youth_policies

์ •์ฑ… ๊ฒ€์ƒ‰

check_eligibility

์‚ฌ์šฉ์ž ์กฐ๊ฑด ๊ธฐ๋ฐ˜ ์ž๊ฒฉ ํŒ์ •

get_policy_detail

์‹ ์ฒญ ๋ฐฉ๋ฒ•ยท๊ธฐ๊ฐ„ยท์„œ๋ฅ˜ยทURL

remember_user_profile

์‚ฌ์šฉ์ž ์ƒํ™ฉ ์ €์žฅ

recall_user_profile

๊ด€๋ จ ์‚ฌ์šฉ์ž ์ •๋ณด ํšŒ์ƒ

Example

  1. โ€œ์›”์„ธ ์ง€์› ์ •์ฑ… ์ฐพ์•„์ค˜โ€ โ†’ ๊ด€๋ จ ์ •์ฑ… ๊ฒ€์ƒ‰

  2. ์ž๊ฒฉ ํŒ์ •์— ์†Œ๋“ ์ •๋ณด๊ฐ€ ๋ถ€์กฑํ•จ โ†’ needs_more_info

  3. host LLM์ด ์†Œ๋“ ์ •๋ณด๋ฅผ ์งˆ๋ฌธ

  4. ๋‹ต๋ณ€์„ memory์— ์ €์žฅ

  5. ๋™์ผ ์ •์ฑ…์„ ๋‹ค์‹œ ํŒ์ • โ†’ eligible / ineligible / manual_review

Quick Start

uv sync --extra dev
uv run pytest -q

# local stdio
uv run policy-mcp

# remote HTTP
MCP_TRANSPORT=http uv run policy-mcp

Docker:

docker build --platform linux/amd64 -t policy-mcp .

API key๊ฐ€ ์—†์–ด๋„ ๋‚ด์žฅ corpus ๊ธฐ๋ฐ˜ mock์œผ๋กœ ๋™์ž‘ํ•ฉ๋‹ˆ๋‹ค.

.env์— ๋ฐœ๊ธ‰๋ฐ›์€ ์ •์ฑ… API ํ‚ค๋ฅผ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค.

YOUTHCENTER_API_KEY_POLICY=your_api_key

2026-07 ๊ธฐ์ค€ ์‹ ๊ทœ API ๊ทœ๊ฒฉ์„ ์‹ค์ œ ๋ฐœ๊ธ‰ํ‚ค๋กœ ๊ฒ€์ฆํ–ˆ์Šต๋‹ˆ๋‹ค. ์ •์ฑ… ์กฐ๊ฑด์€ ๊ณต๊ณ ์— ๋”ฐ๋ผ ๋ณ€๋™๋  ์ˆ˜ ์žˆ์œผ๋ฏ€๋กœ ์ตœ์ข… ์‹ ์ฒญ ์ „ ์›๋ฌธ ๊ณต๊ณ  ํ™•์ธ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

Project Structure

src/policy_mcp/
โ”œโ”€โ”€ server.py          # FastMCP server / tools
โ”œโ”€โ”€ policies.py        # search service
โ”œโ”€โ”€ eligibility.py     # deterministic eligibility engine
โ”œโ”€โ”€ policy_corpus.py   # built-in policy corpus
โ”œโ”€โ”€ memory.py          # SQLite + BM25 memory
โ”œโ”€โ”€ retrieval.py       # Contextual BM25
โ””โ”€โ”€ clients/           # Youth Center API client

tests/                 # 48 offline tests

Design Principle

LLM์€ ํ•ด์„๊ณผ ๋Œ€ํ™”๋ฅผ ๋‹ด๋‹นํ•˜๊ณ , eligibility decision์€ ์žฌํ˜„ ๊ฐ€๋Šฅํ•œ ์ฝ”๋“œ๊ฐ€ ๋‹ด๋‹นํ•œ๋‹ค.

์ด ๊ตฌ์กฐ๋ฅผ ํ†ตํ•ด ์ •์ฑ… ๊ฒ€์ƒ‰ ๊ฒฐ๊ณผ๊ฐ€ ๋ฐ”๋€Œ๋”๋ผ๋„ ์ž๊ฒฉ ํŒ์ • ๊ณผ์ •๊ณผ ๊ทผ๊ฑฐ๋ฅผ ์ถ”์ ํ•˜๊ธฐ ์‰ฝ๊ฒŒ ๋งŒ๋“ค์—ˆ์Šต๋‹ˆ๋‹ค.

Available Tools

6 tools
check_eligibilityCheck policy eligibilityA
Read-onlyIdempotent

Youth Policy Navigator(์ฒญ๋…„ ์ •์ฑ… ๋‚ด๋น„๊ฒŒ์ดํ„ฐ): the KILLER feature โ€” deterministically judge whether a user is eligible for a specific policy (by policy_id). Provide the user's situation either inline via profile (age, region, annual_income, income_band, employment_status, education, marital_status โ€” all optional) or via user_key to restore a remembered profile. Returns a verdict (eligible / ineligible / needs_more_info / manual_review) with per-condition checks, fail reasons, and โ€” crucially โ€” missing_info questions to ASK the user next when data is insufficient. Use those questions to drive a follow-up loop: ask, save with remember_user_profile, then re-run this. Free-text conditions are returned as manual for you to confirm against the notice.

Inputs: policy_id (required), profile, user_key. Returns: object

find_youth_centersFind youth centersA
Read-onlyIdempotent

Youth Policy Navigator(์ฒญ๋…„ ์ •์ฑ… ๋‚ด๋น„๊ฒŒ์ดํ„ฐ): find nearby Korean youth centers (์ฒญ๋…„์„ผํ„ฐ/์ฒญ๋…„๊ณต๊ฐ„) for offline, in-person help โ€” connecting a user to a local place where staff can walk them through applications and documents AFTER policies are matched. Filter by region (์‹œ๋„/์‹œ๊ตฐ๊ตฌ name, e.g. '์„œ์šธ', '๊ฒฝ๊ธฐ ์ˆ˜์›') and/or a free-text keyword (center name or area). Returns each center's name, address, phone, homepage URL, and ์‹œ๋„/์‹œ๊ตฐ๊ตฌ. Backed by the ์˜จํ†ต์ฒญ๋…„ (Youth Center) getSpace open API (about 678 centers nationwide) when a key is configured; region and keyword filtering are applied client-side. Call this once the user wants face-to-face guidance or asks where they can get help near them.

Inputs: limit, region, keyword. Returns: object

get_policy_detailGet policy detailA
Read-onlyIdempotent

Youth Policy Navigator(์ฒญ๋…„ ์ •์ฑ… ๋‚ด๋น„๊ฒŒ์ดํ„ฐ): return full application details for a specific policy (by policy_id) โ€” support content, application period, how to apply, required documents, official apply URL, supervising agency, and an eligibility summary with source and as-of date. Call this after the user picks a policy from search_youth_policies and wants to know how and when to apply, or what documents are needed.

Inputs: policy_id (required). Returns: object

recall_user_profileRecall user profileA
Read-onlyIdempotent

Youth Policy Navigator(์ฒญ๋…„ ์ •์ฑ… ๋‚ด๋น„๊ฒŒ์ดํ„ฐ): recall a user's previously saved situation/preferences relevant to a query, via contextual retrieval. Pass the same user_key used when saving. Call this before recommending policies or judging eligibility to personalize; an empty query returns the most recent notes.

Inputs: user_key (required), k, query. Returns: object

remember_user_profileRemember user profileA

Youth Policy Navigator(์ฒญ๋…„ ์ •์ฑ… ๋‚ด๋น„๊ฒŒ์ดํ„ฐ): remember a user's situation or preference for later personalization and eligibility judging (e.g. '๋‚˜์ด 27', '์„œ์šธ ๊ฑฐ์ฃผ', '์—ฐ์†Œ๋“ 2800๋งŒ์›', '๊ตฌ์ง ์ค‘', '๋Œ€ํ•™ ์กธ์—…'). Pass a stable per-user identifier as user_key that YOU control, and a short note. Call this whenever the user reveals a durable fact about their age, region, income, employment or education, so a later check_eligibility can restore and use it.

Inputs: note (required), user_key (required). Returns: object

search_youth_policiesSearch youth policiesA
Read-onlyIdempotent

Youth Policy Navigator(์ฒญ๋…„ ์ •์ฑ… ๋‚ด๋น„๊ฒŒ์ดํ„ฐ): search Korean youth policies and subsidies (housing rent support, asset-building savings, job-seeker allowances, transit discounts, housing subscription accounts, etc.) by free-text query, optional region and category. Fuses a curated built-in corpus of representative 2026 policies with the ์˜จํ†ต์ฒญ๋…„ (Youth Center) open API when a key is configured. Call this when the user asks what youth policies or support money they could get, or searches by topic (e.g. '์›”์„ธ ์ง€์›', '์ทจ์—… ์ˆ˜๋‹น', '๋ชฉ๋ˆ ๋งˆ๋ จ'). Each result includes a summary and STRUCTURED eligibility criteria; then call check_eligibility with a policy_id to judge whether the user actually qualifies.

Inputs: query (required), k, region, category. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelogโ€ฆ

    TDQS

    A4.3/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: searching policies, checking eligibility, retrieving details, managing user profiles, and finding centers. No overlapping functions; agents can easily differentiate.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., check_eligibility, search_youth_policies, remember_user_profile). No mixing of conventions.

    Tool Count5/5

    With 6 tools, the server captures the essential workflow for youth policy navigation: search, detailed view, eligibility check, user context management, and offline center lookup. Well-scoped without bloat.

    Completeness4/5

    Core operations are covered: search, detail, eligibility, profile persistence, and location guidance. A minor gap is the absence of a tool to list all policies or update user profiles, but the current set handles typical user journeys effectively.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that gives AI agents the ability to discover, match with, and build relationships with other autonomous agents. Supports agent registration, matchmaking, messaging, shared goals, relationship lifecycle management, and real-time event subscriptions.
      55 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that automates the entire process of discovering, evaluating, and applying for government support programs in South Korea using natural language. It integrates multiple public APIs to provide eligibility checks, document preparation, application timelines, and benefit management tools.
      12
      41
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that enables LLMs to search and retrieve Japanese government subsidy and grant information via natural language, wrapping the Jใ‚ฐใƒฉใƒณใƒ„ public API.
      MIT