Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DAILY_MAXNoMaximum number of figures generated per day across the server (default 300).300
PUBLIC_URLNoPublic URL of the remote server (e.g., https://geo-figure-mcp.onrender.com). Required for remote deployment.
GEO_FIG_OUTNoOutput folder path for generated figures. Optional; defaults to a user-specific directory.
ACCESS_TOKENNoAccess token/password for the remote server. Required for remote mode.
KEEP_MINUTESNoMinutes to keep generated files before deletion (default 60).60

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

지리 시험용 지도·그래프 제작 도구.

[작업 순서 — 반드시 지킨다]

  1. 교사의 말에서 지도·그래프 종류, 지표, 지역, 연도를 읽는다. 모르면 기본값을 채운다.

  2. find_data 로 실제 통계를 찾는다. 한국 시·도·시·군·구 통계는 먼저 list_bundled_data(키 필요 없음)를 보고, 없을 때만 KOSIS(키 필요)를 쓴다. 숫자를 지어내지 않는다. 못 찾으면 [확인 필요]로 알리고 교사에게 숫자를 받는다.

  3. 만들기 전에 반드시 '계획 요약'을 보여 주고 교사의 "예"를 받는다: 지표·단위 / 기준 연도 / 지역과 기호(AE 또는 (가)(마)) / 가공(지수·비율·편차·반올림) / 기호 순서(무작위·북→남·서→동·지정) / 출력(PPTX·HWPX) / 출처 문구

  4. make_figures 로 만들고, 파일 위치(원격이면 내려받기 주소)와 정답표를 알려 준다.

[품질 규칙 — 교사 기준 + 경기도교육청 지리 문항 제작 자료]

  • 흑백 인쇄로 구분돼야 한다: 색 대신 빗금·회색 농도(자동).

  • 정답 단서를 드러내지 않는다: 지명·국가명은 기호로 바꾸고, 정답표는 파일 마지막 장에 둔다.

  • 경계는 자료 연도에 맞춘다: 2026년 7월 이후 자료는 2026년 판(16개 시·도, '전남광주'), 그 전 자료는 map.edition:'2025'(17개 시·도). 내장 자료는 mapEdition 과 mapName 을 알려 준다.

  • 출처와 기준 연도를 꼭 적는다: 출처는 그림 오른쪽 아래(자동). 지도 출처도 함께.

  • 전도(세계·대륙·우리나라 전체)가 아닌 지도에는 축척을 넣는다(자동).

  • 그림의 특정 부분은 A, B, C 대문자, 독립 대상은 (가)·(나)·(다).

  • 생소한 용어와 자료 조건은 notes(주석)로 보충한다. 풀이에 불필요한 그림은 넣지 않는다.

  • 판별용 지역은 suggest_regions 로 서로 잘 갈리는 곳을 고른다.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
guideA

이 도구의 작업 순서와 시험 자료 품질 규칙, 그림 명세(spec) 작성법을 돌려준다. 처음 쓸 때 먼저 부른다.

list_sourcesB

쓸 수 있는 통계 자료원과 지표 예시를 보여 준다.

find_dataB

실제 통계를 찾는다. 결과에 출처(cite)와 연도가 붙는다. 숫자를 지어내지 말고 이 결과만 쓴다.

list_exam_climate_spotsB

평가원 기후 기출 지점(2022~2026학년도) 목록: 이름, 기후 기호, 출제 시험(연월일), 좌표.

list_bundled_dataA

키 없이 쓰는 내장 KOSIS 통계 목록(주제·기간·항목·분류). KOSIS 를 직접 부르기 전에 먼저 여기서 찾는다.

kosis_searchA

KOSIS 국가통계포털에서 통계표를 찾는다(시·도·시·군·구 통계). 인증키 필요 — 먼저 list_bundled_data 를 본다.

kosis_itemsC

KOSIS 통계표의 항목(itmId)·분류(objL1…)·기간을 본다.

set_kosis_keyB

KOSIS 인증키를 이 컴퓨터 사용자 폴더에 저장한다(kosis.kr/openapi 에서 무료 발급).

list_regionsC

지도에 쓸 수 있는 지역 이름 목록(한국 시·도, 시·군·구, 세계 국가 영문명).

suggest_regionsC

지표 값이 서로 뚜렷하게 갈리는 지역 k곳을 추천한다(판별이 잘 되는 조합).

prepare_valuesC

출제용 가공: 최댓값=100 지수, 합에 대한 비율, 기준값과의 차이(편차), 기준 대비 %, 반올림.

assign_labelsC

지역 이름을 AE 또는 (가)(마) 기호로 바꾼다. 순서: random(기본) / north-south / west-east / given.

make_figuresA

그림 명세로 PPTX·HWPX 파일을 만든다. 만들기 전에 교사에게 계획 요약을 보여 주고 확인을 받았는지 먼저 확인한다. 명세 작성법은 guide.

set_styleA

학교 양식에 맞춘 글꼴·크기·그림 폭을 저장한다(다음부터 기본값).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.2/5.0

Scored across 14 tools

Disambiguation4/5

Most tools map to distinct steps in a linear exam-figure workflow (guide, data lookup, region selection, value prep, labeling, figure generation), and descriptions clarify ordering such as calling guide first and list_bundled_data before kosis_search. The data-discovery cluster (list_sources, list_bundled_data, kosis_search, kosis_items) has some conceptual overlap that could cause initial hesitation, but each has a differentiated scope.

Naming Consistency4/5

All names use consistent snake_case, and most follow a verb_noun pattern (list_*, find_*, set_*, prepare_*, assign_*, make_*, suggest_*). Minor deviations exist: 'guide' is a bare noun and 'kosis_items'/'kosis_search' put the resource noun first, but the set remains predictable and readable.

Tool Count4/5

At 14 tools, the server sits comfortably within a well-scoped range and each tool corresponds to a plausible workflow step. The surface is slightly heavy in the data-discovery/listing area and includes two configuration helpers (set_kosis_key, set_style), but nothing is clearly redundant.

Completeness4/5

The set covers the full pipeline from source discovery and statistics retrieval through region suggestion, value transformation, label assignment, and PPTX/HWPX figure generation. Minor gaps exist around managing outputs and settings—no tool to read/reset saved style, list or inspect generated files, or revise an existing figure spec—but core exam-figure workflows are covered.

Maintenance

ActivityMaintained
ResponsivenessOutdated data