korean-stats-mcp 1.4.0

package/dist/server-http.js

@@ -0,0 +1,134 @@
+/**
+ * Streamable HTTP 서버 - stateless 모드
+ *
+ * Fly.io 배포용 HTTP 엔드포인트. 매 POST 요청마다 fresh server + transport 생성.
+ * GET/DELETE 는 405. /health 만 GET 응답.
+ *
+ * 참고: korean-law-mcp의 server/http-server.ts 패턴
+ */
+import express from 'express';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { createServer } from './server.js';
+const PORT = parseInt(process.env.PORT || '3000', 10);
+const BODY_LIMIT = process.env.MCP_BODY_LIMIT || '200kb';
+const RATE_LIMIT_RPM = parseInt(process.env.RATE_LIMIT_RPM || '60', 10);
+const TRUST_PROXY_RAW = process.env.TRUST_PROXY ?? '1';
+function parseTrustProxy(v) {
+    if (v === 'true' || v === 'all')
+        return true;
+    if (v === 'false')
+        return false;
+    if (/^\d+$/.test(v))
+        return parseInt(v, 10);
+    return v;
+}
+function scrub(s) {
+    // KOSIS API 키가 URL/에러에 노출되지 않도록 마스킹
+    return s.replace(/(apiKey|kosis_api_key)=[^&\s]+/gi, '$1=***');
+}
+async function main() {
+    const app = express();
+    app.set('trust proxy', parseTrustProxy(TRUST_PROXY_RAW));
+    app.use(express.json({ limit: BODY_LIMIT }));
+    // Rate limit: per-IP per minute
+    if (RATE_LIMIT_RPM > 0) {
+        const buckets = new Map();
+        app.use((req, res, next) => {
+            if (req.path === '/health' || req.path === '/')
+                return next();
+            const ip = req.ip || req.socket.remoteAddress || 'unknown';
+            const now = Date.now();
+            let b = buckets.get(ip);
+            if (!b || now >= b.resetAt) {
+                b = { count: 0, resetAt: now + 60_000 };
+                buckets.set(ip, b);
+            }
+            b.count++;
+            if (b.count > RATE_LIMIT_RPM) {
+                return res.status(429).json({
+                    jsonrpc: '2.0',
+                    error: { code: -32000, message: `Rate limit exceeded (${RATE_LIMIT_RPM} rpm)` },
+                    id: null,
+                });
+            }
+            next();
+        });
+    }
+    // CORS
+    app.use((req, res, next) => {
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type, mcp-session-id');
+        res.setHeader('Cache-Control', 'no-store');
+        if (req.method === 'OPTIONS')
+            return res.status(200).end();
+        next();
+    });
+    // Health check
+    app.get('/health', (_req, res) => {
+        res.json({
+            status: 'ok',
+            name: 'korean-stats-mcp',
+            version: '1.3.0',
+            tools: 13,
+        });
+    });
+    app.get('/', (_req, res) => {
+        res.json({
+            name: 'korean-stats-mcp',
+            version: '1.3.0',
+            description: 'KOSIS 91 키워드 + 17 시도 + 자치구 230+ 라우팅 + 3개 체인 MCP',
+            endpoint: '/mcp (POST only)',
+            tools: 13,
+            docs: 'https://github.com/chrisryugj/korean-stats-mcp',
+        });
+    });
+    // MCP endpoint (POST only — stateless)
+    app.post('/mcp', async (req, res) => {
+        try {
+            const server = createServer();
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+                enableJsonResponse: true,
+            });
+            res.on('close', () => transport.close());
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            if (res.headersSent)
+                return;
+            const msg = scrub(error instanceof Error ? error.message : String(error));
+            res.status(500).json({
+                jsonrpc: '2.0',
+                error: { code: -32603, message: msg },
+                id: null,
+            });
+        }
+    });
+    // GET/DELETE on /mcp → 405
+    app.get('/mcp', (_req, res) => {
+        res.setHeader('Allow', 'POST');
+        res.status(405).json({
+            jsonrpc: '2.0',
+            error: { code: -32600, message: 'Stateless MCP — use POST.' },
+            id: null,
+        });
+    });
+    app.delete('/mcp', (_req, res) => {
+        res.setHeader('Allow', 'POST');
+        res.status(405).json({
+            jsonrpc: '2.0',
+            error: { code: -32600, message: 'Stateless MCP — sessions not supported.' },
+            id: null,
+        });
+    });
+    app.listen(PORT, () => {
+        console.log(`[korean-stats-mcp] HTTP server listening on :${PORT}`);
+    });
+}
+main().catch((err) => {
+    console.error('Fatal:', scrub(err instanceof Error ? err.message : String(err)));
+    process.exit(1);
+});
+//# sourceMappingURL=server-http.js.map

