geo-figure-mcp 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,9 +1,9 @@
1
- # geo-figure-mcp — 지리 시험용 지도·그래프 만들기 (0.2)
1
+ # geo-figure-mcp — 지리 시험용 지도·그래프 만들기 (0.2.2)
2
2
 
3
3
  만든 사람: 김한솔 (한백고등학교 지리 교사)
4
4
 
5
5
  AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름은 A~E로 숨겨서"처럼 말하면, **실제 통계**를 찾아 **흑백 시험지용** 지도·그래프를 만들어 줍니다.
6
- 결과는 **PPTX·HWPX** 파일이고, 지역 한 칸·막대 하나·글자 하나까지 **도형**으로 들어갑니다(그림 파일이 아닙니다). 묶음을 풀면 하나씩 고칠 수 있습니다.
6
+ 결과는 **PPTX·HWPX** 파일이고, 지역 한 칸·막대 하나·글자 하나까지 **도형**으로 들어갑니다(그림 파일이 아닙니다). 그룹 해제(개체 풀기)를 **한 번만** 하면 하나씩 고칠 수 있습니다.
7
7
 
8
8
  ## 무엇이 되나
9
9
  - **지도**: 한국 시·도 / 시·군·구(2026년 판, 16개 시·도), 세계·대륙(위·경도선), 단계 구분도(빗금·회색), A~E 기호, 지점, 흐름 화살표, 축척 자동, 경계 단순화 3단계
@@ -11,7 +11,7 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
11
11
  - **그래프**: 막대·누적 막대, 산점도·버블, 기후 그래프, 편차, 인구 피라미드, 삼각 그래프
12
12
  - **통계(실제 자료만, 숫자를 지어내지 않음)**
13
13
  - 세계은행 WDI, Our World in Data(에너지·CO2): 인증키 없음
14
- - 기후: WMO 1991~2020 평년값 관측소 4,697곳 내장 + **평가원 기후 기출 지점 66곳**(2022~2026학년도)
14
+ - 기후: WMO 1991~2020 평년값 관측소 4,697곳 내장 + **평가원 기후 기출 지점 67곳**(2022~2026학년도)
15
15
  - **내장 KOSIS 통계 17종(인증키 없이 사용)**: 인구 구조(부양비·노령화 지수·중위 연령), 성·5세 연령별 인구(피라미드), 인구주택총조사, 주간 인구 지수(2020), 외국인 주민 유형, 합계 출산율(10년), 시·도 간 인구 이동, 도시 지역 인구, GRDP, 제조업 업종별 출하액, 산업별 사업체, 최종 에너지 소비, 신재생 에너지, 농가 인구, 노지 채소·시설 작물·작물별 재배 면적 — `scripts/build-kosis.js` 로 다시 받을 수 있음
16
16
  - **시·도별 발전원별 발전량**(공공데이터포털, 이용 허락 '제한 없음')
17
17
  - 원자력: 2014~2025년, 호기별 발전량을 발전소 소재 시·도로 합침
@@ -28,6 +28,9 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
28
28
  - 확대 지도엔 축척
29
29
  - 정답표는 파일 마지막 장
30
30
  - 만들기 전에 AI가 계획(지표·연도·지역·가공·기호 순서·출력)을 요약해 보여 주고 확인을 받습니다(확인 없이는 파일을 만들지 않음).
31
+ - **시안 먼저**: 파일을 만들기 전에 대화창에 미리보기 그림을 보여 줍니다. 지도 기호 모양은 4가지(① 흰 테두리 ② 바탕 없음 ③ 네모 흰 바탕 ④ 작은 원 흰 바탕)를 나란히 보여 주고 고르게 합니다.
32
+ - **만든 뒤 고치기**: 그림과 함께 설계도(`<이름>.geo-figure.json`)를 저장합니다. "범례 바꿔 줘", "화성시 빼 줘", "기호 순서 바꿔 줘"라고 하면 통계를 다시 찾지 않고 그 부분만 고쳐 다시 만듭니다.
33
+ - **자동 업데이트**: 설정에 `geo-figure-mcp@latest` 를 쓰면 앱을 켤 때마다 최신 버전을 받습니다. 예전 버전이 돌고 있으면 AI가 "새 버전이 있다"고 알려 줍니다.
31
34
 
32
35
  ## 설치 (Claude 데스크톱)
