ragalgo-mcp-server 1.0.4

package/.dockerignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.git
+.env

package/.mcpregistry_github_token

@@ -0,0 +1 @@
+ghu_Safy78H3Zvt7BUuP8NfXi5r2gCVRjy1qBA0C

package/.mcpregistry_registry_token

@@ -0,0 +1 @@
+{"token":"eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJtY3AtcmVnaXN0cnkiLCJleHAiOjE3NjYyMTQ0MTAsIm5iZiI6MTc2NjIxNDExMCwiaWF0IjoxNzY2MjE0MTEwLCJhdXRoX21ldGhvZCI6ImdpdGh1Yi1hdCIsImF1dGhfbWV0aG9kX3N1YiI6Imtva29nbzEwMCIsInBlcm1pc3Npb25zIjpbeyJhY3Rpb24iOiJwdWJsaXNoIiwicmVzb3VyY2UiOiJpby5naXRodWIua29rb2dvMTAwLyoifV19.hflQzpb2k9_IJXL0_60d2yIiTkn-279aMAwLU601Zrw2sD76mOukJ6iY4psRv3RR2IygAwaMhYqezwoZZECoDw","expires_at":1766214410}

package/Dockerfile

@@ -0,0 +1,23 @@
+# Build stage
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+COPY package*.json ./
+RUN npm install
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:18-alpine
+
+WORKDIR /app
+COPY package*.json ./
+# Install only production dependencies
+RUN npm install --only=production
+
+COPY --from=builder /app/dist ./dist
+
+ENV PORT=8080
+EXPOSE 8080
+
+CMD ["npm", "start"]

package/README.md

