korean-stats-mcp 1.4.0

package/dist/tools/getStatisticsList.js

@@ -0,0 +1,336 @@
+/**
+ * 통계 목록 조회 도구
+ * 주제별/기관별 트리 탐색 + 9개 분야 추천 카드 통합 (recommendedTopic 옵션)
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { config } from '../config/index.js';
+// ═══════════════════════════════════════════════════════════
+// 추천 통계 (이전 get_recommended_statistics 흡수)
+// ═══════════════════════════════════════════════════════════
+const PRIORITY_TABLES = {
+    population: [
+        { orgId: '101', tableId: 'DT_1B04005', name: '시도/성/연령별 주민등록인구' },
+        { orgId: '101', tableId: 'DT_1IN1503', name: '주민등록인구현황' },
+        { orgId: '101', tableId: 'DT_1B8000H', name: '인구동태건수 (출생/사망)' },
+        { orgId: '101', tableId: 'DT_1B81A17', name: '합계출산율' },
+        { orgId: '101', tableId: 'DT_1BPA002', name: '주요인구지표' },
+    ],
+    economy: [
+        { orgId: '301', tableId: 'DT_200Y001', name: '국내총생산(GDP)' },
+        { orgId: '101', tableId: 'DT_1J20001', name: '소비자물가지수' },
+        { orgId: '101', tableId: 'DT_1J22001', name: '소비자물가 등락률' },
+        { orgId: '301', tableId: 'DT_2AS004', name: '경제성장률' },
+    ],
+    employment: [
+        { orgId: '101', tableId: 'DT_1DA7102S', name: '성/연령별 실업률' },
+        { orgId: '101', tableId: 'DT_1DA7001', name: '경제활동인구총괄' },
+        { orgId: '101', tableId: 'DT_1DA7012', name: '취업자수' },
+        { orgId: '118', tableId: 'DT_118N_PAYM02', name: '평균임금' },
+    ],
+    housing: [
+        { orgId: '116', tableId: 'DT_1YL21101', name: '아파트 매매/전세 가격지수' },
+        { orgId: '116', tableId: 'DT_1YL20111E', name: '주택매매가격지수' },
+        { orgId: '101', tableId: 'DT_1YL20001', name: '주택수' },
+    ],
+    education: [
+        { orgId: '101', tableId: 'DT_1YL21121', name: '학생수' },
+        { orgId: '101', tableId: 'DT_1YL21131', name: '학교수' },
+    ],
+    health: [
+        { orgId: '101', tableId: 'DT_1B41', name: '기대수명' },
+        { orgId: '101', tableId: 'DT_1B34E01', name: '사망원인' },
+    ],
+    environment: [
+        { orgId: '106', tableId: 'DT_106N_99_2400001', name: '미세먼지 농도' },
+    ],
+    transport: [
+        { orgId: '101', tableId: 'DT_1YL12001', name: '자동차등록현황' },
+    ],
+    social: [
+        { orgId: '101', tableId: 'DT_1YL13001', name: '범죄발생 현황' },
+    ],
+};
+const TOPIC_RECOMMENDATIONS = {
+    population: {
+        name: '인구',
+        description: '인구수, 출생, 사망, 혼인, 이혼 등',
+        searchTerms: ['주민등록인구', '출생', '사망', '혼인', '합계출산율'],
+    },
+    economy: {
+        name: '경제',
+        description: 'GDP, 물가, 수출입, 경제성장률 등',
+        searchTerms: ['GDP', '경제성장률', '소비자물가', '수출', '무역수지'],
+    },
+    employment: {
+        name: '고용/노동',
+        description: '취업자, 실업률, 임금, 근로시간 등',
+        searchTerms: ['취업자', '실업률', '고용률', '임금', '근로시간'],
+    },
+    housing: {
+        name: '주거/부동산',
+        description: '주택가격, 전월세, 주거환경 등',
+        searchTerms: ['아파트가격', '전세', '주택매매', '월세', '주거'],
+    },
+    education: {
+        name: '교육',
+        description: '학생수, 학교, 진학률, 사교육비 등',
+        searchTerms: ['학생수', '학교', '진학률', '사교육비', '대학'],
+    },
+    health: {
+        name: '보건/의료',
+        description: '기대수명, 의료비, 건강보험 등',
+        searchTerms: ['기대수명', '의료비', '건강보험', '병원', '사망원인'],
+    },
+    environment: {
+        name: '환경',
+        description: '대기질, 미세먼지, 폐기물, 에너지 등',
+        searchTerms: ['미세먼지', '대기오염', '폐기물', '재활용', '탄소배출'],
+    },
+    transport: {
+        name: '교통',
+        description: '자동차, 대중교통, 도로, 사고 등',
+        searchTerms: ['자동차등록', '대중교통', '교통사고', '도로'],
+    },
+    social: {
+        name: '사회/복지',
+        description: '사회보장, 범죄, 안전, 문화 등',
+        searchTerms: ['사회보장', '범죄', '안전', '문화', '여가'],
+    },
+};
+const RELATED_TOPICS = {
+    population: ['economy', 'housing', 'social'],
+    economy: ['employment', 'housing', 'transport'],
+    employment: ['economy', 'education', 'social'],
+    housing: ['economy', 'population', 'transport'],
+    education: ['employment', 'social', 'population'],
+    health: ['social', 'environment', 'population'],
+    environment: ['health', 'transport', 'economy'],
+    transport: ['environment', 'housing', 'economy'],
+    social: ['health', 'education', 'population'],
+};
+export const getStatisticsListSchema = {
+    name: 'get_statistics_list',
+    description: '[목록탐색] 주제별/기관별/지방지표/국제/북한 통계 트리 탐색 + 9개 분야 추천 카드 통합. recommendedTopic 옵션 사용 시 추천 카드(분야별 핵심 통계표 5개) 반환. parentId로 트리 단계별 진입. "무엇을 봐야 할지 모를 때" recommendedTopic 사용.',
+    inputSchema: z.object({
+        viewCode: z
+            .string()
+            .transform((val) => {
+            if (!val || val.trim() === '')
+                return 'MT_ZTITLE';
+            return val;
+        })
+            .pipe(z.enum([
+            'MT_ZTITLE',
+            'MT_OTITLE',
+            'MT_GTITLE01',
+            'MT_GTITLE02',
+            'MT_RTITLE',
+            'MT_BUKHAN',
+            'MT_TM1_TITLE',
+            'MT_TM2_TITLE',
+        ]))
+            .describe('서비스뷰 코드: MT_ZTITLE(주제별, 기본값), MT_OTITLE(기관별), MT_GTITLE01(e-지방지표 주제별), MT_GTITLE02(e-지방지표 지역별), MT_RTITLE(국제통계), MT_BUKHAN(북한통계)'),
+        parentId: z
+            .string()
+            .optional()
+            .default('')
+            .describe('상위 목록 ID (비어있으면 최상위 목록 조회). recommendedTopic 사용 시 무시됨.'),
+        recommendedTopic: z
+            .enum([
+            'population',
+            'economy',
+            'employment',
+            'housing',
+            'education',
+            'health',
+            'environment',
+            'transport',
+            'social',
+        ])
+            .optional()
+            .describe('[추천 모드] 9개 분야 추천 카드. 지정 시 트리 탐색 대신 분야별 핵심 통계표 반환. population(인구), economy(경제), employment(고용), housing(주거), education(교육), health(보건), environment(환경), transport(교통), social(사회)'),
+        limit: z
+            .number()
+            .min(1)
+            .max(20)
+            .optional()
+            .default(5)
+            .describe('recommendedTopic 사용 시 추천 개수 (기본 5)'),
+    }),
+};
+export async function getStatisticsList(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    // 추천 모드 — 9개 분야 카드
+    if (input.recommendedTopic) {
+        const topicInfo = TOPIC_RECOMMENDATIONS[input.recommendedTopic];
+        if (!topicInfo) {
+            return {
+                success: false,
+                mode: 'recommended',
+                topic: { code: input.recommendedTopic, name: '알 수 없음', description: '' },
+                recommendations: [],
+                relatedTopics: [],
+                searchSuggestions: [],
+            };
+        }
+        try {
+            const limit = input.limit ?? 5;
+            const recommendations = [];
+            const priorityTables = PRIORITY_TABLES[input.recommendedTopic] || [];
+            for (const table of priorityTables) {
+                if (recommendations.length >= limit)
+                    break;
+                recommendations.push({
+                    orgId: table.orgId,
+                    orgName: table.orgId === '101'
+                        ? '통계청'
+                        : table.orgId === '301'
+                            ? '한국은행'
+                            : table.orgId === '116'
+                                ? '한국부동산원'
+                                : '기타기관',
+                    tableId: table.tableId,
+                    tableName: table.name,
+                    statisticsName: topicInfo.name + ' 통계',
+                    period: '',
+                    periodType: '',
+                    lastUpdated: '',
+                    isPriority: true,
+                });
+            }
+            if (recommendations.length < limit) {
+                const searchResults = await cache.getSearchResults({ topic: input.recommendedTopic, limit }, async () => {
+                    const allResults = [];
+                    for (const term of topicInfo.searchTerms.slice(0, 2)) {
+                        const results = await client.searchStatistics(term, {
+                            sort: 'RANK',
+                            startCount: 1,
+                            resultCount: Math.ceil(limit / 2),
+                        });
+                        allResults.push(...results);
+                    }
+                    return allResults;
+                });
+                const addedTableIds = new Set(recommendations.map((r) => r.tableId));
+                for (const item of searchResults) {
+                    if (recommendations.length >= limit)
+                        break;
+                    if (addedTableIds.has(item.TBL_ID))
+                        continue;
+                    recommendations.push({
+                        orgId: item.ORG_ID,
+                        orgName: item.ORG_NM,
+                        tableId: item.TBL_ID,
+                        tableName: item.TBL_NM,
+                        statisticsName: item.STAT_NM,
+                        period: item.STRT_PRD_DE && item.END_PRD_DE
+                            ? `${item.STRT_PRD_DE}~${item.END_PRD_DE}`
+                            : item.STRT_PRD_DE || item.END_PRD_DE || '',
+                        periodType: item.VW_CD || '',
+                        lastUpdated: item.END_PRD_DE,
+                    });
+                    addedTableIds.add(item.TBL_ID);
+                }
+            }
+            return {
+                success: true,
+                mode: 'recommended',
+                topic: {
+                    code: input.recommendedTopic,
+                    name: topicInfo.name,
+                    description: topicInfo.description,
+                },
+                recommendations,
+                relatedTopics: RELATED_TOPICS[input.recommendedTopic] || [],
+                searchSuggestions: topicInfo.searchTerms,
+            };
+        }
+        catch (error) {
+            console.error('Recommendation error:', error);
+            return {
+                success: false,
+                mode: 'recommended',
+                topic: {
+                    code: input.recommendedTopic,
+                    name: topicInfo.name,
+                    description: topicInfo.description,
+                },
+                recommendations: [],
+                relatedTopics: [],
+                searchSuggestions: topicInfo.searchTerms,
+            };
+        }
+    }
+    // 일반 트리 탐색 모드
+    const viewName = config.viewCodes[input.viewCode] || input.viewCode;
+    try {
+        const results = await cache.getStatisticsList({ viewCode: input.viewCode, parentId: input.parentId }, async () => {
+            return client.getStatisticsList(input.viewCode, input.parentId);
+        });
+        const items = results.map((item) => {
+            const isTable = !!item.TBL_ID;
+            return {
+                id: isTable ? item.TBL_ID : item.LIST_ID,
+                name: isTable ? item.TBL_NM : item.LIST_NM,
+                isTable,
+                orgId: item.ORG_ID,
+                tableId: item.TBL_ID,
+                tableName: item.TBL_NM,
+            };
+        });
+        const hasMore = items.some((item) => !item.isTable);
+        const canGoUp = input.parentId !== '';
+        return {
+            success: true,
+            viewName,
+            parentId: input.parentId,
+            items,
+            hasMore,
+            navigation: {
+                canGoUp,
+                instruction: hasMore
+                    ? '폴더 ID를 parentId로 전달하면 하위 목록을 조회할 수 있습니다. 또는 recommendedTopic 옵션으로 분야별 추천 카드 사용.'
+                    : '통계표 ID와 기관 ID를 사용하여 get_statistics_data로 데이터를 조회하세요.',
+            },
+        };
+    }
+    catch (error) {
+        console.error('List error:', error);
+        return {
+            success: false,
+            viewName,
+            parentId: input.parentId,
+            items: [],
+            hasMore: false,
+        };
+    }
+}
+/**
+ * 사용 가능한 서비스뷰 목록 반환
+ */
+export function getAvailableViewCodes() {
+    return [
+        { code: 'MT_ZTITLE', name: '국내통계 주제별', description: '주제(인구, 경제 등)로 분류된 국내 통계' },
+        { code: 'MT_OTITLE', name: '국내통계 기관별', description: '작성기관별로 분류된 국내 통계' },
+        { code: 'MT_GTITLE01', name: 'e-지방지표(주제별)', description: '지방자치단체 통계 (주제별)' },
+        { code: 'MT_GTITLE02', name: 'e-지방지표(지역별)', description: '지방자치단체 통계 (지역별)' },
+        { code: 'MT_RTITLE', name: '국제통계', description: 'OECD, UN 등 국제기구 통계' },
+        { code: 'MT_BUKHAN', name: '북한통계', description: '북한 관련 통계' },
+        { code: 'MT_TM1_TITLE', name: '대상별통계', description: '여성, 청소년, 고령자 등 대상별 통계' },
+        { code: 'MT_TM2_TITLE', name: '이슈별통계', description: '사회적 이슈별 통계' },
+    ];
+}
+/**
+ * 추천 토픽 목록 (이전 getAvailableTopics와 동일)
+ */
+export function getAvailableRecommendedTopics() {
+    return Object.entries(TOPIC_RECOMMENDATIONS).map(([code, info]) => ({
+        code,
+        name: info.name,
+        description: info.description,
+    }));
+}
+//# sourceMappingURL=getStatisticsList.js.map