33
36
  1. [Node.js](https://nodejs.org) 20 이상(LTS) 설치 — 이것만 있으면 됩니다. 프로그램은 처음 쓸 때 자동으로 내려받습니다(`npx`).
@@ -38,7 +41,7 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
38
41
  "mcpServers": {
39
42
  "geo-figure": {
40
43
  "command": "npx",
41
- "args": ["-y", "geo-figure-mcp"],
44
+ "args": ["-y", "geo-figure-mcp@latest"],
42
45
  "env": { "GEO_FIGURE_OUT": "C:/Users/<이름>/Documents/지리시험자료" }
43
46
  }
44
47
  }
@@ -59,7 +62,7 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
59
62
  "mcpServers": {
60
63
  "geo-figure": {
61
64
  "command": "npx",
62
- "args": ["-y", "geo-figure-mcp"],
65
+ "args": ["-y", "geo-figure-mcp@latest"],
63
66
  "env": { "GEO_FIGURE_OUT": "C:/Users/<이름>/Documents/지리시험자료" }
64
67
  }
65
68
  }
@@ -107,16 +110,19 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
107
110
  - 내 컴퓨터에서 시험: `ACCESS_TOKEN=아무거나 npm run start:remote` → `node examples/remote-test.js http://localhost:8787/mcp 아무거나`
108
111
 
109
112
  ## 고치는 법
110
- - **PowerPoint**: 그림 선택 → 마우스 오른쪽 → 그룹 → 그룹 해제. 범례·막대·기호 같은 작은 묶음도 한 번 더 풀 수 있습니다.
111
- - **한글**: 그림 선택 → 마우스 오른쪽 → 개체 풀기. 풀어도 조각이 제자리에 남습니다.
112
- - 그림은 '글 앞으로' 놓이고, 그 자리는 고정 높이 문단으로 비워 둡니다.
113
- - 묶음은 최대 3단입니다.
113
+ - **PowerPoint**: 그림 선택 → 마우스 오른쪽 → 그룹 → 그룹 해제 **한 번**. 시·군·구, 경계선, 범례, 막대가 모두 따로 움직입니다.
114
+ - 기호(A, (가) 등)는 글자와 흰 테두리가 함께 움직이도록 작은 묶음 하나로 남습니다. 글자를 바꾸려면 그것만 한 번 더 풀면 됩니다.
115
+ - 도형 이름이 지역 이름입니다(홈 → 정렬 → 선택 창에서 "경기 화성시"처럼 보임).
116
+ - 단계를 손으로 바꿀 땐 범례 칸을 고르고 서식 복사(붓)로 지역에 칠하면 됩니다.
117
+ - **한글**: 그림 선택 → 마우스 오른쪽 → 개체 풀기 **한 번**. 조각이 제자리에 남습니다.
118
+ - 그림이 쪽에 다 안 들어가면 제목부터 다음 쪽으로 넘어갑니다(겹치지 않음).
119
+ - **크게 바꿀 땐 AI에게 말로**: 설계도를 읽어 그 부분만 바꿔 다시 만듭니다(open_figure_spec).
114
120
  - **글꼴**
115
121
  - 한글 파일은 함초롬돋움(한글 기본 글꼴), PowerPoint 파일은 맑은 고딕(한국어 윈도 기본)을 씁니다.
116
122
  - "그림 글꼴을 ○○로 바꿔 줘"라고 하면 다음부터 그 설정으로 만듭니다(set_style).
117
123
 
118
124
  ## 기후 자료 출처 (지점마다 결과에 표시)
119
- 기출 지점 66곳은 계산한 쾨펜 기후를 평가원 기호와 대조했습니다(`node scripts/check-koppen.js`).
125
+ 기출 지점 67곳은 계산한 쾨펜 기후를 평가원 기호와 대조했습니다(`node scripts/check-koppen.js`).
120
126
 
121
127
  | 지점 수 | 출처 | 기준 |
122
128
  |---|---|---|
@@ -124,10 +130,9 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
124
130
  | 7곳 | NOAA GHCN-Daily 일별 기록 | 그달 20일 이상 기록된 해 10년 이상으로 직접 평균 |
125
131
  | 11곳 | Beck et al.(2023) 0.1° 격자 1991~2020 | 관측소 자료가 부족한 곳만. 격자 추정값이라고 표시함 |
126
132
 
127
- - 대조 결과 60곳은 일치했습니다.
128
- - 다른 6곳 가운데 5곳은 경계형이나 고산 기후입니다(밴쿠버, 튀니스, 산티아고, 아디스아바바, 보고타).
129
- - 칭다오는 목록에 Cs로 적혀 있으나 값으로는 Cwa입니다 [확인 필요].
130
- - 티베트고원은 특정 지점이 아니라 좌표를 비워 두었습니다.
133
+ - 대조 결과 62곳은 일치했습니다. 다른 5곳은 경계형이나 고산 기후입니다(밴쿠버, 튀니스, 산티아고, 아디스아바바, 보고타).
134
+ - 칭다오는 평년값 계산(Cwa)에 따라 Cw로 정정했습니다.
135
+ - 티베트고원은 고원 중앙의 WMO 퉈퉈허(沱沱河) 관측소(해발 4,535m, 최난월 8.4℃ → ET)를 대표 지점으로 씁니다.
131
136
 
132
137
  ## 예시와 검사
133
138
  - `node examples/run.js` → `examples/out/` 에 예시 5개를 만듭니다.
@@ -137,6 +142,7 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
137
142
  4. 울릉도 등고선·단면
138
143
  5. 지형 모식도
139
144
  - `node examples/mcp-test.js` → MCP 서버를 실제로 띄워 주요 도구를 불러 봅니다.
145
+ - `npm test` → 자동 검사(그림 종류별 생성, PPTX·HWPX 구조, 묶음 한 겹, 미리보기, 내장 자료). 깃허브에서 push와 배포 때마다 돕니다.
140
146
 
141
147
  ## 자료와 라이선스
142
148
  - 코드: MIT