package/dist/server-http.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Korea Stats MCP 서버
+ * 통계청 KOSIS OpenAPI 기반 MCP 서버
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * MCP 서버 생성 및 설정
+ */
+export declare function createServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2CpE;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAgRxC"}

package/dist/server.js

@@ -0,0 +1,194 @@
+/**
+ * Korea Stats MCP 서버
+ * 통계청 KOSIS OpenAPI 기반 MCP 서버
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+// 도구 가져오기
+import { searchStatistics, searchStatisticsSchema, getStatisticsList, getStatisticsListSchema, getStatisticsData, getStatisticsDataSchema, compareStatistics, compareStatisticsSchema, analyzeTimeSeries, analyzeTimeSeriesSchema, getTableInfo, getTableInfoSchema, quickStats, quickStatsSchema, quickTrend, quickTrendSchema, fetchKosisExcel, fetchKosisExcelSchema, chainRegionBrief, chainRegionBriefSchema, chainCompareRegions, chainCompareRegionsSchema, chainPolicyIndicator, chainPolicyIndicatorSchema, } from './tools/index.js';
+// 리소스 가져오기
+import { getCategoryTreeJson, getKeyIndicatorsJson } from './resources/index.js';
+// 프롬프트 가져오기
+import { statisticsAssistantPromptSchema, generateStatisticsAssistantPrompt, } from './prompts/index.js';
+// 설정 가져오기
+import { validateConfig } from './config/index.js';
+/**
+ * MCP 서버 생성 및 설정
+ */
+export function createServer() {
+    // 설정 유효성 검사
+    validateConfig();
+    const server = new McpServer({
+        name: 'korean-stats-mcp',
+        version: '1.4.0',
+        description: '한국 통계청 KOSIS OpenAPI 기반 MCP 서버 - 91개 키워드, 17 시도 + 자치구 230+ 라우팅, 시계열 추세, 3개 체인 도구(지역 브리핑·다지역 비교·정책 영역) — 공무원 업무 종합 통계 도우미. v1.4.0: 자치구 region 파라미터 fix, chain_compare_regions max 17 (전국 비교), chain_region_brief speech 옵션, 장래추계 데이터 isProjection 안내, list ← 추천 흡수.',
+    });
+    // ===== 도구 등록 =====
+    // 1. 통계 검색
+    server.tool(searchStatisticsSchema.name, searchStatisticsSchema.description, searchStatisticsSchema.inputSchema.shape, async (args) => {
+        const result = await searchStatistics(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 2. 통계 목록 조회
+    server.tool(getStatisticsListSchema.name, getStatisticsListSchema.description, getStatisticsListSchema.inputSchema.shape, async (args) => {
+        const result = await getStatisticsList(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 3. 통계 데이터 조회
+    server.tool(getStatisticsDataSchema.name, getStatisticsDataSchema.description, getStatisticsDataSchema.inputSchema.shape, async (args) => {
+        const result = await getStatisticsData(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 4. 통계 비교
+    server.tool(compareStatisticsSchema.name, compareStatisticsSchema.description, compareStatisticsSchema.inputSchema.shape, async (args) => {
+        const result = await compareStatistics(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 5. 시계열 분석
+    server.tool(analyzeTimeSeriesSchema.name, analyzeTimeSeriesSchema.description, analyzeTimeSeriesSchema.inputSchema.shape, async (args) => {
+        const result = await analyzeTimeSeries(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 6. 통계표 정보 조회 (경량화 — filter + sampleSize)
+    server.tool(getTableInfoSchema.name, getTableInfoSchema.description, getTableInfoSchema.inputSchema.shape, async (args) => {
+        const result = await getTableInfo(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 8. 빠른 통계 조회 (원스텝)
+    server.tool(quickStatsSchema.name, quickStatsSchema.description, quickStatsSchema.inputSchema.shape, async (args) => {
+        const result = await quickStats(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 9. 빠른 추세 분석 (시계열)
+    server.tool(quickTrendSchema.name, quickTrendSchema.description, quickTrendSchema.inputSchema.shape, async (args) => {
+        const result = await quickTrend(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 10. KOSIS 엑셀 파일 통계표 파싱 (OpenAPI 미지원 통계 — 자치구 기본통계 등)
+    server.tool(fetchKosisExcelSchema.name, fetchKosisExcelSchema.description, fetchKosisExcelSchema.inputSchema.shape, async (args) => {
+        const result = await fetchKosisExcel(args);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+    // 11. 체인 — 지역 한장 종합 브리핑 (공무원 킬링 기능)
+    server.tool(chainRegionBriefSchema.name, chainRegionBriefSchema.description, chainRegionBriefSchema.inputSchema.shape, async (args) => {
+        const result = await chainRegionBrief(args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // 12. 체인 — N지역 × M지표 비교 매트릭스
+    server.tool(chainCompareRegionsSchema.name, chainCompareRegionsSchema.description, chainCompareRegionsSchema.inputSchema.shape, async (args) => {
+        const result = await chainCompareRegions(args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // 13. 체인 — 정책 영역 묶음 시계열
+    server.tool(chainPolicyIndicatorSchema.name, chainPolicyIndicatorSchema.description, chainPolicyIndicatorSchema.inputSchema.shape, async (args) => {
+        const result = await chainPolicyIndicator(args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    });
+    // ===== 리소스 등록 =====
+    // 1. 통계 분류 체계
+    server.resource('category-tree', 'kosis://categories/tree', {
+        description: 'KOSIS 통계 분류 체계 - 주제별/기관별 분류 구조',
+        mimeType: 'application/json',
+    }, async () => ({
+        contents: [
+            {
+                uri: 'kosis://categories/tree',
+                text: getCategoryTreeJson(),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+    // 2. 주요 지표 목록
+    server.resource('key-indicators', 'kosis://indicators/list', {
+        description: '자주 조회되는 주요 경제사회 지표 목록',
+        mimeType: 'application/json',
+    }, async () => ({
+        contents: [
+            {
+                uri: 'kosis://indicators/list',
+                text: getKeyIndicatorsJson(),
+                mimeType: 'application/json',
+            },
+        ],
+    }));
+    // ===== 프롬프트 등록 =====
+    server.prompt(statisticsAssistantPromptSchema.name, statisticsAssistantPromptSchema.description, statisticsAssistantPromptSchema.argsSchema.shape, async (args) => {
+        const result = generateStatisticsAssistantPrompt(args.question);
+        return {
+            messages: result.messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })),
+        };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/analyzeTimeSeries.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 시계열 분석 도구
+ * 통계 데이터의 시계열 추세를 분석
+ */
+import { z } from 'zod';
+export declare const analyzeTimeSeriesSchema: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        orgId: z.ZodString;
+        tableId: z.ZodString;
+        objL1: z.ZodString;
+        objL2: z.ZodOptional<z.ZodString>;
+        itemId: z.ZodString;
+        periodType: z.ZodEnum<["Y", "M", "Q"]>;
+        yearCount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        orgId: string;
+        objL1: string;
+        tableId: string;
+        itemId: string;
+        periodType: "Y" | "Q" | "M";
+        yearCount: number;
+        objL2?: string | undefined;
+    }, {
+        orgId: string;
+        objL1: string;
+        tableId: string;
+        itemId: string;
+        periodType: "Y" | "Q" | "M";
+        objL2?: string | undefined;
+        yearCount?: number | undefined;
+    }>;
+};
+export type AnalyzeTimeSeriesInput = z.infer<typeof analyzeTimeSeriesSchema.inputSchema>;
+interface TimeSeriesAnalysis {
+    trend: 'increasing' | 'decreasing' | 'stable' | 'fluctuating';
+    trendDescription: string;
+    averageGrowthRate: number;
+    volatility: number;
+    maxValue: {
+        period: string;
+        value: number;
+        formatted: string;
+    };
+    minValue: {
+        period: string;
+        value: number;
+        formatted: string;
+    };
+    recentChange: {
+        rate: number;
+        direction: 'up' | 'down' | 'stable';
+        formatted: string;
+    };
+    forecast?: string;
+}
+export declare function analyzeTimeSeries(input: AnalyzeTimeSeriesInput): Promise<{
+    success: boolean;
+    tableName?: string;
+    unit?: string;
+    analysis?: TimeSeriesAnalysis;
+    dataPoints: Array<{
+        period: string;
+        value: number;
+    }>;
+    interpretation: string[];
+}>;
+export {};
+//# sourceMappingURL=analyzeTimeSeries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeTimeSeries.d.ts","sourceRoot":"","sources":["../../src/tools/analyzeTimeSeries.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BnC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAEzF,UAAU,kBAAkB;IAC1B,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;QACpC,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,UAAU,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC,CAkLD"}

package/dist/tools/analyzeTimeSeries.js

@@ -0,0 +1,204 @@
+/**
+ * 시계열 분석 도구
+ * 통계 데이터의 시계열 추세를 분석
+ */
+import { z } from 'zod';
+import { getKosisClient } from '../api/client.js';
+import { getCacheManager } from '../cache/index.js';
+import { analyzeTrend, formatPeriod } from '../utils/dataFormatter.js';
+export const analyzeTimeSeriesSchema = {
+    name: 'analyze_time_series',
+    description: '[시계열정밀] orgId+tableId+objL1+itemId 명시한 정밀 시계열 분석. 증감/추세/성장률/변동성. 키워드만 알면 quick_trend가 즉시 응답 (자치구 fallback도 자동). 차원·항목 코드는 먼저 get_table_info로 확인.',
+    inputSchema: z.object({
+        orgId: z.string().describe('기관 ID'),
+        tableId: z.string().describe('통계표 ID'),
+        objL1: z
+            .string()
+            .describe('분류1 코드 (필수) - get_table_info로 유효한 값 조회 필요. 예: "00"(전국), "0"(계)'),
+        objL2: z
+            .string()
+            .optional()
+            .describe('분류2 코드 (선택) - 일부 테이블에서 필요. 예: 실업률 테이블의 연령계층별 "00"(계)'),
+        itemId: z
+            .string()
+            .describe('항목 ID (필수) - get_table_info로 유효한 값 조회 필요. 예: "T10"(출생건수)'),
+        periodType: z
+            .enum(['Y', 'M', 'Q'])
+            .describe('주기: Y(년), M(월), Q(분기)'),
+        yearCount: z
+            .number()
+            .min(2)
+            .max(30)
+            .optional()
+            .default(10)
+            .describe('분석할 기간 수 (기본: 10)'),
+    }),
+};
+export async function analyzeTimeSeries(input) {
+    const client = getKosisClient();
+    const cache = getCacheManager();
+    try {
+        // 데이터 조회
+        const results = await cache.getStatisticsData({
+            orgId: input.orgId,
+            tableId: input.tableId,
+            objL1: input.objL1,
+            objL2: input.objL2,
+            itemId: input.itemId,
+            periodType: input.periodType,
+            yearCount: input.yearCount,
+        }, async () => {
+            return client.getStatisticsData({
+                orgId: input.orgId,
+                tblId: input.tableId,
+                objL1: input.objL1,
+                objL2: input.objL2,
+                itmId: input.itemId,
+                prdSe: input.periodType,
+                newEstPrdCnt: input.yearCount,
+            });
+        });
+        if (results.length < 2) {
+            return {
+                success: true,
+                dataPoints: [],
+                interpretation: [
+                    '분석에 필요한 충분한 데이터가 없습니다.',
+                    `사용된 파라미터: objL1="${input.objL1}", itemId="${input.itemId}"`,
+                    '',
+                    '💡 해결 방법:',
+                    '1. get_table_info로 유효한 분류/항목 코드를 확인하세요.',
+                    '2. 예시: objL1="00"(전국) 또는 "11"(서울), itemId="T10"(출생건수)',
+                ],
+            };
+        }
+        // 데이터 정리 (시간순 정렬)
+        const sortedData = results
+            .map((r) => ({
+            period: r.PRD_DE,
+            value: parseFloat(r.DT.replace(/,/g, '')) || 0,
+            formatted: r.DT,
+        }))
+            .sort((a, b) => a.period.localeCompare(b.period));
+        const values = sortedData.map((d) => d.value);
+        const { trend, avgGrowthRate, volatility } = analyzeTrend(values);
+        // 최대/최소값 찾기
+        const maxIdx = values.indexOf(Math.max(...values));
+        const minIdx = values.indexOf(Math.min(...values));
+        // 최근 변화율
+        const lastValue = values[values.length - 1];
+        const prevValue = values[values.length - 2];
+        const recentChangeRate = prevValue !== 0 ? ((lastValue - prevValue) / Math.abs(prevValue)) * 100 : 0;
+        const analysis = {
+            trend,
+            trendDescription: getTrendDescription(trend),
+            averageGrowthRate: Math.round(avgGrowthRate * 100) / 100,
+            volatility: Math.round(volatility * 100) / 100,
+            maxValue: {
+                period: formatPeriod(sortedData[maxIdx].period, input.periodType),
+                value: sortedData[maxIdx].value,
+                formatted: sortedData[maxIdx].formatted,
+            },
+            minValue: {
+                period: formatPeriod(sortedData[minIdx].period, input.periodType),
+                value: sortedData[minIdx].value,
+                formatted: sortedData[minIdx].formatted,
+            },
+            recentChange: {
+                rate: Math.round(recentChangeRate * 100) / 100,
+                direction: recentChangeRate > 0.1 ? 'up' : recentChangeRate < -0.1 ? 'down' : 'stable',
+                formatted: `${recentChangeRate > 0 ? '+' : ''}${recentChangeRate.toFixed(1)}%`,
+            },
+        };
+        // 예측 (단순 선형 추세)
+        if (trend === 'increasing') {
+            analysis.forecast = `현재 추세가 지속된다면 향후 지속적인 증가가 예상됩니다.`;
+        }
+        else if (trend === 'decreasing') {
+            analysis.forecast = `현재 추세가 지속된다면 향후 지속적인 감소가 예상됩니다.`;
+        }
+        // 해석 생성
+        const interpretation = [];
+        interpretation.push(`📊 **추세**: ${analysis.trendDescription}`);
+        interpretation.push(`📈 **평균 성장률**: ${analysis.averageGrowthRate > 0 ? '+' : ''}${analysis.averageGrowthRate}%`);
+        interpretation.push(`🔝 **최고점**: ${analysis.maxValue.period} (${analysis.maxValue.formatted})`);
+        interpretation.push(`🔻 **최저점**: ${analysis.minValue.period} (${analysis.minValue.formatted})`);
+        interpretation.push(`📅 **최근 변화**: ${analysis.recentChange.formatted}`);
+        if (volatility > 20) {
+            interpretation.push(`⚠️ **주의**: 변동성이 높습니다 (${volatility.toFixed(1)}%). 데이터 해석에 주의가 필요합니다.`);
+        }
+        if (analysis.forecast) {
+            interpretation.push(`🔮 **전망**: ${analysis.forecast}`);
+        }
+        return {
+            success: true,
+            tableName: results[0].TBL_NM,
+            unit: results[0].UNIT_NM,
+            analysis,
+            dataPoints: sortedData.map((d) => ({
+                period: formatPeriod(d.period, input.periodType),
+                value: d.value,
+            })),
+            interpretation,
+        };
+    }
+    catch (error) {
+        console.error('Analysis error:', error);
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            dataPoints: [],
+            interpretation: [
+                '## 시계열 분석 중 오류 발생',
+                '',
+                '### 사용된 파라미터',
+                `- orgId: "${input.orgId}"`,
+                `- tableId: "${input.tableId}"`,
+                `- objL1: "${input.objL1}"`,
+                `- itemId: "${input.itemId}"`,
+                `- periodType: "${input.periodType}"`,
+                '',
+                '### 오류 내용',
+                errorMessage,
+                '',
+                '### 해결 방법',
+                '1. **get_table_info 먼저 호출**하여 유효한 코드 확인:',
+                '   ```json',
+                `   { "orgId": "${input.orgId}", "tableId": "${input.tableId}" }`,
+                '   ```',
+                '',
+                '2. **파라미터 확인**:',
+                '   - objL1: 지역 코드 (예: "00"=전국, "11"=서울)',
+                '   - itemId: 항목 코드 (예: "T10", "T1")',
+                '   - ⚠️ OBJ_ID(예: "ITEM", "A")가 아닌 실제 분류값 코드 사용',
+                '',
+                '### 올바른 호출 예시',
+                '```json',
+                '{',
+                `  "orgId": "${input.orgId}",`,
+                `  "tableId": "${input.tableId}",`,
+                '  "objL1": "00",',
+                '  "itemId": "T1",',
+                '  "periodType": "Y",',
+                '  "yearCount": 10',
+                '}',
+                '```',
+            ],
+        };
+    }
+}
+function getTrendDescription(trend) {
+    switch (trend) {
+        case 'increasing':
+            return '지속적인 상승 추세를 보이고 있습니다.';
+        case 'decreasing':
+            return '지속적인 하락 추세를 보이고 있습니다.';
+        case 'stable':
+            return '안정적인 흐름을 유지하고 있습니다.';
+        case 'fluctuating':
+            return '변동이 큰 불안정한 흐름을 보이고 있습니다.';
+        default:
+            return '추세를 파악하기 어렵습니다.';
+    }
+}
+//# sourceMappingURL=analyzeTimeSeries.js.map

package/dist/tools/analyzeTimeSeries.js.map

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