package/dist/tools/getStatisticsList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStatisticsList.js","sourceRoot":"","sources":["../../src/tools/getStatisticsList.ts"],"names":[],"mappings":"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"}

package/dist/tools/getTableInfo.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 통계표 분류·항목 메타 조회 (경량)
+ *
+ * 응답 크기가 컸던 이전 구현은 raw 메타를 통째로 반환하여 클라이언트(Cursor 등)를
+ * 초기화시키는 문제가 있었다. 이번에는 OBJ_NM 그룹별로 샘플 N개(기본 10)만 노출하고
+ * `filter`로 ITM_NM 부분일치 검색을 지원한다.
+ *
+ * 사용 예: "광진구" 코드를 찾을 때
+ *   get_table_info({ orgId: "201", tblId: "DT_201004_O110054", filter: "광진구" })
+ */
+import { z } from 'zod';
+export declare const getTableInfoSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        orgId: z.ZodString;
+        tableId: z.ZodString;
+        filter: z.ZodOptional<z.ZodString>;
+        sampleSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        orgId: string;
+        tableId: string;
+        sampleSize: number;
+        filter?: string | undefined;
+    }, {
+        orgId: string;
+        tableId: string;
+        filter?: string | undefined;
+        sampleSize?: number | undefined;
+    }>;
+};
+export type GetTableInfoInput = z.infer<typeof getTableInfoSchema.inputSchema>;
+export declare function getTableInfo(input: GetTableInfoInput): Promise<{
+    success: boolean;
+    orgId: string;
+    tableId: string;
+    usageHint: string;
+    groups?: undefined;
+    hint?: undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    orgId: string;
+    tableId: string;
+    groups: {
+        objNm: string;
+        objIdSn: string;
+        totalItems: number;
+        sample: Array<{
+            ITM_ID: string;
+            ITM_NM: string;
+        }>;
+    }[];
+    hint: string;
+    usageHint?: undefined;
+    error?: undefined;
+} | {
+    success: boolean;
+    orgId: string;
+    tableId: string;
+    error: string;
+    usageHint: string;
+    groups?: undefined;
+    hint?: undefined;
+}>;
+//# sourceMappingURL=getTableInfo.d.ts.map

