geo-figure-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| DAILY_MAX | No | Maximum number of figures generated per day across the server (default 300). | 300 |
| PUBLIC_URL | No | Public URL of the remote server (e.g., https://geo-figure-mcp.onrender.com). Required for remote deployment. | |
| GEO_FIG_OUT | No | Output folder path for generated figures. Optional; defaults to a user-specific directory. | |
| ACCESS_TOKEN | No | Access token/password for the remote server. Required for remote mode. | |
| KEEP_MINUTES | No | Minutes 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.
지리 시험용 지도·그래프 제작 도구.
[작업 순서 — 반드시 지킨다]
교사의 말에서 지도·그래프 종류, 지표, 지역, 연도를 읽는다. 모르면 기본값을 채운다.
find_data 로 실제 통계를 찾는다. 한국 시·도·시·군·구 통계는 먼저 list_bundled_data(키 필요 없음)를 보고, 없을 때만 KOSIS(키 필요)를 쓴다. 숫자를 지어내지 않는다. 못 찾으면 [확인 필요]로 알리고 교사에게 숫자를 받는다.
만들기 전에 반드시 '계획 요약'을 보여 주고 교사의 "예"를 받는다: 지표·단위 / 기준 연도 / 지역과 기호(A
E 또는 (가)(마)) / 가공(지수·비율·편차·반올림) / 기호 순서(무작위·북→남·서→동·지정) / 출력(PPTX·HWPX) / 출처 문구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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 | 지역 이름을 A |
| make_figuresA | 그림 명세로 PPTX·HWPX 파일을 만든다. 만들기 전에 교사에게 계획 요약을 보여 주고 확인을 받았는지 먼저 확인한다. 명세 작성법은 guide. |
| set_styleA | 학교 양식에 맞춘 글꼴·크기·그림 폭을 저장한다(다음부터 기본값). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
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.
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.
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.
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.