@@ -0,0 +1,73 @@
+# RagAlgo: Dynamic RAG Engine for AI Reliability
+
+> **AI 신뢰성을 위한 다이내믹 RAG 엔진**
+
+RagAlgo는 변동성이 큰 한국 금융(주식/코인) 데이터를 **'태그(Tag)'**와 **'점수(Score)'**로 표준화하여 제공하는 **AI 전용 MCP 서버**입니다.
+여러분의 AI 에이전트가 인터넷을 헤매지 않고, 가장 효율적으로 시장의 "진실(State-of-Truth)"을 파악할 수 있도록 돕습니다.
+
+- **핵심 기능:** KOSPI/KOSDAQ 및 업비트(Upbit) 기반의 실시간 차트 점수, 뉴스 감정 분석
+- **무료 테스트:** 지금 바로 설치하여 **1,000회 무료 호출**로 충분히 테스트해보세요.
+- **상세 문서:** 웹소켓 연동 및 비즈니스 플랜 등 자세한 내용은 [공식 웹사이트(ragalgo.com)](https://www.ragalgo.com)에서 확인하실 수 있습니다.
+
+---
+
+## 🚀 설치 및 실행
+
+### 1. 직접 실행 (npx)
+
+```bash
+# 별도 설치 없이 바로 실행 (API Key 필요)
+npx -y @ragalgo/server
+```
+
+### 2. Claude Desktop 설정
+
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows) 또는 `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) 파일에 추가하세요.
+
+```json
+{
+  "mcpServers": {
+    "ragalgo": {
+      "command": "npx",
+      "args": ["-y", "@ragalgo/server", "--stdio"],
+      "env": {
+        "RAGALGO_API_KEY": "비즈니스_또는_테스트_키_입력"
+      }
+    }
+  }
+}
+```
+
+> **Tip:** 테스트용 API Key는 [RagAlgo 대시보드](https://www.ragalgo.com/dashboard)에서 즉시 발급 가능합니다.
+
+---
+
+
+
+## 🛠️ 제공 도구 (Tools)
+
+| 도구 | 설명 |
+|------|------|
+| `get_news_scored` | **[핵심]** 감정 점수(Sentiment Score)가 포함된 금융 뉴스 조회 |
+| `get_chart_stock` | **[핵심]** 한국 주식(KOSPI/KOSDAQ) 기술적 분석 점수 조회 |
+| `get_chart_coin` | **[핵심]** 한국 가상화폐(Upbit) 기술적 분석 점수 조회 |
+| `get_snapshots` | 시장 전체 요약 스냅샷 (뉴스 + 차트 + 트렌드) |
+| `get_financials` | 기업 재무제표 (분기/연간 실적) |
+| `search_tags` | 텍스트(종목명)를 RagAlgo 고유 태그로 변환 |
+
+---
+
+## 📡 Real-time WebSocket (Business Only)
+
+실시간 주가/코인 점수 데이터를 웹소켓으로 수신할 수 있습니다.
+
+- **대상:** Business Plan 사용자 (월 30개 연결 포함)
+- **주소:** `wss://ragalgo-relay-server-1-production.up.railway.app`
+- **구현 방법:** `socket.io-client` 라이브러리 사용 (자세한 코드는 [공식 문서](https://www.ragalgo.com/docs) 참조)
+
+---
+
+## 💬 Community & Support
+
+- **Website:** [ragalgo.com](https://www.ragalgo.com)
+- **Email:** support@ragalgo.com

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * RagAlgo MCP Server v1.0.2
+ * Financial news and data API via MCP protocol
+ *
+ * 🇰🇷 KOREAN MARKET SPECIALIST - Primary tool for Korean stocks & crypto
+ * 🌐 Works best WITH web_search for comprehensive analysis
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,440 @@
+#!/usr/bin/env node
+/**
+ * RagAlgo MCP Server v1.0.2
+ * Financial news and data API via MCP protocol
+ *
+ * 🇰🇷 KOREAN MARKET SPECIALIST - Primary tool for Korean stocks & crypto
+ * 🌐 Works best WITH web_search for comprehensive analysis
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import express from 'express';
+import cors from 'cors';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// Tools
+import { getNews, getNewsScored, NewsParamsSchema, NewsScoredParamsSchema } from './tools/news.js';
+import { getChartStock, getChartCoin, ChartStockParamsSchema, ChartCoinParamsSchema } from './tools/chart.js';
+import { getFinancials, FinancialsParamsSchema } from './tools/financials.js';
+import { getSnapshots, SnapshotsParamsSchema } from './tools/snapshots.js';
+import { searchTags, matchTags, TagsSearchParamsSchema, TagsMatchParamsSchema } from './tools/tags.js';
+import { getTrends, TrendsParamsSchema } from './tools/trends.js';
+import { getResearch, ResearchParamsSchema } from './tools/research.js';
+// MCP Server
+const server = new Server({
+    name: 'RagAlgo',
+    version: '1.0.2',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Tool definitions with improved descriptions for better AI routing
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            // ============================================================
+            // 🏷️ TAG TOOLS - MUST USE FIRST!
+            // ============================================================
+            {
+                name: 'search_tags',
+                description: `🔍 [TAG LOOKUP - USE FIRST] ALWAYS use this BEFORE other RagAlgo tools when user mentions any Korean stock, coin, or theme by NAME.
+
+PRIMARY TOOL for converting names to tag_codes. Without correct tag_code, other tools will return inaccurate or empty results.
+
+ALWAYS use when you see:
+- Korean stock names: 삼성전자, SK하이닉스, 네이버, 카카오, LG에너지솔루션
+- Crypto names: 비트코인, 이더리움, 리플, 솔라나
+- Theme/sector names: 반도체, AI, 2차전지, 바이오
+
+Examples: "삼성전자" → STK005930, "비트코인" → CRY_BTC, "반도체" → THM_반도체
+
+CRITICAL: Call this first, then use the returned tag_code in other tools.`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: { type: 'string', description: 'Search query (e.g., 삼성, Samsung, 반도체, AI, Bitcoin)' },
+                        type: { type: 'string', enum: ['STOCK', 'SECTOR', 'THEME', 'CRYPTO'], description: 'Tag type filter (optional)' },
+                        limit: { type: 'number', description: 'Result count (default: 20)' },
+                    },
+                    required: ['q'],
+                },
+            },
+            // ============================================================
+            // 📊 SUMMARY TOOL - MOST EFFICIENT!
+            // ============================================================
+            {
+                name: 'get_snapshots',
+                description: `📊 [DAILY SUMMARY - MOST EFFICIENT] PRIMARY TOOL for Korean market overview. ALWAYS use this FIRST for general market questions.
+
+This is the ONLY tool that returns news + chart + sentiment COMBINED in one call.
+Prefer this over calling get_news + get_chart separately - much more efficient!
+
+ALWAYS use when user asks:
+- "오늘 시장 어때?" / "how's the market today?"
+- "시장 요약해줘" / "market summary"
+- "오늘 뉴스 좋은 거 뭐 있어?" / "what's hot today?"
+- "전체적인 분위기 어때?" / "market sentiment"
+
+[IMPORTANT] Snapshots are generated daily at 17:00 KST (market close).
+If you request 'today' and get no results (because it's morning in KST), you MUST:
+1. Fetch 'yesterday's snapshot for context.
+2. Call 'get_news_scored' to get REAL-TIME news for the current day.
+
+Returns per asset: news_count, avg_sentiment, bullish/bearish counts, chart_score, zone, price.
+
+🔗 BEST PRACTICE - Combine with web_search:
+1. Use get_snapshots FIRST for Korean market sentiment & chart data
+2. Then use web_search for latest breaking news or global context
+Example: get_snapshots → "시장 하락세" → web_search "한국 증시 하락 원인" → 종합 분석`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tag_code: { type: 'string', description: 'Tag code for specific asset (e.g., STK005930, CRY_BTC). Leave empty for market-wide overview.' },
+                        date: { type: 'string', description: 'Date (YYYY-MM-DD). Default: today' },
+                        days: { type: 'number', description: 'Recent N days for time-series (default: 7)' },
+                        limit: { type: 'number', description: 'Result count' },
+                    },
+                },
+            },
+            // ============================================================
+            // 📰 NEWS TOOLS
+            // ============================================================
+            {
+                name: 'get_news_scored',
+                description: `📰 [KOREAN NEWS WITH SENTIMENT] PRIMARY news tool for Korean market. Returns news WITH AI sentiment scores (-10 to +10).
+
+Use for Korean stock/crypto news with sentiment analysis.
+
+[NOTE] This tool AUTOMATICALLY filters out 0-score (Neutral/Noise) news to provide clear signals.
+If you need raw/neutral news, use 'get_news' instead.
+
+Use when user asks:
+- "삼성전자 뉴스" / "Samsung news"
+- "호재 뉴스 보여줘" / "show me bullish news"  
+- "비트코인 악재 있어?" / "any bearish news on Bitcoin?"
+- "오늘 좋은 뉴스" / "today's positive news"
+
+Filter by: tag, verdict (bullish/bearish/neutral), score range
+Returns: title, summary, sentiment_score, verdict, tags
+
+🔗 BEST PRACTICE - Combine with web_search:
+- RagAlgo: Sentiment-analyzed Korean market news (structured data)
+- web_search: Real-time breaking news, global context, additional sources
+Example workflow:
+1. get_news_scored(tag="삼성전자") → 감정 분석된 뉴스 목록
+2. web_search("삼성전자 최신 뉴스") → 실시간 속보
+3. Combine both for comprehensive analysis!
+
+TIP: For market overview, use get_snapshots instead (more efficient).
+TIP: Use search_tags first to get exact tag name.`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tag: { type: 'string', description: 'Tag CODE (e.g., STK005930). Use search_tags first to get this code!' },
+                        source: { type: 'string', description: 'Source filter' },
+                        search: { type: 'string', description: 'Title search keyword' },
+                        min_score: { type: 'number', description: 'Min sentiment score (-10 to 10)' },
+                        max_score: { type: 'number', description: 'Max sentiment score (-10 to 10)' },
+                        verdict: { type: 'string', enum: ['bullish', 'bearish', 'neutral'], description: 'Sentiment verdict filter' },
+                        limit: { type: 'number', description: 'Result count (default: 20)' },
+                    },
+                },
+            },
+            {
+                name: 'get_news',
+                description: `📰 [KOREAN NEWS - NO SCORES] Basic news without sentiment analysis. Use only when sentiment scores are not needed or for non-scored tier users.
+
+Prefer get_news_scored over this for most use cases unless you want raw data including 0-score items.
+
+Filter by: tag, source, date range
+Returns: title, summary, url, tags, source`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tag: { type: 'string', description: 'Tag filter (e.g., 삼성전자, 비트코인, 반도체)' },
+                        source: { type: 'string', description: 'Source filter (e.g., 한경, 매경)' },
+                        search: { type: 'string', description: 'Title search keyword' },
+                        from_date: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                        to_date: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+                        limit: { type: 'number', description: 'Result count (default: 20, max: 100)' },
+                    },
+                },
+            },
+            // ============================================================
+            // 📈 CHART/TECHNICAL ANALYSIS TOOLS
+            // ============================================================
+            {
+                name: 'get_chart_stock',
+                description: `📈 [KOREAN STOCK CHARTS] PRIMARY tool for Korean stock technical analysis. Returns momentum scores and trend zones.
+
+ALWAYS use for Korean stock chart/technical questions.
+
+[IMPORTANT] You MUST use 'search_tags' first to get the correct ticker (e.g., STK005930).
+
+Use when user asks:
+- "차트 강한 종목" / "stocks with strong momentum"
+- "상승 추세 종목" / "uptrending stocks"
+- "삼성전자 차트 어때?" / "how's Samsung's chart?"
+- "기술적 분석" / "technical analysis"
+
+Filter by: zone (STRONG_UP/UP_ZONE/NEUTRAL/DOWN_ZONE/STRONG_DOWN), market (KOSPI/KOSDAQ)
+Returns: ticker, name, zone, oscillator_state, 5-day scores (d0-d4), last_price
+
+🔗 COMBINE with web_search for deeper analysis:
+1. get_chart_stock → "삼성전자 DOWN_ZONE"
+2. web_search "삼성전자 주가 하락 이유" → 하락 원인 파악
+3. Provide comprehensive technical + fundamental analysis!
+
+TIP: Use search_tags first to get ticker from stock name.`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        ticker: { type: 'string', description: 'Stock ticker (e.g., 005930 for Samsung)' },
+                        market: { type: 'string', enum: ['KOSPI', 'KOSDAQ'], description: 'Market type' },
+                        zone: { type: 'string', enum: ['STRONG_UP', 'UP_ZONE', 'NEUTRAL', 'DOWN_ZONE', 'STRONG_DOWN'], description: 'Chart zone filter - use this to find strong/weak stocks' },
+                        limit: { type: 'number', description: 'Result count' },
+                    },
+                },
+            },
+            {
+                name: 'get_chart_coin',
+                description: `🪙 [CRYPTO CHARTS] PRIMARY tool for Korean crypto (Upbit) technical analysis. Returns momentum scores and trend zones.
+
+ALWAYS use for Korean crypto chart questions.
+
+[IMPORTANT] You MUST use 'search_tags' first to get the correct ticker (e.g., CRY_BTC).
+
+Use when user asks:
+- "비트코인 차트" / "Bitcoin chart"
+- "상승 중인 코인" / "pumping coins"
+- "코인 기술적 분석" / "crypto technical analysis"
+
+Filter by: zone (STRONG_UP/UP_ZONE/NEUTRAL/DOWN_ZONE/STRONG_DOWN)
+Returns: ticker, name, zone, oscillator_state, 10-candle scores (c0-c9, 12h intervals), last_price
+
+🔗 COMBINE with web_search for context:
+1. get_chart_coin → "비트코인 UP_ZONE"
+2. web_search "비트코인 상승 이유" → 상승 배경 파악`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        ticker: { type: 'string', description: 'Coin ticker (e.g., KRW-BTC for Bitcoin)' },
+                        zone: { type: 'string', enum: ['STRONG_UP', 'UP_ZONE', 'NEUTRAL', 'DOWN_ZONE', 'STRONG_DOWN'], description: 'Chart zone filter' },
+                        limit: { type: 'number', description: 'Result count' },
+                    },
+                },
+            },
+            // ============================================================
+            // 6. 컨설팅 보고서 (신규!)
+            // ============================================================
+            {
+                name: 'get_research',
+                description: `📑 [RESEARCH] Get consulting firm reports (McKinsey, BCG, etc.)
+
+Use for: "long-term trends", "sector outlook", "industry analysis"
+Filter by: source, tag_code, market_outlook
+
+Returns: AI summary in Korean, investment insights
+Includes tag_codes for cross-referencing with news/charts.
+
+⚠️ This tool returns FULL chunked text. Analyze it to answer user questions.`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tag_code: { type: 'string', description: 'Tag code (required). Use search_tags first.' },
+                        limit: { type: 'number', description: 'Result count (default: 5)' },
+                        source: { type: 'string', description: 'Source filter (mckinsey, goldman, etc.)' },
+                    },
+                    required: ['tag_code'],
+                },
+            },
+            // ============================================================
+            // 💰 FINANCIAL DATA TOOLS
+            // ============================================================
+            {
+                name: 'get_financials',
+                description: `💰 [KOREAN STOCK FUNDAMENTALS] PRIMARY tool for Korean stock financial data. Returns quarterly financial statements.
+
+ALWAYS use for Korean stock fundamental analysis.
+
+Use when user asks:
+- "삼성전자 재무제표" / "Samsung financials"
+- "PER 낮은 종목" / "low PER stocks"
+- "ROE 높은 기업" / "high ROE companies"
+- "저평가 종목" / "undervalued stocks"
+
+Returns: PER, PBR, ROE, ROA, revenue, operating_income, net_income, debt_ratio, dividend_yield
+
+🔗 COMBINE with web_search:
+1. get_financials → "PER 5.2, ROE 15%"
+2. web_search "삼성전자 실적 전망" → 미래 실적 예측`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        ticker: { type: 'string', description: 'Stock ticker (e.g., 005930)' },
+                        period: { type: 'string', description: 'Quarter (e.g., 2024Q3)' },
+                        market: { type: 'string', enum: ['KOSPI', 'KOSDAQ'], description: 'Market type' },
+                        periods: { type: 'number', description: 'Recent N quarters (default: 4)' },
+                        limit: { type: 'number', description: 'Result count' },
+                    },
+                },
+            },
+            // ============================================================
+            // 📉 TREND TOOLS
+            // ============================================================
+            {
+                name: 'get_trends',
+                description: `📉 [SENTIMENT TRENDS] Get historical sentiment trend for a specific asset over time.
+
+Use when user asks:
+- "삼성전자 지난주 분위기" / "Samsung sentiment last week"
+- "비트코인 추세" / "Bitcoin trend"
+- "최근 7일간 뉴스 동향" / "news trend over 7 days"
+
+REQUIRES tag_code - use search_tags first!
+Returns: daily news_count and avg_sentiment_score over N days
+
+🔗 COMBINE with web_search:
+1. get_trends → "지난주 감정 -2.5로 하락"
+2. web_search "삼성전자 지난주 이슈" → 하락 원인 파악`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tag_code: { type: 'string', description: 'Tag code (e.g., STK005930, CRY_BTC) - REQUIRED. Use search_tags to find this first!' },
+                        days: { type: 'number', description: 'Recent N days (default: 7, max: 30)' },
+                    },
+                    required: ['tag_code'],
+                },
+            },
+            // ============================================================
+            // 🏷️ AUTO-TAGGING TOOL
+            // ============================================================
+            {
+                name: 'match_tags',
+                description: `🏷️ [AUTO-TAG EXTRACTION] Extract stock/crypto/theme tags from any text. Useful for categorizing news or analyzing what topics a text mentions.
+
+Use when:
+- Analyzing what stocks/themes a news title mentions
+- Auto-categorizing text content
+- Finding related tags from a sentence
+
+Input: any text (e.g., "삼성전자 HBM 대박 소식")
+Returns: matched tags with confidence scores`,
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        text: { type: 'string', description: 'Text to analyze (e.g., "삼성전자 HBM 대박 소식")' },
+                        types: { type: 'array', items: { type: 'string' }, description: 'Tag type filter (optional)' },
+                        limit: { type: 'number', description: 'Result count (default: 10)' },
+                    },
+                    required: ['text'],
+                },
+            },
+        ],
+    };
+});
+// Tool call handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let result;
+        switch (name) {
+            case 'get_news':
+                result = await getNews(NewsParamsSchema.parse(args));
+                break;
+            case 'get_news_scored':
+                result = await getNewsScored(NewsScoredParamsSchema.parse(args));
+                break;
+            case 'get_chart_stock':
+                result = await getChartStock(ChartStockParamsSchema.parse(args));
+                break;
+            case 'get_chart_coin':
+                result = await getChartCoin(ChartCoinParamsSchema.parse(args));
+                break;
+            case 'get_research':
+                result = await getResearch(ResearchParamsSchema.parse(args));
+                break;
+            case 'get_financials':
+                result = await getFinancials(FinancialsParamsSchema.parse(args));
+                break;
+            case 'get_snapshots':
+                result = await getSnapshots(SnapshotsParamsSchema.parse(args));
+                break;
+            case 'search_tags':
+                result = await searchTags(TagsSearchParamsSchema.parse(args));
+                break;
+            case 'match_tags':
+                result = await matchTags(TagsMatchParamsSchema.parse(args));
+                break;
+            case 'get_trends':
+                result = await getTrends(TrendsParamsSchema.parse(args));
+                break;
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    // Check if running in stdio mode (command line argument or specific env var)
+    const isStdio = process.argv.includes('--stdio');
+    if (isStdio) {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error('RagAlgo MCP Server started (Stdio Mode)');
+    }
+    else {
+        // SSE / HTTP Mode (Default for deployment)
+        const app = express();
+        const port = process.env.PORT || 8080;
+        app.use(cors());
+        app.use(express.json());
+        let transport = null;
+        app.get('/sse', async (req, res) => {
+            console.log('New SSE connection established');
+            transport = new SSEServerTransport('/messages', res);
+            await server.connect(transport);
+        });
+        app.post('/messages', async (req, res) => {
+            if (transport) {
+                await transport.handlePostMessage(req, res);
+            }
+            else {
+                res.status(404).json({ error: 'Session not found or connection not established' });
+            }
+        });
+        app.get('/health', (req, res) => {
+            res.status(200).json({ status: 'ok', version: '1.0.2' });
+        });
+        app.listen(port, () => {
+            console.log(`RagAlgo MCP Server listening on port ${port} (SSE Mode)`);
+            console.log(`- SSE Endpoint: http://localhost:${port}/sse`);
+            console.log(`- Health Check: http://localhost:${port}/health`);
+        });
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/dist/tools/chart.d.ts

@@ -0,0 +1,83 @@
+/**
+ * 차트 관련 MCP Tools
+ */
+import { z } from 'zod';
+export declare const ChartStockParamsSchema: z.ZodObject<{
+    ticker: z.ZodOptional<z.ZodString>;
+    market: z.ZodOptional<z.ZodEnum<["KOSPI", "KOSDAQ"]>>;
+    zone: z.ZodOptional<z.ZodEnum<["STRONG_UP", "UP_ZONE", "NEUTRAL", "DOWN_ZONE", "STRONG_DOWN"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    ticker?: string | undefined;
+    market?: "KOSPI" | "KOSDAQ" | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}, {
+    limit?: number | undefined;
+    ticker?: string | undefined;
+    market?: "KOSPI" | "KOSDAQ" | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}>;
+export declare const ChartCoinParamsSchema: z.ZodObject<{
+    ticker: z.ZodOptional<z.ZodString>;
+    zone: z.ZodOptional<z.ZodEnum<["STRONG_UP", "UP_ZONE", "NEUTRAL", "DOWN_ZONE", "STRONG_DOWN"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    ticker?: string | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}, {
+    limit?: number | undefined;
+    ticker?: string | undefined;
+    zone?: "STRONG_UP" | "UP_ZONE" | "NEUTRAL" | "DOWN_ZONE" | "STRONG_DOWN" | undefined;
+}>;
+export type ChartStockParams = z.infer<typeof ChartStockParamsSchema>;
+export type ChartCoinParams = z.infer<typeof ChartCoinParamsSchema>;
+export declare function getChartStock(params: ChartStockParams): Promise<{
+    success: boolean;
+    data: {
+        ticker: string;
+        name: string;
+        market: string;
+        scores: number[];
+        zone: string;
+        oscillator_state: string;
+        analysis?: {
+            weekly_zone: string;
+            daily_momentum: string;
+            daily_signal: string;
+        };
+        outlook?: string;
+        last_price: number;
+        updated_at: string;
+    } | Array<{
+        ticker: string;
+        name: string;
+        market: string;
+        zone: string;
+        last_price: number;
+    }>;
+}>;
+export declare function getChartCoin(params: ChartCoinParams): Promise<{
+    success: boolean;
+    data: {
+        ticker: string;
+        name: string;
+        scores: number[];
+        zone: string;
+        oscillator_state: string;
+        analysis?: {
+            weekly_zone: string;
+            daily_momentum: string;
+            daily_signal: string;
+        };
+        outlook?: string;
+        last_price: number;
+        updated_at: string;
+    } | Array<{
+        ticker: string;
+        name: string;
+        zone: string;
+        last_price: number;
+    }>;
+}>;