package/dist/tools/getTableInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTableInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getTableInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;CAwB9B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC;AAE/E,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+C1D"}

package/dist/tools/getTableInfo.js

@@ -0,0 +1,85 @@
+/**
+ * 통계표 분류·항목 메타 조회 (경량)
+ *
+ * 응답 크기가 컸던 이전 구현은 raw 메타를 통째로 반환하여 클라이언트(Cursor 등)를
+ * 초기화시키는 문제가 있었다. 이번에는 OBJ_NM 그룹별로 샘플 N개(기본 10)만 노출하고
+ * `filter`로 ITM_NM 부분일치 검색을 지원한다.
+ *
+ * 사용 예: "광진구" 코드를 찾을 때
+ *   get_table_info({ orgId: "201", tblId: "DT_201004_O110054", filter: "광진구" })
+ */
+import { z } from 'zod';
+import { summarizeTableMeta } from '../utils/metaLookup.js';
+export const getTableInfoSchema = {
+    name: 'get_table_info',
+    description: `[메타조회] 통계표의 분류(OBJ_NM)와 항목(ITM_ID, ITM_NM) 목록 조회. get_statistics_data / analyze_time_series 호출 전 차원·항목 코드 확인용. 통계표 ID 모르면 search_statistics 먼저.
+
+응답이 무거울 수 있으니 filter로 좁히세요.
+• filter="광진구" → 자치구별 분류에서 "광진구" 항목만 노출
+• sampleSize 조절 (기본 10, 최대 50)
+
+자치구·시군구 통계는 통계표마다 ITM_ID 패턴이 다릅니다 (예: 광진구가 "001005"이거나 "13102127569D1.HCD_11050"). 항상 이 도구로 실제 코드를 확인하세요.`,
+    inputSchema: z.object({
+        orgId: z.string().describe('기관 ID (예: 201 = 서울특별시)'),
+        tableId: z.string().describe('통계표 ID (예: DT_201004_O110054)'),
+        filter: z
+            .string()
+            .optional()
+            .describe('ITM_NM 부분일치 필터 (예: "광진구", "여자"). 비우면 OBJ 그룹별 첫 N개만 노출'),
+        sampleSize: z
+            .number()
+            .min(1)
+            .max(50)
+            .optional()
+            .default(10)
+            .describe('OBJ 그룹별 표시 개수 (기본 10, 최대 50)'),
+    }),
+};
+export async function getTableInfo(input) {
+    try {
+        const summary = await summarizeTableMeta(input.orgId, input.tableId, {
+            sampleSize: input.sampleSize ?? 10,
+            filter: input.filter,
+        });
+        if (summary.groups.length === 0) {
+            return {
+                success: false,
+                orgId: input.orgId,
+                tableId: input.tableId,
+                usageHint: '메타데이터를 찾을 수 없습니다. orgId와 tableId를 확인하세요.',
+            };
+        }
+        const lines = [];
+        lines.push(`## ${input.orgId} / ${input.tableId} 메타`);
+        if (input.filter)
+            lines.push(`(filter="${input.filter}")\n`);
+        for (const g of summary.groups) {
+            const label = g.objIdSn === '0' ? '[항목]' : `[objL${g.objIdSn}]`;
+            lines.push(`### ${label} ${g.objNm} — 총 ${g.totalItems}개`);
+            for (const it of g.sample) {
+                lines.push(`  - \`${it.ITM_ID}\` ${it.ITM_NM}`);
+            }
+            if (g.totalItems > g.sample.length) {
+                lines.push(`  ... +${g.totalItems - g.sample.length}개 (filter로 좁히세요)`);
+            }
+        }
+        return {
+            success: true,
+            orgId: input.orgId,
+            tableId: input.tableId,
+            groups: summary.groups,
+            hint: lines.join('\n'),
+        };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            orgId: input.orgId,
+            tableId: input.tableId,
+            error: msg,
+            usageHint: `메타 조회 실패: ${msg}`,
+        };
+    }
+}
+//# sourceMappingURL=getTableInfo.js.map

