geo-figure-mcp 0.2.7 → 0.2.8
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 +15 -4
- package/package.json +2 -2
- package/server.json +2 -2
- package/src/data.js +50 -15
- package/src/http.js +5 -1
- package/src/linked.js +191 -0
- package/src/references.js +35 -0
- package/src/tools.js +76 -36
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# geo-figure-mcp — 지리 시험용 지도·그래프 만들기 (0.2.
|
|
1
|
+
# geo-figure-mcp — 지리 시험용 지도·그래프 만들기 (0.2.8)
|
|
2
2
|
|
|
3
3
|
만든 사람: barkhan (지리 교사)
|
|
4
4
|
|
|
@@ -28,8 +28,8 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
|
|
|
28
28
|
- 확대 지도엔 축척
|
|
29
29
|
- 정답표는 파일 마지막 장
|
|
30
30
|
- 만들기 전에 AI가 계획(지표·연도·지역·가공·기호 순서·출력)을 요약해 보여 주고 확인을 받습니다(확인 없이는 파일을 만들지 않음).
|
|
31
|
-
- **시안 먼저**: 파일을 만들기 전에 대화창에 미리보기 그림을 보여 줍니다. 지도 기호
|
|
32
|
-
- **필요한 정보만 조회**: 내장 통계는 list_bundled_data의 query로 검색하고 summary:true로 키와 주제만 볼 수 있습니다.
|
|
31
|
+
- **시안 먼저**: 파일을 만들기 전에 대화창에 미리보기 그림을 보여 줍니다. 기호 비교를 요청하면 지도 기호 모양 4가지(① 흰 테두리 ② 바탕 없음 ③ 네모 흰 바탕 ④ 작은 원 흰 바탕)를 나란히 보여 주고 고르게 합니다.
|
|
32
|
+
- **필요한 정보만 조회**: 내장 통계는 list_bundled_data의 query로 검색하고 summary:true로 키와 주제만 볼 수 있습니다. 로컬·원격 시안의 previewId가 있으면, 교사가 확인한 뒤 같은 그림 명세 대신 ID를 보내 파일을 만들 수 있습니다(최대 30분).
|
|
33
33
|
- **만든 뒤 고치기**: 그림과 함께 설계도(`<이름>.geo-figure.json`)를 저장합니다. "범례 바꿔 줘", "화성시 빼 줘", "기호 순서 바꿔 줘"라고 하면 통계를 다시 찾지 않고 그 부분만 고쳐 다시 만듭니다.
|
|
34
34
|
- **자동 업데이트**: 설정에 `geo-figure-mcp@latest` 를 쓰면 앱을 켤 때마다 최신 버전을 받습니다. 예전 버전이 돌고 있으면 AI가 "새 버전이 있다"고 알려 줍니다.
|
|
35
35
|
|
|
@@ -73,6 +73,17 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
|
|
|
73
73
|
- `npx` 를 못 찾는다고 나오면 `command` 에 `C:/Program Files/nodejs/npx.cmd` 처럼 전체 경로를 넣습니다.
|
|
74
74
|
- 원격 서버를 쓸 때는 `"serverUrl": "https://…/mcp?token=비밀번호"` 한 줄로 등록합니다(`url`·`httpUrl` 이 아님).
|
|
75
75
|
|
|
76
|
+
## 같은 통계로 지도와 막대그래프 만들기
|
|
77
|
+
|
|
78
|
+
“2020년 경기도 31개 시·군의 주간 인구 지수를 100 미만과 100 이상으로 나눈 지도를 그리고, 막대에는 상위 5곳만 보여 줘.”
|
|
79
|
+
|
|
80
|
+
1. `find_data`에 `{"source":"bundle","bundle":{"key":"daytime-population","period":"2020","items":["주간 인구 지수"],"within":["경기"]},"asReference":true}`를 보냅니다. 행 전체 대신 자료 ID, 지표, 지역 수, 연도, 출처를 받습니다.
|
|
81
|
+
2. `preview_figures`에 `{"linked":{"dataId":"받은 자료 ID","indicator":"주간 인구 지수","within":["경기"],"breaks":[100],"top":5}}`를 보냅니다. 막대를 모두 표시하려면 `top`을 생략합니다. `labels`로 지역에 기호를 붙일 수 있습니다.
|
|
82
|
+
3. 시안을 확인하면 `make_figures`에 `{"previewId":"받은 시안 ID","confirmed":true,"formats":["hwpx"]}`를 보냅니다. 기호를 바꾸려면 먼저 `preview_figures`에 `{"edit":{"previewId":"받은 시안 ID","labels":{"경기 화성시":"A"}}}`를 보내고 새 시안을 확인합니다.
|
|
83
|
+
4. 연결된 기호의 지역 대응표는 로컬에서는 파일 마지막 장, 원격에서는 대화에 제공됩니다. 자료·시안 ID는 공유받은 사람이 사용할 수 있습니다. 서버 재시작, 보관 개수 초과 또는 최대 30분 경과 후에는 다시 조회하거나 시안을 만드세요.
|
|
84
|
+
|
|
85
|
+
국내 기후는 `서울`, `강릉`, `대구`, `제주`처럼 한글 관측소 이름으로 조회합니다. 세계은행은 `years:true`로 국가별 연도별 값을, `year:2020`으로 한 해의 값을 조회합니다.
|
|
86
|
+
|
|
76
87
|
## 내장 통계와 지도 이름 맞추기
|
|
77
88
|
|
|
78
89
|
- 지도와 그래프에 필요한 항목은 `bundle.items`, 지역은 `bundle.regions`(정확한 `mapName` 또는 통계표 지역명)로 고릅니다. 한 시·도의 지도용 시·군·구를 모두 받으려면 `bundle.within`을 씁니다. 예를 들어 `find_data`에 `{"source":"bundle","bundle":{"key":"daytime-population","period":"2020","items":["주간 인구 지수"],"within":["경기"]}}`를 보내면 경기도 시·군의 해당 지수만 받습니다.
|
|
@@ -121,7 +132,7 @@ AI에게 "서울 자치구 주간 인구 지수 지도랑 산점도, 구 이름
|
|
|
121
132
|
- 단계를 손으로 바꿀 땐 범례 칸을 고르고 서식 복사(붓)로 지역에 칠하면 됩니다.
|
|
122
133
|
- **한글**: 그림 선택 → 마우스 오른쪽 → 개체 풀기 **한 번**. 조각이 제자리에 남습니다.
|
|
123
134
|
- 그림이 쪽에 다 안 들어가면 제목부터 다음 쪽으로 넘어갑니다(겹치지 않음).
|
|
124
|
-
- **범례·기호만 바꾸기**: 로컬에서 `preview_figures`에 `saved: {name, legend, labelStyle}`처럼 파일 이름과 바꿀 내용만 보냅니다. `labels`에는 기호를 바꿀 기존 지도 지역만 적습니다. 그림이나 지도가 여러 개라면 `figure`와 `part`로 대상을 지정할 수 있습니다(1부터). 수정 시안을 확인한 후 `make_figures`에 `previewId`, 새 이름, 출력 형식을 보냅니다.
|
|
135
|
+
- **범례·기호만 바꾸기**: 로컬에서 `preview_figures`에 `saved: {name, legend, labelStyle}`처럼 파일 이름과 바꿀 내용만 보냅니다. `labels`에는 기호를 바꿀 기존 지도 지역만 적습니다. 그림이나 지도가 여러 개라면 `figure`와 `part`로 대상을 지정할 수 있습니다(1부터). 수정 시안을 확인한 후 `make_figures`에 `previewId`, 새 이름, 출력 형식을 보냅니다. 통계에 연결한 그림은 지도, 막대 이름, 지역 대응표가 함께 바뀝니다. 기존 그림은 기호가 일대일로 대응되는 그래프만 자동으로 고칩니다. 직접 쓴 정답·해설은 수정본을 저장할 때 다시 지정합니다.
|
|
125
136
|
- **크게 바꿀 땐 AI에게 말로**: 설계도를 읽어 그 부분만 바꿔 다시 만듭니다(open_figure_spec).
|
|
126
137
|
- **글꼴**
|
|
127
138
|
- 한글 파일은 함초롬돋움(한글 기본 글꼴), PowerPoint 파일은 맑은 고딕(한국어 윈도 기본)을 씁니다.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "geo-figure-mcp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.8",
|
|
4
4
|
"description": "지리 시험용 지도·그래프를 도형 하나하나 고칠 수 있는 PPTX·HWPX로 만드는 MCP 서버",
|
|
5
5
|
"author": "barkhan",
|
|
6
6
|
"mcpName": "io.github.skyblue3925-svg/geo-figure-mcp",
|
|
@@ -21,7 +21,7 @@
|
|
|
21
21
|
"examples": "node examples/run.js",
|
|
22
22
|
"start:remote": "node src/http.js",
|
|
23
23
|
"demo": "node examples/demo.js",
|
|
24
|
-
"test": "node tests/smoke.js"
|
|
24
|
+
"test": "node tests/smoke.js && node tests/climate-worldbank.js && node tests/linked.js && node tests/references.js && node tests/remote-workflow.js"
|
|
25
25
|
},
|
|
26
26
|
"keywords": [
|
|
27
27
|
"mcp",
|
package/server.json
CHANGED
|
@@ -4,12 +4,12 @@
|
|
|
4
4
|
"title": "Geo Figure (지리 시험 지도·그래프)",
|
|
5
5
|
"description": "지리 시험용 지도·그래프를 실제 통계로, 도형 하나하나 고칠 수 있는 PPTX·HWPX로 만든다.",
|
|
6
6
|
"repository": { "url": "https://github.com/skyblue3925-svg/geo-figure-mcp", "source": "github" },
|
|
7
|
-
"version": "0.2.
|
|
7
|
+
"version": "0.2.8",
|
|
8
8
|
"packages": [
|
|
9
9
|
{
|
|
10
10
|
"registryType": "npm",
|
|
11
11
|
"identifier": "geo-figure-mcp",
|
|
12
|
-
"version": "0.2.
|
|
12
|
+
"version": "0.2.8",
|
|
13
13
|
"transport": { "type": "stdio" },
|
|
14
14
|
"environmentVariables": [
|
|
15
15
|
{ "name": "GEO_FIGURE_OUT", "description": "만든 파일을 저장할 폴더 (기본: 문서/지리시험자료)", "isRequired": false, "isSecret": false }
|
package/src/data.js
CHANGED
|
@@ -9,7 +9,7 @@ export const SOURCES = {
|
|
|
9
9
|
worldbank: { name: '세계은행 WDI', cite: 'World Bank', license: 'CC BY 4.0', key: false, note: '지표 코드 예: SP.POP.TOTL(총인구), SP.URB.TOTL.IN.ZS(도시화율), SP.DYN.TFRT.IN(합계 출산율), SP.POP.65UP.TO.ZS(65세 이상 비율), NY.GDP.PCAP.CD(1인당 GDP)' },
|
|
10
10
|
'owid-energy': { name: 'Our World in Data 에너지', cite: 'Our World in Data(Energy Institute 등)', license: 'CC BY 4.0', key: false, note: '열 예: coal_share_elec, nuclear_share_elec, gas_share_elec, solar_share_elec, energy_per_capita' },
|
|
11
11
|
'owid-co2': { name: 'Our World in Data CO2', cite: 'Our World in Data(Global Carbon Project)', license: 'CC BY 4.0', key: false, note: '열 예: co2, co2_per_capita, cumulative_co2' },
|
|
12
|
-
climate: { name: 'WMO 기후평년값 1991~2020 (내장, 관측소 4,
|
|
12
|
+
climate: { name: 'WMO 기후평년값 1991~2020 (내장, 관측소 4,697곳)', cite: 'WMO 기후평년값(1991~2020)', license: '이용 제한 없음(출처 표시, NCEI doi:10.25921/800j-vn07)', key: false, note: '지점: 국내 관측소 한글 이름(예: 서울, 강릉, 대구, 제주) · 평가원 기출 기후 지점 이름(list_exam_climate_spots) · 관측소 영문 이름 · "위도,경도". 좌표로 조회하면 가장 가까운 관측소와 거리를 알려 준다.' },
|
|
13
13
|
'seoul-daytime': { name: '서울 자치구 주간 인구 2020 (내장)', cite: '통계청, 「2020 인구주택총조사」', license: '공공누리 제1유형', key: false, note: '열: 상주인구, 유입인구, 유출인구, 주간인구, 주간인구지수' },
|
|
14
14
|
bundle: { name: '내장 KOSIS 통계 묶음(인증키 불필요)', cite: '국가데이터처 등(KOSIS)', license: '공공누리 제1유형', key: false, note: 'list_bundled_data 로 목록을 보고 find_data(source:"bundle", bundle:{ key, items, period, where }) 로 꺼낸다. 인구 구조·피라미드·주간 인구·외국인 주민·출산율·인구 이동·도시화·GRDP·제조업·사업체·에너지·신재생·농가·작물 재배 면적.' },
|
|
15
15
|
kosis: { name: 'KOSIS 국가통계포털 (시·도·시·군·구 통계)', cite: '통계청 KOSIS', license: '공공누리 제1유형', key: true, note: 'kosis_search 로 통계표(orgId·tblId)를 찾고 kosis_items 로 항목·분류를 본 뒤 find_data(source:"kosis", kosis:{orgId,tblId,itmId,objL1,…,prdSe,year}) 로 받는다. 인증키: 환경 변수 KOSIS_API_KEY 또는 set_kosis_key.' },
|
|
@@ -20,6 +20,17 @@ async function getJson(url) {
|
|
|
20
20
|
if (!r.ok) throw new Error(`자료를 받지 못함 ${r.status}: ${url}`);
|
|
21
21
|
return r.json();
|
|
22
22
|
}
|
|
23
|
+
async function worldBankPages(url, notFound) {
|
|
24
|
+
const records = [];
|
|
25
|
+
let pages = 1;
|
|
26
|
+
for (let page = 1; page <= pages; page++) {
|
|
27
|
+
const result = await getJson(page === 1 ? url : `${url}&page=${page}`);
|
|
28
|
+
if (!Array.isArray(result?.[1])) throw new Error(notFound);
|
|
29
|
+
records.push(...result[1]);
|
|
30
|
+
pages = Number(result[0]?.pages ?? 1);
|
|
31
|
+
}
|
|
32
|
+
return records;
|
|
33
|
+
}
|
|
23
34
|
function csvLine(line) {
|
|
24
35
|
const out = []; let cur = '', q = false;
|
|
25
36
|
for (let i = 0; i < line.length; i++) {
|
|
@@ -36,21 +47,22 @@ const koName = new Intl.DisplayNames(['ko'], { type: 'region' });
|
|
|
36
47
|
// 결과 모양: { title, unit, cite, year, rows:[{ id, name, values:{ 열: 값 }, year }] }
|
|
37
48
|
export async function findData({ source, indicators = [], regions = [], year, years }) {
|
|
38
49
|
if (source === 'worldbank') {
|
|
39
|
-
const meta =
|
|
50
|
+
const meta = await worldBankPages('https://api.worldbank.org/v2/country?format=json&per_page=400', '세계은행 국가 목록을 읽지 못함');
|
|
40
51
|
const iso2 = Object.fromEntries(meta.map((c) => [c.id, c.iso2Code]));
|
|
41
52
|
const rows = {};
|
|
42
|
-
const range =
|
|
53
|
+
const range = year ?? (years === true ? null : years || `2000:${new Date().getUTCFullYear()}`);
|
|
54
|
+
const params = new URLSearchParams({ format: 'json', per_page: '1000' });
|
|
55
|
+
if (range !== null) params.set('date', String(range));
|
|
43
56
|
for (const ind of indicators) {
|
|
44
|
-
const
|
|
45
|
-
|
|
46
|
-
for (const r of j[1]) {
|
|
57
|
+
const url = `https://api.worldbank.org/v2/country/${regions.map(encodeURIComponent).join(';')}/indicator/${encodeURIComponent(ind)}?${params}`;
|
|
58
|
+
for (const r of await worldBankPages(url, `세계은행에 없는 지표이거나 값이 없음: ${ind}`)) {
|
|
47
59
|
if (r.value == null) continue;
|
|
48
60
|
const id = r.countryiso3code || r.country.id;
|
|
49
61
|
const row = (rows[id] ||= { id, name: safeKo(iso2[id], r.country.value), byYear: {} });
|
|
50
62
|
(row.byYear[r.date] ||= {})[ind] = r.value;
|
|
51
63
|
}
|
|
52
64
|
}
|
|
53
|
-
return pack(rows, indicators, year, '세계은행', SOURCES.worldbank.cite);
|
|
65
|
+
return pack(rows, indicators, year, '세계은행', SOURCES.worldbank.cite, years === true);
|
|
54
66
|
}
|
|
55
67
|
if (source === 'owid-energy' || source === 'owid-co2') {
|
|
56
68
|
const url = source === 'owid-energy' ? 'https://raw.githubusercontent.com/owid/energy-data/master/owid-energy-data.csv' : 'https://raw.githubusercontent.com/owid/co2-data/master/owid-co2-data.csv';
|
|
@@ -73,7 +85,7 @@ export async function findData({ source, indicators = [], regions = [], year, ye
|
|
|
73
85
|
return pack(rows, indicators, year, source, SOURCES[source].cite, years);
|
|
74
86
|
}
|
|
75
87
|
if (source === 'climate') {
|
|
76
|
-
//
|
|
88
|
+
// 국내·기출 지점 이름, 관측소 영문 이름 또는 좌표로 1991~2020 평년값 조회
|
|
77
89
|
if (!regions.length) throw new Error('지점을 주세요. 예: ["샌프란시스코","이르쿠츠크"] 또는 ["37.57,126.98"]. 기출 지점 목록은 list_exam_climate_spots');
|
|
78
90
|
const units = { temp: '℃', precip: 'mm' };
|
|
79
91
|
const requested = Object.keys(units).filter((name) => !indicators.length || indicators.includes(name));
|
|
@@ -167,6 +179,26 @@ export function suggestRegions(rows, indicators, k = 5) {
|
|
|
167
179
|
let WMO, SPOTS;
|
|
168
180
|
const wmo = () => (WMO ||= load('wmo-normals-1991-2020.json'));
|
|
169
181
|
export const examSpots = () => (SPOTS ||= load('exam-climate-spots.json')).spots;
|
|
182
|
+
// 내장 WMO 자료의 지점 번호(앞의 0 제외)로 대응시킨다.
|
|
183
|
+
const KOREAN_STATIONS = new Map(Object.entries({
|
|
184
|
+
속초: 47090, 철원: 47095, 동두천: 47098, 파주: 47099, 대관령: 47100,
|
|
185
|
+
춘천: 47101, 백령도: 47102, 강릉: 47105, 동해: 47106, 서울: 47108,
|
|
186
|
+
인천: 47112, 원주: 47114, 울릉도: 47115, 수원: 47119, 영월: 47121,
|
|
187
|
+
충주: 47127, 서산: 47129, 울진: 47130, 청주: 47131, 대전: 47133,
|
|
188
|
+
추풍령: 47135, 안동: 47136, 상주: 47137, 포항: 47138, 군산: 47140,
|
|
189
|
+
울산: 47152, 창원: 47155, 광주: 47156, 부산: 47159, 통영: 47162,
|
|
190
|
+
목포: 47165, 여수: 47168, 흑산도: 47169, 완도: 47170, 고창: 47172,
|
|
191
|
+
제주: 47184, 고산: 47185, 성산: 47188, 서귀포: 47189, 진주: 47192,
|
|
192
|
+
강화: 47201, 양평: 47202, 이천: 47203, 인제: 47211, 홍천: 47212,
|
|
193
|
+
태백: 47216, 정선: 47217, 제천: 47221, 보은: 47226, 천안: 47232,
|
|
194
|
+
보령: 47235, 부여: 47236, 금산: 47238, 부안: 47243, 임실: 47244,
|
|
195
|
+
정읍: 47245, 남원: 47247, 장수: 47248, 영광: 47252, 김해: 47253,
|
|
196
|
+
순창: 47254, 양산: 47257, 강진: 47259, 장흥: 47260, 해남: 47261,
|
|
197
|
+
고흥: 47262, 의령: 47263, 함양: 47264, 봉화: 47271, 영주: 47272,
|
|
198
|
+
문경: 47273, 청송: 47276, 영덕: 47277, 의성: 47278, 구미: 47279,
|
|
199
|
+
영천: 47281, 경주: 47283, 거창: 47284, 합천: 47285, 밀양: 47288,
|
|
200
|
+
산청: 47289, 거제: 47294, 남해: 47295, 대구: 47860, 전주: 47864,
|
|
201
|
+
}));
|
|
170
202
|
const hav = (a, b, c, d) => { const r = Math.PI / 180, x = Math.sin(((c - a) * r) / 2) ** 2 + Math.cos(a * r) * Math.cos(c * r) * Math.sin(((d - b) * r) / 2) ** 2; return 12742 * Math.asin(Math.sqrt(x)); };
|
|
171
203
|
export function nearestStations(lat, lon, n = 3) {
|
|
172
204
|
return wmo().stations.map((s) => ({ s, d: hav(lat, lon, s[3], s[4]) })).sort((a, b) => a.d - b.d).slice(0, n);
|
|
@@ -174,7 +206,7 @@ export function nearestStations(lat, lon, n = 3) {
|
|
|
174
206
|
function climateRow(q) {
|
|
175
207
|
const W = wmo();
|
|
176
208
|
const spot = examSpots().find((x) => x.name === q);
|
|
177
|
-
let lat, lon,
|
|
209
|
+
let lat, lon, station, exam = null;
|
|
178
210
|
if (spot) {
|
|
179
211
|
if (spot.lat == null) throw new Error(`'${q}'는 특정 지점이 아니라 좌표가 없습니다. 쓸 관측소 이름이나 "위도,경도"를 주세요.`);
|
|
180
212
|
({ lat, lon } = spot); exam = { code: spot.code, exams: spot.exams };
|
|
@@ -188,16 +220,19 @@ function climateRow(q) {
|
|
|
188
220
|
} else if (/^-?\d+(\.\d+)?\s*,\s*-?\d+(\.\d+)?$/.test(q)) {
|
|
189
221
|
[lat, lon] = q.split(',').map(Number);
|
|
190
222
|
} else {
|
|
191
|
-
const
|
|
192
|
-
|
|
223
|
+
const stationName = q.normalize('NFC').trim();
|
|
224
|
+
const koreanId = KOREAN_STATIONS.get(stationName.replace(/(?:특별시|광역시|[시군])$/, ''));
|
|
225
|
+
station = koreanId
|
|
226
|
+
? W.stations.find((s) => s[2].trim() === 'Rep._Korea' && Number(s[0]) === koreanId)
|
|
227
|
+
: W.stations.find((s) => s[1].toLowerCase() === stationName.toLowerCase().replace(/\s+/g, ''));
|
|
228
|
+
if (!station) {
|
|
193
229
|
const near = W.stations.filter((s) => s[1].toLowerCase().includes(q.toLowerCase().slice(0, 4))).slice(0, 8).map((s) => `${s[1]}(${s[2].trim()})`);
|
|
194
|
-
throw new Error(`'${q}' 지점을 찾지 못함. 평가원 기출 지점
|
|
230
|
+
throw new Error(`'${q}' 지점을 찾지 못함. 국내 관측소 한글 이름, 평가원 기출 지점 이름, 관측소 영문 이름, 또는 "위도,경도"를 주세요.${near.length ? ' 비슷한 관측소: ' + near.join(', ') : ''}`);
|
|
195
231
|
}
|
|
196
|
-
[lat, lon] = [st[3], st[4]];
|
|
197
232
|
}
|
|
198
|
-
const
|
|
233
|
+
const { s, d } = station ? { s: station, d: 0 } : nearestStations(lat, lon, 1)[0];
|
|
199
234
|
const warn = d > 50 ? `가장 가까운 관측소가 ${Math.round(d)}km 떨어져 있음 — 값이 실제 지점과 다를 수 있음 [확인 필요]` : null;
|
|
200
|
-
return { id:
|
|
235
|
+
return { id: q, name: q, station: s[1], country: s[2].trim(), distanceKm: Math.round(d), lat: s[3], lon: s[4], height: s[5], exam, warn, values: { temp: s[6], precip: s[7] } };
|
|
201
236
|
}
|
|
202
237
|
|
|
203
238
|
// ---- KOSIS 공유서비스(OpenAPI) ----
|
package/src/http.js
CHANGED
|
@@ -13,6 +13,7 @@ import path from 'node:path';
|
|
|
13
13
|
import crypto from 'node:crypto';
|
|
14
14
|
import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
|
|
15
15
|
import { createServer } from './tools.js';
|
|
16
|
+
import { createReferences } from './references.js';
|
|
16
17
|
|
|
17
18
|
const PORT = +(process.env.PORT || 8787);
|
|
18
19
|
const PUBLIC_URL = (process.env.PUBLIC_URL || `http://localhost:${PORT}`).replace(/\/$/, '');
|
|
@@ -28,6 +29,7 @@ let day = '', dayCount = 0;
|
|
|
28
29
|
const dailyOver = () => { const d = new Date().toISOString().slice(0, 10); if (d !== day) { day = d; dayCount = 0; } return ++dayCount > DAILY_MAX; };
|
|
29
30
|
fs.mkdirSync(FILES, { recursive: true });
|
|
30
31
|
|
|
32
|
+
const references = createReferences(true);
|
|
31
33
|
const publish = {
|
|
32
34
|
newDir: () => { const d = path.join(FILES, crypto.randomBytes(12).toString('hex')); fs.mkdirSync(d, { recursive: true }); return d; },
|
|
33
35
|
keepText: KEEP_MIN >= 60 ? `${Math.round(KEEP_MIN / 60)}시간` : `${KEEP_MIN}분`,
|
|
@@ -36,6 +38,8 @@ const publish = {
|
|
|
36
38
|
|
|
37
39
|
// 오래된 파일 지우기(5분마다)
|
|
38
40
|
setInterval(() => {
|
|
41
|
+
references.previews.purge();
|
|
42
|
+
references.datasets.purge();
|
|
39
43
|
for (const d of fs.readdirSync(FILES)) {
|
|
40
44
|
const p = path.join(FILES, d);
|
|
41
45
|
try { if (Date.now() - fs.statSync(p).mtimeMs > KEEP_MS) fs.rmSync(p, { recursive: true, force: true }); } catch {}
|
|
@@ -88,7 +92,7 @@ const server = http.createServer(async (req, res) => {
|
|
|
88
92
|
if (isMake && limited(ip, 'make', MAKE_PER_HOUR, 3600 * 1000)) return send(res, 429, { error: '같은 접속 IP에서는 최근 1시간에 ' + MAKE_PER_HOUR + '번까지 파일을 만들 수 있습니다.' });
|
|
89
93
|
if (isMake && dailyOver()) return send(res, 429, { error: '오늘 서버 전체 사용량을 다 썼습니다. 내일 다시 쓰거나 내 컴퓨터에 설치해 쓰세요.' });
|
|
90
94
|
try {
|
|
91
|
-
const mcp = createServer({ remote: true, publish });
|
|
95
|
+
const mcp = createServer({ remote: true, publish, references });
|
|
92
96
|
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
|
|
93
97
|
res.on('close', () => { transport.close(); mcp.close(); });
|
|
94
98
|
await mcp.connect(transport);
|
package/src/linked.js
ADDED
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
import { listRegions } from './maps.js';
|
|
2
|
+
import { CLASS_FILLS } from './scene.js';
|
|
3
|
+
|
|
4
|
+
function text(value) {
|
|
5
|
+
return typeof value === 'string' ? value.trim() : '';
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
function unitFor(unit, indicator) {
|
|
9
|
+
if (unit && typeof unit === 'object') {
|
|
10
|
+
const metric = indicator.split(' · ').at(-1);
|
|
11
|
+
return text(Object.hasOwn(unit, indicator) ? unit[indicator] : Object.hasOwn(unit, metric) ? unit[metric] : undefined);
|
|
12
|
+
}
|
|
13
|
+
if (unit === '명, 지수') {
|
|
14
|
+
if (indicator === '주간인구지수') return '지수';
|
|
15
|
+
if (['상주인구', '유입인구', '유출인구', '주간인구'].includes(indicator)) return '명';
|
|
16
|
+
}
|
|
17
|
+
const value = text(unit);
|
|
18
|
+
return !value.startsWith('[') && !value.includes(', ') ? value : '';
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function checkedLabels(current, changes, allowed) {
|
|
22
|
+
if (changes === null || typeof changes !== 'object' || Array.isArray(changes)) throw new Error('labels는 지도 지역명과 기호를 짝지은 객체여야 합니다.');
|
|
23
|
+
for (const key of Object.keys(changes)) {
|
|
24
|
+
if (!allowed.has(key)) throw new Error('기호를 지정할 지도 지역이 없습니다: ' + key);
|
|
25
|
+
}
|
|
26
|
+
const labels = Object.fromEntries(Object.entries({ ...current, ...changes }).map(([key, value]) => [key, text(value)]));
|
|
27
|
+
const symbols = Object.values(labels);
|
|
28
|
+
if (symbols.some((symbol) => !symbol || /[\r\n]/.test(symbol))) throw new Error('지도 기호를 비워 두거나 여러 줄로 입력할 수 없습니다.');
|
|
29
|
+
if (new Set(symbols).size !== symbols.length) throw new Error('지도 기호가 중복됩니다. 지역마다 서로 다른 기호를 지정하세요.');
|
|
30
|
+
return labels;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function categoryLabels(chartRegions, regions, labels) {
|
|
34
|
+
const byName = new Map(regions.map((r) => [r.mapName, r.name]));
|
|
35
|
+
const categories = chartRegions.map((key) => Object.hasOwn(labels, key) ? labels[key] : byName.get(key));
|
|
36
|
+
if (categories.some((label) => !text(label))) throw new Error('그래프에 해당하는 지도 지역이 없습니다.');
|
|
37
|
+
if (new Set(categories).size !== categories.length) throw new Error('그래프 범주가 중복됩니다. 같은 이름의 지역에 서로 다른 기호를 지정하세요.');
|
|
38
|
+
return categories;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export function makeLinkedFigure(data, { indicator, within, breaks, top, labels = {}, title } = {}) {
|
|
42
|
+
if (!text(indicator)) throw new Error('indicator에 자료의 지표 이름을 지정하세요.');
|
|
43
|
+
if (!Array.isArray(breaks) || breaks.length < 1 || breaks.length >= CLASS_FILLS.length ||
|
|
44
|
+
breaks.some((value, i) => !Number.isFinite(value) || (i > 0 && value <= breaks[i - 1]))) {
|
|
45
|
+
throw new Error('breaks에는 유한한 숫자 1~' + (CLASS_FILLS.length - 1) + '개를 오름차순으로 지정하세요.');
|
|
46
|
+
}
|
|
47
|
+
if (top !== undefined && (!Number.isSafeInteger(top) || top < 1)) throw new Error('top에는 양의 정수를 지정하세요.');
|
|
48
|
+
if (!Array.isArray(data?.rows) || !data.rows.length) throw new Error('자료에 지역 행이 없습니다.');
|
|
49
|
+
|
|
50
|
+
const seoulDaytime = data.title === '서울 자치구 상주·주간 인구' && String(data.year) === '2020';
|
|
51
|
+
const period = String(data.year ?? '');
|
|
52
|
+
const year = Number(period.slice(0, 4));
|
|
53
|
+
const historical = year > 0 && (year < 2026 || (year === 2026 && period < '202607'));
|
|
54
|
+
const edition = String(data.mapEdition ?? (historical ? '2025' : '2026'));
|
|
55
|
+
if (!['2025', '2026'].includes(edition)) throw new Error('한국 지도 판은 2025 또는 2026을 지정하세요.');
|
|
56
|
+
const scope = within ?? (seoulDaytime ? ['서울'] : undefined);
|
|
57
|
+
if (scope !== undefined && (!Array.isArray(scope) || !scope.length || new Set(scope).size !== scope.length ||
|
|
58
|
+
scope.some((province) => !text(province)))) throw new Error('within에는 중복 없이 시·도 이름을 지정하세요.');
|
|
59
|
+
const level = scope ? 'sigungu' : 'sido';
|
|
60
|
+
const available = new Set(listRegions({ level, within: scope, edition }));
|
|
61
|
+
if (scope?.some((province) => ![...available].some((name) => name.startsWith(province + ' ')))) {
|
|
62
|
+
throw new Error('within에 해당 지도 판의 시·도 이름을 사용하세요: ' + scope.join(', '));
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
const regions = [];
|
|
66
|
+
const used = new Set();
|
|
67
|
+
const units = new Set();
|
|
68
|
+
// The bundled daytime table's unit fields are empty. Its two kinds of
|
|
69
|
+
// measures are persons and the daytime-to-resident population index.
|
|
70
|
+
const daytimeUnit = data.title === '성별/연령별 상주(야간) · 주간 인구-시군구'
|
|
71
|
+
? indicator === '주간 인구 지수' ? '지수' : /^(상주|유입 |유출 |주간 )인구/.test(indicator) ? '명' : ''
|
|
72
|
+
: '';
|
|
73
|
+
const defaultUnit = unitFor(data.unit, indicator) || daytimeUnit;
|
|
74
|
+
for (const row of data.rows) {
|
|
75
|
+
const mapName = row.mapName ?? (seoulDaytime ? '서울 ' + row.name : null);
|
|
76
|
+
if (!available.has(mapName)) continue;
|
|
77
|
+
if (used.has(mapName)) throw new Error('지도 지역의 자료가 중복됩니다: ' + mapName);
|
|
78
|
+
const value = row.values && Object.hasOwn(row.values, indicator) ? row.values[indicator] : undefined;
|
|
79
|
+
if (!Number.isFinite(value)) throw new Error(mapName + '의 지표 값이 없거나 숫자가 아닙니다: ' + indicator);
|
|
80
|
+
const rowUnit = row.unit === undefined ? defaultUnit : unitFor(row.unit, indicator);
|
|
81
|
+
if (!rowUnit) throw new Error('지표의 단위를 확인할 수 없습니다: ' + indicator);
|
|
82
|
+
units.add(rowUnit);
|
|
83
|
+
used.add(mapName);
|
|
84
|
+
regions.push({ mapName, name: text(row.name) || mapName, value });
|
|
85
|
+
}
|
|
86
|
+
if (!regions.length) throw new Error('선택한 지도 범위에서 자료와 일치하는 지역이 없습니다.');
|
|
87
|
+
if (units.size !== 1 || (defaultUnit && !units.has(defaultUnit))) throw new Error('같은 지표에 서로 다른 단위가 사용됐습니다: ' + indicator);
|
|
88
|
+
const [unit] = units;
|
|
89
|
+
const symbols = checkedLabels({}, labels, used);
|
|
90
|
+
const plotted = top === undefined ? regions : [...regions].sort((a, b) => b.value - a.value).slice(0, top);
|
|
91
|
+
const chartRegions = plotted.map((r) => r.mapName);
|
|
92
|
+
const partial = available.size > regions.length;
|
|
93
|
+
if (partial && breaks.length + 2 > CLASS_FILLS.length) {
|
|
94
|
+
throw new Error('자료가 없는 지역까지 구분하려면 breaks를 ' + (CLASS_FILLS.length - 2) + '개 이하로 지정하세요.');
|
|
95
|
+
}
|
|
96
|
+
const classes = Object.fromEntries(regions.map(({ mapName, value }) => [
|
|
97
|
+
mapName, Number(partial) + breaks.filter((threshold) => value >= threshold).length,
|
|
98
|
+
]));
|
|
99
|
+
const legend = [breaks[0] + ' 미만', ...breaks.slice(1).map((end, i) => breaks[i] + ' 이상 ' + end + ' 미만'), breaks.at(-1) + ' 이상'];
|
|
100
|
+
if (partial) legend.unshift('자료 없음');
|
|
101
|
+
const map = { region: 'korea', level, within: scope, edition, classes, legend, labels: symbols };
|
|
102
|
+
const chart = {
|
|
103
|
+
type: 'bar',
|
|
104
|
+
categories: categoryLabels(chartRegions, regions, symbols),
|
|
105
|
+
series: [{ name: indicator, values: plotted.map((r) => r.value) }],
|
|
106
|
+
unit,
|
|
107
|
+
};
|
|
108
|
+
const cite = text(data.cite);
|
|
109
|
+
const source = [cite, period && !cite.includes(period) ? period : ''].filter(Boolean).join(', ');
|
|
110
|
+
return {
|
|
111
|
+
title: text(title) || text(data.title) || indicator,
|
|
112
|
+
source,
|
|
113
|
+
parts: [{ map }, { chart }],
|
|
114
|
+
link: { version: 1, mapPart: 0, chartPart: 1, indicator, unit, regions, chartRegions },
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
const MAP_BINDING_ERROR = '저장된 지도와 그래프의 기호를 일대일로 확인할 수 없습니다. 지도와 같은 기호를 그래프에 지정하거나 연결된 그림을 새로 만드세요.';
|
|
119
|
+
|
|
120
|
+
function replaceMap(figure, partIndex, map) {
|
|
121
|
+
if (!figure.parts) return { ...figure, map };
|
|
122
|
+
return { ...figure, parts: figure.parts.map((part, i) => i === partIndex ? { ...part, map } : part) };
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
function chartLabels(chart) {
|
|
126
|
+
if (['bar', 'stacked', 'deviation'].includes(chart.type) && Array.isArray(chart.categories)) {
|
|
127
|
+
return { symbols: chart.categories, replace: (symbols) => ({ ...chart, categories: symbols }) };
|
|
128
|
+
}
|
|
129
|
+
const field = chart.type === 'climate' ? 'stations' : ['scatter', 'bubble', 'triangle'].includes(chart.type) ? 'points' : undefined;
|
|
130
|
+
if (field && Array.isArray(chart[field])) {
|
|
131
|
+
const entries = chart[field];
|
|
132
|
+
return { symbols: entries.map((entry) => entry.label), replace: (symbols) => ({
|
|
133
|
+
...chart, [field]: entries.map((entry, i) => ({ ...entry, label: symbols[i] })),
|
|
134
|
+
}) };
|
|
135
|
+
}
|
|
136
|
+
throw new Error(MAP_BINDING_ERROR);
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
export function relabelFigure(figure, { partIndex = 0, labels }) {
|
|
140
|
+
const parts = figure.parts || [figure];
|
|
141
|
+
const map = parts[partIndex]?.map;
|
|
142
|
+
if (!map) throw new Error('기호를 수정할 지도 부분이 없습니다.');
|
|
143
|
+
const current = map.labels || {};
|
|
144
|
+
const link = figure.link;
|
|
145
|
+
if (link && (link.version !== 1 || link.mapPart !== partIndex)) throw new Error(MAP_BINDING_ERROR);
|
|
146
|
+
if (link && (!Array.isArray(link.regions) || !Array.isArray(link.chartRegions))) throw new Error(MAP_BINDING_ERROR);
|
|
147
|
+
const regions = link?.regions;
|
|
148
|
+
const allowed = new Set(regions ? regions.map((r) => r.mapName) : Object.keys(current));
|
|
149
|
+
if (link && (allowed.size !== regions.length || !link.chartRegions.length ||
|
|
150
|
+
new Set(link.chartRegions).size !== link.chartRegions.length ||
|
|
151
|
+
link.chartRegions.some((name) => !allowed.has(name)))) throw new Error(MAP_BINDING_ERROR);
|
|
152
|
+
const next = checkedLabels(current, labels, allowed);
|
|
153
|
+
const result = replaceMap(figure, partIndex, { ...map, labels: next });
|
|
154
|
+
if (link) {
|
|
155
|
+
const chartPart = result.parts?.[link.chartPart];
|
|
156
|
+
if (chartPart?.chart?.type !== 'bar') throw new Error(MAP_BINDING_ERROR);
|
|
157
|
+
const categories = categoryLabels(link.chartRegions, regions, next);
|
|
158
|
+
result.parts[link.chartPart] = { ...chartPart, chart: { ...chartPart.chart, categories } };
|
|
159
|
+
return result;
|
|
160
|
+
}
|
|
161
|
+
const chartParts = parts.filter((part) => part.chart);
|
|
162
|
+
if (!chartParts.length) return result;
|
|
163
|
+
if (parts.filter((part) => part.map).length !== 1 || !figure.parts) throw new Error(MAP_BINDING_ERROR);
|
|
164
|
+
const previous = new Map(Object.entries(checkedLabels({}, current, allowed)).map(([name, symbol]) => [symbol, name]));
|
|
165
|
+
result.parts = result.parts.map((part) => {
|
|
166
|
+
if (!part.chart) return part;
|
|
167
|
+
const { symbols, replace } = chartLabels(part.chart);
|
|
168
|
+
if (!symbols.length || new Set(symbols).size !== symbols.length || symbols.some((symbol) => !previous.has(symbol))) {
|
|
169
|
+
throw new Error(MAP_BINDING_ERROR);
|
|
170
|
+
}
|
|
171
|
+
return { ...part, chart: replace(symbols.map((symbol) => next[previous.get(symbol)])) };
|
|
172
|
+
});
|
|
173
|
+
return { ...result, legacyLabelMapPart: partIndex };
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
export function figureAnswerKey(figures) {
|
|
177
|
+
const sections = [];
|
|
178
|
+
for (const [i, figure] of figures.entries()) {
|
|
179
|
+
const link = figure.link?.version === 1 ? figure.link : undefined;
|
|
180
|
+
const map = figure.parts?.[link?.mapPart ?? figure.legacyLabelMapPart]?.map;
|
|
181
|
+
if (!map?.labels) continue;
|
|
182
|
+
const labels = Object.entries(map.labels).sort(([, a], [, b]) => a.localeCompare(b, 'ko', { numeric: true }));
|
|
183
|
+
if (!labels.length) continue;
|
|
184
|
+
const entries = labels.map(([name, symbol]) => {
|
|
185
|
+
const region = link?.regions.find((r) => r.mapName === name);
|
|
186
|
+
return symbol + ' = ' + name + (region ? ' (' + link.indicator + ' ' + region.value + ' ' + link.unit + ')' : '');
|
|
187
|
+
});
|
|
188
|
+
sections.push([...(figures.length > 1 ? [(i + 1) + '. ' + (figure.title || '그림')] : []), ...entries].join('\n'));
|
|
189
|
+
}
|
|
190
|
+
return sections.length ? ['정답표', ...sections].join('\n') : undefined;
|
|
191
|
+
}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { randomBytes } from 'node:crypto';
|
|
2
|
+
|
|
3
|
+
// The remote process serves independent MCP requests. Possession of an unlisted,
|
|
4
|
+
// random handle grants access to one entry, even when teachers share a login URL.
|
|
5
|
+
export function referenceStore(limit, idBytes, now = Date.now) {
|
|
6
|
+
const entries = new Map();
|
|
7
|
+
const ttl = 30 * 60 * 1000;
|
|
8
|
+
function purge() {
|
|
9
|
+
for (const [id, entry] of entries) {
|
|
10
|
+
if (entry.expires > now()) break;
|
|
11
|
+
entries.delete(id);
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
return {
|
|
15
|
+
purge,
|
|
16
|
+
put(value) {
|
|
17
|
+
purge();
|
|
18
|
+
if (entries.size >= limit) entries.delete(entries.keys().next().value);
|
|
19
|
+
const id = randomBytes(idBytes).toString('hex');
|
|
20
|
+
entries.set(id, { value, expires: now() + ttl });
|
|
21
|
+
return id;
|
|
22
|
+
},
|
|
23
|
+
get(id) {
|
|
24
|
+
purge();
|
|
25
|
+
return entries.get(id)?.value;
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export function createReferences(remote = false) {
|
|
31
|
+
return {
|
|
32
|
+
previews: referenceStore(remote ? 128 : 8, remote ? 24 : 8),
|
|
33
|
+
datasets: referenceStore(remote ? 64 : 8, 24),
|
|
34
|
+
};
|
|
35
|
+
}
|
package/src/tools.js
CHANGED
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
import fs from 'node:fs';
|
|
3
3
|
import os from 'node:os';
|
|
4
4
|
import path from 'node:path';
|
|
5
|
-
import {
|
|
5
|
+
import { createReferences } from './references.js';
|
|
6
|
+
import { makeLinkedFigure, relabelFigure, figureAnswerKey } from './linked.js';
|
|
6
7
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
7
8
|
import { z } from 'zod';
|
|
8
9
|
import { SOURCES, findData, transform, round, assignLabels, suggestRegions, examSpots, kosisSearch, kosisItems, setKosisKey, bundleList, withKosisKey } from './data.js';
|
|
@@ -29,8 +30,8 @@ const GUIDE = `
|
|
|
29
30
|
2. find_data 로 실제 통계를 찾는다. 한국 시·도·시·군·구 통계는 먼저 list_bundled_data에 query와 summary:true를 보내 후보를 찾고, 없을 때만 KOSIS(키 필요)를 쓴다. 숫자를 지어내지 않는다. 못 찾으면 [확인 필요]로 알리고 교사에게 숫자를 받는다.
|
|
30
31
|
3. 만들기 전에 반드시 '계획 요약'을 보여 주고 교사의 "예"를 받는다:
|
|
31
32
|
지표·단위 / 기준 연도 / 지역과 기호(A~E 또는 (가)~(마)) / 가공(지수·비율·편차·반올림) / 기호 순서(무작위·북→남·서→동·지정) / 출력(PPTX·HWPX) / 출처 문구
|
|
32
|
-
4. 계획 요약과 함께 preview_figures 로 시안 그림을 보여 준다. 그림마다 기본 시안을 보여 주고, 기호를 비교할 때만 compareLabelStyles:true를 쓴다. 교사가 ‘예’라고 하면 make_figures로 만든다.
|
|
33
|
-
5.
|
|
33
|
+
4. 계획 요약과 함께 preview_figures 로 시안 그림을 보여 준다. 그림마다 기본 시안을 보여 주고, 기호를 비교할 때만 compareLabelStyles:true를 쓴다. 교사가 ‘예’라고 하면 make_figures로 만든다. 명세가 같으면 figures 대신 previewId를 쓴다. 파일 위치와 정답표를 알려 준다.
|
|
34
|
+
5. 시안의 범례·기호는 preview_figures(edit:{previewId, labels, legend})로 바꾼다. 로컬 파일은 saved로 열고, 전체 설계도는 open_figure_spec으로 읽는다. 통계를 다시 찾지 않는다. 손으로 고칠 땐 그룹 해제(개체 풀기) 한 번이면 모든 도형이 따로 움직인다고 알려 준다.
|
|
34
35
|
|
|
35
36
|
[품질 규칙 — 교사 기준 + 경기도교육청 지리 문항 제작 자료]
|
|
36
37
|
- 흑백 인쇄로 구분돼야 한다: 색 대신 빗금·회색 농도(자동).
|
|
@@ -46,12 +47,12 @@ const GUIDE = `
|
|
|
46
47
|
const INSTRUCTIONS = [
|
|
47
48
|
'지리 시험 자료는 실제 통계와 출처를 쓴다. 한국 자료는 list_bundled_data에 query와 summary:true를 보내 먼저 찾는다.',
|
|
48
49
|
'지표·연도·지역·가공·기호·출력·출처와 시안을 제시하고 교사 확인 후 make_figures를 부른다.',
|
|
49
|
-
'기호를 비교할 때만 4종 시안을 요청한다.
|
|
50
|
+
'기호를 비교할 때만 4종 시안을 요청한다. 명세가 같으면 previewId를 재사용한다.',
|
|
50
51
|
'행정구역 판은 자료 연도에 맞춘다. 정답표는 로컬 파일 마지막 장 또는 원격 응답에 둔다.',
|
|
52
|
+
'내장 한국 통계 지도+막대는 find_data(asReference:true) → preview_figures(linked) → make_figures(previewId). 시안 기호는 preview_figures(edit)로 바꾼다.',
|
|
51
53
|
'필요할 때 guide의 topic으로 workflow 또는 spec을 선택한다.',
|
|
52
54
|
].join('\n');
|
|
53
|
-
const
|
|
54
|
-
const MAX_PREVIEWS = 8;
|
|
55
|
+
const MAX_DATA_BYTES = 256 * 1024;
|
|
55
56
|
const MAX_PREVIEW_SPEC_BYTES = 64 * 1024;
|
|
56
57
|
const MAX_SAVED_SPEC_BYTES = 512 * 1024;
|
|
57
58
|
const figureSpecs = z.array(z.object({ title: z.string().optional() }).passthrough());
|
|
@@ -70,20 +71,36 @@ const savedEdit = z.strictObject({
|
|
|
70
71
|
part: z.number().int().positive().optional().describe('자료 번호(1부터), 그림에 지도가 여러 개면 필수'),
|
|
71
72
|
legend: z.array(z.string()).max(6).optional().describe('범례 문구를 단계 순서대로 지정. []로 삭제'),
|
|
72
73
|
labelStyle: z.enum(['halo', 'plain', 'box', 'circle']).optional(),
|
|
73
|
-
labels: z.record(z.string(), z.string().min(1)).optional().describe('
|
|
74
|
+
labels: z.record(z.string(), z.string().min(1)).optional().describe('지도 지역명과 새 기호. 연결된 그림에는 기호 추가 가능'),
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
const editFields = savedEdit.omit({ name: true, path: true });
|
|
78
|
+
const linkedFigure = z.strictObject({
|
|
79
|
+
dataId: z.string(),
|
|
80
|
+
indicator: z.string(),
|
|
81
|
+
within: z.array(z.string()).min(1).optional().describe('시·군·구 지도 범위. 생략하면 전국 시·도(서울 전용 자료는 서울 자치구)'),
|
|
82
|
+
breaks: z.array(z.number()).min(1).max(5).describe('단계 하한값 목록(오름차순). 예: [100]'),
|
|
83
|
+
top: z.number().int().positive().optional().describe('막대만 상위 N곳으로 제한'),
|
|
84
|
+
labels: z.record(z.string(), z.string().min(1)).optional().describe('mapName별 기호'),
|
|
85
|
+
title: z.string().optional(),
|
|
74
86
|
});
|
|
75
87
|
|
|
76
88
|
function editSavedMap(edit) {
|
|
77
|
-
const { name, path: file
|
|
89
|
+
const { name, path: file } = edit;
|
|
78
90
|
if ((name === undefined) === (file === undefined)) throw new Error('name 또는 path 하나를 지정하세요.');
|
|
79
91
|
if (name && (path.basename(name) !== name || /[\\/:]/.test(name) || name === '.' || name === '..')) throw new Error('name은 확장자 없는 파일 이름만 지정하세요.');
|
|
80
92
|
const source = file || path.join(OUT, name + '.geo-figure.json');
|
|
81
93
|
if (!source.endsWith('.geo-figure.json')) throw new Error('.geo-figure.json 설계도 파일을 지정하세요.');
|
|
82
94
|
if (fs.statSync(source).size > MAX_SAVED_SPEC_BYTES) throw new Error('저장된 설계도가 너무 큽니다. open_figure_spec으로 수정하세요.');
|
|
83
|
-
if (legend === undefined && labelStyle === undefined && !Object.keys(labels || {}).length) throw new Error('범례 또는 기호 변경을 지정하세요.');
|
|
84
95
|
const saved = JSON.parse(fs.readFileSync(source, 'utf8'));
|
|
85
96
|
const figures = figureSpecs.min(1).parse(saved.figures);
|
|
86
97
|
const style = figureStyle.optional().parse(saved.style);
|
|
98
|
+
return { ...editMap(figures, edit), style };
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
function editMap(sourceFigures, { figure, part, legend, labelStyle, labels }) {
|
|
102
|
+
if (legend === undefined && labelStyle === undefined && !Object.keys(labels || {}).length) throw new Error('범례 또는 기호 변경을 지정하세요.');
|
|
103
|
+
const figures = [...sourceFigures];
|
|
87
104
|
if (!figure && figures.length !== 1) throw new Error('수정할 그림 번호(figure)를 지정하세요.');
|
|
88
105
|
const index = (figure || 1) - 1;
|
|
89
106
|
const target = figures[index];
|
|
@@ -94,20 +111,18 @@ function editSavedMap(edit) {
|
|
|
94
111
|
const partIndex = part ? part - 1 : mapIndexes[0];
|
|
95
112
|
if (!mapIndexes.includes(partIndex)) throw new Error('해당 자료에 수정 가능한 지도가 없습니다.');
|
|
96
113
|
const map = parts[partIndex].map;
|
|
97
|
-
const unknown = Object.keys(labels || {}).find((key) => !Object.hasOwn(map.labels || {}, key));
|
|
98
|
-
if (unknown !== undefined) throw new Error('지도에 기존 기호가 없는 지역: ' + unknown);
|
|
99
114
|
const changed = { ...parts[partIndex], map: { ...map,
|
|
100
115
|
...(legend !== undefined ? { legend } : {}),
|
|
101
116
|
...(labelStyle !== undefined ? { labelStyle } : {}),
|
|
102
|
-
...(labels ? { labels: { ...map.labels, ...labels } } : {}),
|
|
103
117
|
} };
|
|
104
118
|
figures[index] = target.parts ? { ...target, parts: parts.map((item, i) => i === partIndex ? changed : item) } : changed;
|
|
105
|
-
|
|
119
|
+
if (labels && Object.keys(labels).length) figures[index] = relabelFigure(figures[index], { partIndex, labels });
|
|
120
|
+
return { figures, index };
|
|
106
121
|
}
|
|
107
122
|
|
|
108
|
-
export function createServer({ remote = false, publish = null } = {}) {
|
|
123
|
+
export function createServer({ remote = false, publish = null, references = createReferences(remote) } = {}) {
|
|
109
124
|
const server = new McpServer({ name: 'geo-figure-mcp', version: PKG_VERSION }, { instructions: INSTRUCTIONS });
|
|
110
|
-
const previews =
|
|
125
|
+
const { previews, datasets } = references;
|
|
111
126
|
const ok = (obj) => ({ content: [{ type: 'text', text: typeof obj === 'string' ? obj : JSON.stringify(obj) }] });
|
|
112
127
|
const fail = (e) => ({ isError: true, content: [{ type: 'text', text: '오류: ' + (e.message || e) }] });
|
|
113
128
|
const wrap = (fn) => async (a) => { try { return ok(await fn(a)); } catch (e) { return fail(e); } };
|
|
@@ -127,7 +142,7 @@ server.tool('list_sources', '쓸 수 있는 통계 자료원과 지표 예시를
|
|
|
127
142
|
server.tool('find_data', '실제 통계를 찾는다. 결과에 출처(cite)와 연도가 붙는다. 숫자를 지어내지 말고 이 결과만 쓴다.', {
|
|
128
143
|
source: z.enum(remote ? Object.keys(SOURCES).filter((k) => k !== 'kosis') : Object.keys(SOURCES)).describe(remote ? '자료원 (원격 서버에서는 KOSIS 직접 조회를 쓰지 않는다 — 내장 자료 bundle 을 쓴다)' : '자료원'),
|
|
129
144
|
indicators: z.array(z.string()).default([]).describe('지표 코드 또는 열 이름. 서울: 주간인구지수 등. 기후: temp(기온), precip(강수량). 서울·기후는 비우면 전체'),
|
|
130
|
-
regions: z.array(z.string()).default([]).describe('나라 ISO3(KOR, JPN…, 세계=WLD) / 기후:
|
|
145
|
+
regions: z.array(z.string()).default([]).describe('나라 ISO3(KOR, JPN…, 세계=WLD) / 기후: 국내 도시·기출 지점 한글 이름·관측소 영문 이름·"위도,경도" / 서울 자치구 이름'),
|
|
131
146
|
kosis: z.object({ orgId: z.string().optional(), tblId: z.string().optional(), itmId: z.string().optional(), objL1: z.string().optional(), objL2: z.string().optional(), year: z.number().optional() }).passthrough().optional().describe('source 가 kosis 일 때: { orgId, tblId, itmId, objL1:"ALL", objL2, year }'),
|
|
132
147
|
bundle: z.object({
|
|
133
148
|
key: z.string(),
|
|
@@ -139,7 +154,17 @@ server.tool('find_data', '실제 통계를 찾는다. 결과에 출처(cite)와
|
|
|
139
154
|
}).passthrough().optional().describe('source가 bundle일 때 사용. 지도와 그래프에 필요한 항목과 지역만 요청한다.'),
|
|
140
155
|
year: z.number().optional().describe('특정 연도. 비우면 가장 최근'),
|
|
141
156
|
years: z.boolean().optional().describe('true 면 연도별 전체(시계열)'),
|
|
142
|
-
|
|
157
|
+
asReference: z.boolean().optional().describe('내장 시·도·시군구 또는 서울 통계로 지도+막대를 만들 때 true. 행 대신 dataId를 반환'),
|
|
158
|
+
}, wrap(async (a) => {
|
|
159
|
+
if (remote && a.source === 'kosis') throw new Error('원격 서버에서는 내장 자료 bundle을 쓰세요. KOSIS 직접 조회는 로컬에서 가능합니다.');
|
|
160
|
+
if (a.asReference && !['bundle', 'seoul-daytime'].includes(a.source)) throw new Error('dataId는 bundle 또는 seoul-daytime 통계에서 지원합니다.');
|
|
161
|
+
const data = await findData(a);
|
|
162
|
+
if (!a.asReference) return data;
|
|
163
|
+
if (!data.rows.length) throw new Error('선택한 조건에 통계 행이 없습니다.');
|
|
164
|
+
if (Buffer.byteLength(JSON.stringify(data)) > MAX_DATA_BYTES) throw new Error('참조할 통계가 너무 큽니다. 지표·지역을 좁혀 주세요.');
|
|
165
|
+
const { title, year, unit, cite, mapEdition } = data;
|
|
166
|
+
return { dataId: datasets.put(data), rowCount: data.rows.length, title, year, unit, cite, mapEdition, indicators: Object.keys(data.rows[0].values) };
|
|
167
|
+
}));
|
|
143
168
|
|
|
144
169
|
server.tool('list_exam_climate_spots', '평가원 기후 기출 지점. 후보 이름과 기후 기호만 필요하면 summary:true를 쓴다.', {
|
|
145
170
|
code: z.string().optional().describe("기후 기호로 거르기. 예: 'Cs', 'BW', 'Df'"),
|
|
@@ -211,11 +236,9 @@ server.tool('assign_labels', '지역 이름을 A~E 또는 (가)~(마) 기호로
|
|
|
211
236
|
}, wrap((a) => assignLabels(a.names, a)));
|
|
212
237
|
|
|
213
238
|
server.tool('make_figures', '그림 명세로 PPTX·HWPX 파일을 만든다. 만들기 전에 교사에게 계획 요약을 보여 주고 확인을 받았는지 먼저 확인한다. 명세 작성법은 guide.', {
|
|
214
|
-
figures:
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
labelStyle: z.enum(['halo', 'plain', 'box', 'circle']).optional().describe('기호 비교 시안에서 교사가 선택한 스타일'),
|
|
218
|
-
}),
|
|
239
|
+
figures: figureSpecs.optional().describe('그림 명세 목록. guide의 spec 참고'),
|
|
240
|
+
previewId: z.string().optional().describe('확인한 시안 ID. figures 대신 사용'),
|
|
241
|
+
labelStyle: z.enum(['halo', 'plain', 'box', 'circle']).optional().describe('기호 비교 시안에서 교사가 선택한 스타일'),
|
|
219
242
|
name: z.string().default('지리자료').describe('파일 이름(확장자 제외)'),
|
|
220
243
|
formats: z.array(z.enum(['pptx', 'hwpx'])).default(['pptx', 'hwpx']),
|
|
221
244
|
answerKey: z.string().optional().describe(remote ? '정답표 — 원격 서버에서는 파일에 넣지 않고 대화창에만 돌려준다(시험 보안)' : '정답표 — 파일 마지막 장에 들어간다. 첫 줄은 제목'),
|
|
@@ -229,8 +252,7 @@ server.tool('make_figures', '그림 명세로 PPTX·HWPX 파일을 만든다.
|
|
|
229
252
|
if (a.previewId !== undefined) {
|
|
230
253
|
if (figures !== undefined || style !== undefined) throw new Error('previewId는 figures 또는 style과 함께 쓸 수 없습니다. 명세를 바꾸려면 새 시안을 만드세요.');
|
|
231
254
|
const preview = previews.get(a.previewId);
|
|
232
|
-
if (!preview
|
|
233
|
-
previews.delete(a.previewId);
|
|
255
|
+
if (!preview) {
|
|
234
256
|
throw new Error('시안 ID가 만료되었거나 없습니다. 다시 시안을 만들거나 원래 figures를 보내세요.');
|
|
235
257
|
}
|
|
236
258
|
if (a.labelStyle && preview.compareIndex < 0) throw new Error('labelStyle은 기호 비교 시안 ID와 함께 쓸 수 있습니다.');
|
|
@@ -238,7 +260,7 @@ server.tool('make_figures', '그림 명세로 PPTX·HWPX 파일을 만든다.
|
|
|
238
260
|
({ figures, style, st } = preview);
|
|
239
261
|
if (a.labelStyle) figures = figures.map((f, i) => i === preview.compareIndex ? withLabelStyle(f, a.labelStyle) : f);
|
|
240
262
|
} else if (!figures || a.labelStyle !== undefined) {
|
|
241
|
-
throw new Error('figures 또는
|
|
263
|
+
throw new Error('figures 또는 previewId를 보내세요. labelStyle은 지도 명세 안에 지정할 수 있습니다.');
|
|
242
264
|
}
|
|
243
265
|
if (remote && figures.length > 12) throw new Error('한 번에 그림은 12장까지 만들 수 있습니다.');
|
|
244
266
|
st ??= { ...loadStyle(), ...style };
|
|
@@ -246,29 +268,48 @@ server.tool('make_figures', '그림 명세로 PPTX·HWPX 파일을 만든다.
|
|
|
246
268
|
for (const f of figures) figs.push(await makeFigure(f, st));
|
|
247
269
|
const safe = String(a.name || '지리자료').replace(/[\/:*?"<>|]/g, '_').slice(0, 60);
|
|
248
270
|
const dir = remote ? publish.newDir() : (a.outDir || OUT);
|
|
249
|
-
const
|
|
271
|
+
const answerKey = [a.answerKey, figureAnswerKey(figures)].filter(Boolean).join('\n') || undefined;
|
|
272
|
+
const paths = exportFigures(figs, { outDir: dir, name: safe, formats: a.formats, answerKey: remote ? undefined : answerKey, style: st });
|
|
250
273
|
const files = remote ? paths.map((p) => publish.url(p)) : paths;
|
|
251
274
|
// 고치기용 설계도: 같은 폴더에 <이름>.geo-figure.json — 나중에 open_figure_spec 으로 읽어 일부만 바꿔 다시 만든다
|
|
252
275
|
let specFile = null;
|
|
253
276
|
if (!remote) { specFile = path.join(dir, `${safe}.geo-figure.json`); fs.writeFileSync(specFile, JSON.stringify({ name: safe, formats: a.formats, style, answerKey: a.answerKey, figures }, null, 1)); }
|
|
254
|
-
return { files, ...(updateNotice() ? { update: updateNotice() } : {}), ...(remote ? { expires: `내려받기 주소는 ${publish.keepText} 동안, 한 번만 열립니다(받으면 서버에서 바로 지움). 꼭 내려받아 저장하세요.`, ...(
|
|
277
|
+
return { files, ...(updateNotice() ? { update: updateNotice() } : {}), ...(remote ? { expires: `내려받기 주소는 ${publish.keepText} 동안, 한 번만 열립니다(받으면 서버에서 바로 지움). 꼭 내려받아 저장하세요.`, ...(answerKey ? { answerKey, answerKeyNote: '시험 보안을 위해 정답표는 파일에 넣지 않았습니다. 이 내용을 교사에게 그대로 보여 주세요.' } : {}) } : {}), sizes_mm: figs.map((f) => ({ title: f.title, w: round(f.w), h: round(f.h) })), ...(specFile ? { specFile } : {}), note: '그림마다 묶음 하나 — PPTX는 그룹 해제, HWPX는 개체 풀기를 한 번만 하면 시군구·기호·선·범례가 모두 따로 움직인다(도형 이름이 지역 이름). 범례 칸과 지역은 같은 무늬라 서식 복사로 단계를 바꿀 수 있다. 시안의 범례·기호는 preview_figures의 edit로 바꿀 수 있다.' };
|
|
255
278
|
}));
|
|
256
279
|
|
|
257
|
-
server.tool('preview_figures', '파일을 만들기 전 PNG 시안을 보여 준다. 기호 비교가 필요하면 compareLabelStyles:true를 쓴다.
|
|
258
|
-
figures:
|
|
280
|
+
server.tool('preview_figures', '파일을 만들기 전 PNG 시안을 보여 준다. 기호 비교가 필요하면 compareLabelStyles:true를 쓴다. previewId는 make_figures에서 재사용할 수 있다.', {
|
|
281
|
+
figures: figureSpecs.optional().describe('make_figures와 같은 그림 명세'),
|
|
282
|
+
linked: linkedFigure.optional().describe('find_data의 dataId로 같은 통계의 지도와 막대를 함께 생성'),
|
|
283
|
+
edit: editFields.extend({ previewId: z.string() }).optional().describe('기존 시안의 범례·기호를 수정한다'),
|
|
259
284
|
...(remote ? {} : { saved: savedEdit.optional().describe('로컬 설계도에서 범례·기호만 수정. figures 대신 사용') }),
|
|
260
285
|
compareLabelStyles: z.boolean().optional().describe('true면 첫 지도에 기호 스타일 4개를 비교'),
|
|
261
286
|
style: figureStyle.optional(),
|
|
262
287
|
}, async (a) => {
|
|
263
288
|
try {
|
|
264
289
|
let { figures, style } = a;
|
|
265
|
-
let savedIndex;
|
|
290
|
+
let savedIndex, inheritedStyle;
|
|
291
|
+
const inputs = [figures, a.saved, a.linked, a.edit].filter(v => v !== undefined);
|
|
292
|
+
if (inputs.length !== 1) throw new Error('figures, linked, edit 또는 로컬 saved 중 하나만 지정하세요.');
|
|
293
|
+
if (a.linked) {
|
|
294
|
+
const data = datasets.get(a.linked.dataId);
|
|
295
|
+
if (!data) throw new Error('통계 ID가 만료되었거나 없습니다. find_data를 다시 호출하세요.');
|
|
296
|
+
figures = [makeLinkedFigure(data, a.linked)];
|
|
297
|
+
}
|
|
298
|
+
if (a.edit) {
|
|
299
|
+
if (style || a.compareLabelStyles) throw new Error('edit는 style 또는 기호 비교와 함께 쓸 수 없습니다.');
|
|
300
|
+
const previous = previews.get(a.edit.previewId);
|
|
301
|
+
if (!previous) throw new Error('시안 ID가 만료되었거나 없습니다. 시안을 다시 만드세요.');
|
|
302
|
+
if (previous.compareIndex >= 0) throw new Error('기호 비교 시안은 편집 전에 일반 시안으로 만드세요.');
|
|
303
|
+
({ figures, index: savedIndex } = editMap(previous.figures, a.edit));
|
|
304
|
+
style = previous.style;
|
|
305
|
+
inheritedStyle = previous.st;
|
|
306
|
+
}
|
|
266
307
|
if (a.saved) {
|
|
267
308
|
if (figures || style || a.compareLabelStyles) throw new Error('saved는 figures, style, 기호 비교와 함께 쓸 수 없습니다.');
|
|
268
309
|
({ figures, style, index: savedIndex } = editSavedMap(a.saved));
|
|
269
310
|
}
|
|
270
311
|
if (!figures) throw new Error('figures 또는 saved를 지정하세요.');
|
|
271
|
-
const st = { ...loadStyle(), ...style };
|
|
312
|
+
const st = inheritedStyle || { ...loadStyle(), ...style };
|
|
272
313
|
const content = [];
|
|
273
314
|
const compareIndex = a.compareLabelStyles && figures.length ? Math.max(0, figures.findIndex(hasMap)) : -1;
|
|
274
315
|
const caption = (f, i) => ({ cap: '시안 ' + (i + 1) + ': ' + (f.title || ''), spec: f });
|
|
@@ -284,14 +325,13 @@ server.tool('preview_figures', '파일을 만들기 전 PNG 시안을 보여 준
|
|
|
284
325
|
const maxBytes = a.saved ? MAX_SAVED_SPEC_BYTES : MAX_PREVIEW_SPEC_BYTES;
|
|
285
326
|
const canReuse = Buffer.byteLength(JSON.stringify({ figures, style })) <= maxBytes;
|
|
286
327
|
if (a.saved && !canReuse) throw new Error('수정된 설계도가 너무 큽니다. open_figure_spec으로 수정하세요.');
|
|
287
|
-
if (
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
previews.set(id, { figures, style, st, compareIndex, expires: Date.now() + PREVIEW_TTL_MS });
|
|
328
|
+
if ((a.linked || a.edit) && !canReuse) throw new Error('시안이 너무 큽니다. 지역 수를 줄여 다시 만드세요.');
|
|
329
|
+
if (list.length && (savedIndex !== undefined || allFiguresShown) && canReuse) {
|
|
330
|
+
const id = previews.put({ figures, style, st, compareIndex });
|
|
291
331
|
how += '\npreviewId: ' + id + '\nmake_figures에 figures 대신 이 ID를 보내세요.';
|
|
292
332
|
if (compareIndex >= 0) how += ' 선택한 labelStyle도 보내세요.';
|
|
293
333
|
if (a.saved) how += ' 저장할 때 새 파일 이름과 출력 형식을 지정하세요.';
|
|
294
|
-
if (a.saved?.labels) how += '
|
|
334
|
+
if (a.saved?.labels || a.edit?.labels) how += ' 연결된 그래프 기호와 지역 대응표도 함께 갱신됩니다. 직접 작성한 해설은 확인하세요.';
|
|
295
335
|
} else {
|
|
296
336
|
how += ' make_figures에 figures를 보내세요.';
|
|
297
337
|
}
|