package/dist/tools/getTableInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTableInfo.js","sourceRoot":"","sources":["../../src/tools/getTableInfo.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP 도구 등록 통합
+ */
+export { searchStatistics, searchStatisticsSchema, type SearchStatisticsInput, } from './searchStatistics.js';
+export { getStatisticsList, getStatisticsListSchema, getAvailableViewCodes, getAvailableRecommendedTopics, type GetStatisticsListInput, } from './getStatisticsList.js';
+export { getStatisticsData, getStatisticsDataSchema, type GetStatisticsDataInput, } from './getStatisticsData.js';
+export { compareStatistics, compareStatisticsSchema, type CompareStatisticsInput, } from './compareStatistics.js';
+export { analyzeTimeSeries, analyzeTimeSeriesSchema, type AnalyzeTimeSeriesInput, } from './analyzeTimeSeries.js';
+export { getTableInfo, getTableInfoSchema, type GetTableInfoInput, } from './getTableInfo.js';
+export { quickStats, quickStatsSchema, type QuickStatsInput, } from './quickStats.js';
+export { quickTrend, quickTrendSchema, type QuickTrendInput, } from './quickTrend.js';
+export { fetchKosisExcel, fetchKosisExcelSchema, type FetchKosisExcelInput, } from './fetchKosisExcel.js';
+export { chainRegionBrief, chainRegionBriefSchema, type ChainRegionBriefInput, chainCompareRegions, chainCompareRegionsSchema, type ChainCompareRegionsInput, chainPolicyIndicator, chainPolicyIndicatorSchema, type ChainPolicyIndicatorInput, } from './chains.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,wBAAwB,EAC7B,oBAAoB,EACpB,0BAA0B,EAC1B,KAAK,yBAAyB,GAC/B,MAAM,aAAa,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,19 @@
+/**
+ * MCP 도구 등록 통합
+ */
+export { searchStatistics, searchStatisticsSchema, } from './searchStatistics.js';
+export { getStatisticsList, getStatisticsListSchema, getAvailableViewCodes, getAvailableRecommendedTopics, } from './getStatisticsList.js';
+export { getStatisticsData, getStatisticsDataSchema, } from './getStatisticsData.js';
+export { compareStatistics, compareStatisticsSchema, } from './compareStatistics.js';
+export { analyzeTimeSeries, analyzeTimeSeriesSchema, } from './analyzeTimeSeries.js';
+// v1.4.0: get_recommended_statistics → get_statistics_list(recommendedTopic) 통폐합
+// 경량화 후 재활성화: filter + sampleSize로 응답량 제한
+export { getTableInfo, getTableInfoSchema, } from './getTableInfo.js';
+export { quickStats, quickStatsSchema, } from './quickStats.js';
+export { quickTrend, quickTrendSchema, } from './quickTrend.js';
+export { fetchKosisExcel, fetchKosisExcelSchema, } from './fetchKosisExcel.js';
+// 체인 도구 (공무원 업무 킬링 기능)
+export { chainRegionBrief, chainRegionBriefSchema, chainCompareRegions, chainCompareRegionsSchema, chainPolicyIndicator, chainPolicyIndicatorSchema, } from './chains.js';
+// 도구 스키마들은 개별적으로 export되어 있습니다.
+// server.ts에서 직접 import하여 사용하세요.
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAEvB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,GAE9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAEhC,iFAAiF;AAEjF,0CAA0C;AAC1C,OAAO,EACL,YAAY,EACZ,kBAAkB,GAEnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,EACV,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,UAAU,EACV,gBAAgB,GAEjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,eAAe,EACf,qBAAqB,GAEtB,MAAM,sBAAsB,CAAC;AAE9B,uBAAuB;AACvB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EAEtB,mBAAmB,EACnB,yBAAyB,EAEzB,oBAAoB,EACpB,0BAA0B,GAE3B,MAAM,aAAa,CAAC;AAErB,gCAAgC;AAChC,iCAAiC"}

package/dist/tools/quickStats.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 빠른 통계 조회 도구
+ * 자연어 질문으로 한 번에 통계 데이터를 조회하고 자연어 응답을 생성
+ *
+ * 개선: 정적으로 검증된 파라미터 사용 (동적 조회 대신)
+ */
+import { z } from 'zod';
+export declare const quickStatsSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        query: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        year: z.ZodOptional<z.ZodNumber>;
+        period: z.ZodOptional<z.ZodEnum<["Y", "Q", "M"]>>;
+        month: z.ZodOptional<z.ZodNumber>;
+        quarter: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        region?: string | undefined;
+        period?: "Y" | "Q" | "M" | undefined;
+        year?: number | undefined;
+        month?: number | undefined;
+        quarter?: number | undefined;
+    }, {
+        query: string;
+        region?: string | undefined;
+        period?: "Y" | "Q" | "M" | undefined;
+        year?: number | undefined;
+        month?: number | undefined;
+        quarter?: number | undefined;
+    }>;
+};
+export type QuickStatsInput = z.infer<typeof quickStatsSchema.inputSchema>;
+interface QuickStatsResult {
+    success: boolean;
+    answer: string;
+    value?: number | string;
+    unit?: string;
+    period?: string;
+    source?: {
+        orgId: string;
+        tableId: string;
+        tableName: string;
+    };
+    isProjection?: boolean;
+    note?: string;
+}
+/**
+ * 쿼리에서 광역시도 추출
+ *
+ * 부분매칭 버그 방지:
+ *   1. 자치구가 먼저 감지되면 광역시도 매칭은 스킵 (예: "해운대구"에 "대구" 부분매칭 방지)
+ *   2. 풀네임 우선 매칭 (예: "서울특별시" > "서울")
+ *   3. shortName은 단어 단위로 매칭 (앞뒤가 한글이 아니거나 끝)
+ */
+export declare function extractProvinceName(query: string, districtDetected: boolean): string | null;
+/**
+ * 쿼리에서 자치구 감지
+ * 반환: 자치구명 또는 null
+ *
+ * 보장:
+ *   - "인구"/"수입"/"수출" 등 "구/군/시"로 끝나는 키워드는 자치구 아님
+ *   - 광역시도 풀네임("서울특별시" 등) 자치구 아님
+ *   - 정식 KOSIS 키워드/별칭은 자치구 아님
+ */
+export declare function extractDistrictName(query: string): string | null;
+export declare function quickStats(input: QuickStatsInput): Promise<QuickStatsResult>;
+export declare function extractKeyword(query: string): string;
+export {};
+//# sourceMappingURL=quickStats.d.ts.map

package/dist/tools/quickStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quickStats.d.ts","sourceRoot":"","sources":["../../src/tools/quickStats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsBxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;CA8C5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC;AAE3E,UAAU,gBAAgB;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CA2B3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAehE;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyPlF;AAkBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYpD"}