ragalgo-mcp-server 1.0.4

package/src/tools/news.ts

@@ -0,0 +1,67 @@
+/**
+ * 뉴스 관련 MCP Tools
+ */
+
+import { z } from 'zod';
+import { callApi } from '../utils/api.js';
+
+// 뉴스 파라미터 스키마
+export const NewsParamsSchema = z.object({
+    tag: z.string().optional().describe('태그 코드 (search_tags 결과값, 예: STK005930, THM001)'),
+    source: z.string().optional().describe('소스 필터 (예: 한경, 매경)'),
+    search: z.string().optional().describe('제목 검색어'),
+    from_date: z.string().optional().describe('시작일 (YYYY-MM-DD)'),
+    to_date: z.string().optional().describe('종료일 (YYYY-MM-DD)'),
+    limit: z.number().min(1).max(100).default(20).describe('결과 수 (기본: 20, 최대: 100)'),
+    offset: z.number().min(0).default(0).describe('페이지네이션 오프셋'),
+});
+
+// 점수 포함 뉴스 파라미터 스키마
+export const NewsScoredParamsSchema = NewsParamsSchema.extend({
+    min_score: z.number().min(-10).max(10).optional().describe('최소 감정 점수 (-10~10)'),
+    max_score: z.number().min(-10).max(10).optional().describe('최대 감정 점수 (-10~10)'),
+    verdict: z.enum(['bullish', 'bearish', 'neutral']).optional().describe('판정 필터'),
+});
+
+export type NewsParams = z.infer<typeof NewsParamsSchema>;
+export type NewsScoredParams = z.infer<typeof NewsScoredParamsSchema>;
+
+// 뉴스 조회 (점수 제외)
+export async function getNews(params: NewsParams) {
+    const result = await callApi<{
+        success: boolean;
+        data: Array<{
+            id: number;
+            title: string;
+            summary: string;
+            tags: string[];
+            url: string;
+            source: string;
+            created_at: string;
+        }>;
+        meta: { count: number; tier: string };
+    }>('news', params);
+
+    return result;
+}
+
+// 뉴스 조회 (점수 포함)
+export async function getNewsScored(params: NewsScoredParams) {
+    const result = await callApi<{
+        success: boolean;
+        data: Array<{
+            id: number;
+            title: string;
+            summary: string;
+            tags: string[];
+            sentiment_score: number;
+            verdict: string;
+            url: string;
+            source: string;
+            created_at: string;
+        }>;
+        meta: { count: number; tier: string };
+    }>('news-scored', params);
+
+    return result;
+}

package/src/tools/research.ts

@@ -0,0 +1,40 @@
+/**
+ * 컨설팅 보고서 관련 MCP Tools
+ */
+
+import { z } from 'zod';
+import { callApi } from '../utils/api.js';
+
+const API_BASE = 'https://ragalgo-research-production.up.railway.app'; // 혹시 몰라 남겨룸, 하지만 callApi 사용시 Supabase Edge Function 호출
+
+// 보고서 조회 파라미터 스키마
+export const ResearchParamsSchema = z.object({
+    tag_code: z.string().describe('태그 코드 (필수). search_tags로 먼저 조회하세요.'),
+    limit: z.number().min(1).max(10).default(5).describe('보고서 수 (기본 5, 최대 10)'),
+    source: z.string().optional().describe('출처 필터 (선택): mckinsey, goldman, bcg, lg_research 등'),
+});
+
+export type ResearchParams = z.infer<typeof ResearchParamsSchema>;
+
+// 보고서 조회
+export async function getResearch(params: ResearchParams) {
+    // Supabase Edge Function 호출
+    const result = await callApi<{
+        tag_code: string;
+        tag_name: string | null;
+        research_count: number;
+        research: Array<{
+            id: number;
+            title: string;
+            source: string;
+            content_type: string;
+            published_at: string | null;
+            chunks: Array<{
+                section: string;
+                content: string;
+            }>;
+        }>;
+    }>('research', params); // 'research' function 호출
+
+    return result;
+}

package/src/tools/snapshots.ts

@@ -0,0 +1,55 @@
+/**
+ * 스냅샷 관련 MCP Tools
+ */
+
+import { z } from 'zod';
+import { callApi } from '../utils/api.js';
+
+// 스냅샷 파라미터 스키마
+export const SnapshotsParamsSchema = z.object({
+    tag_code: z.string().optional().describe('태그 코드 (예: STK005930)'),
+    date: z.string().optional().describe('날짜 (YYYY-MM-DD)'),
+    days: z.number().min(1).max(30).default(7).describe('최근 N일 (기본: 7)'),
+    limit: z.number().min(1).max(100).default(50).describe('결과 수'),
+    offset: z.number().min(0).default(0).describe('페이지네이션 오프셋'),
+});
+
+export type SnapshotsParams = z.infer<typeof SnapshotsParamsSchema>;
+
+// 스냅샷 조회
+// [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.
+export async function getSnapshots(params: SnapshotsParams) {
+    const endpoint = 'snapshots';
+    const { tag_code, ...queryParams } = params;
+    // 태그 코드가 있으면 쿼리 파라미터에 추가
+    if (tag_code) {
+        (queryParams as any).tag_code = tag_code;
+    }
+
+    const result = await callApi<{
+        success: boolean;
+        data: Array<{
+            tag_code: string;
+            snapshot_date: string;
+            news_count: number;
+            news_avg_score: number;
+            news_max_score: number;
+            news_min_score: number;
+            news_bullish_count: number;
+            news_bearish_count: number;
+            news_neutral_count: number;
+            research_count?: number;        // Added
+            research_outlook?: string;      // Added
+            chart_score: number;
+            chart_zone: string;
+            last_price: number;
+        }>;
+        meta: { count: number; date?: string; days?: number };
+    }>(endpoint, queryParams);
+
+    return result;
+}

package/src/tools/tags.ts

@@ -0,0 +1,61 @@
+/**
+ * 태그 관련 MCP Tools
+ */
+
+import { z } from 'zod';
+import { callApi, callApiPost } from '../utils/api.js';
+
+// 태그 검색 파라미터 스키마
+export const TagsSearchParamsSchema = z.object({
+    q: z.string().describe('검색어 (예: 삼성, 반도체)'),
+    type: z.enum(['STOCK', 'SECTOR', 'THEME', 'CRYPTO']).optional().describe('태그 타입'),
+    limit: z.number().min(1).max(50).default(20).describe('결과 수'),
+});
+
+// 태그 매칭 파라미터 스키마
+export const TagsMatchParamsSchema = z.object({
+    text: z.string().describe('매칭할 텍스트 (예: 삼성전자 HBM 대박)'),
+    types: z.array(z.enum(['STOCK', 'SECTOR', 'THEME', 'CRYPTO'])).optional().describe('태그 타입 필터'),
+    limit: z.number().min(1).max(20).default(10).describe('결과 수'),
+});
+
+export type TagsSearchParams = z.infer<typeof TagsSearchParamsSchema>;
+export type TagsMatchParams = z.infer<typeof TagsMatchParamsSchema>;
+
+// 태그 검색
+export async function searchTags(params: TagsSearchParams) {
+    const result = await callApi<{
+        success: boolean;
+        data: Array<{
+            tag_code: string;
+            tag_type: string;
+            name: string;
+            name_en?: string;
+            match_type: string;
+            usage_count: number;
+        }>;
+        meta: { query: string; count: number };
+    }>('tags/search', params);
+
+    return result;
+}
+
+// 태그 매칭 (텍스트 → 태그)
+export async function matchTags(params: TagsMatchParams) {
+    const result = await callApiPost<{
+        success: boolean;
+        data: {
+            matches: Array<{
+                tag_code: string;
+                tag_type: string;
+                name: string;
+                match_type: string;
+            }>;
+            keywords_extracted: string[];
+            keywords_matched: string[];
+        };
+        meta: { input_length: number; keywords_count: number };
+    }>('tags-match', params);
+
+    return result;
+}

package/src/tools/trends.ts

@@ -0,0 +1,35 @@
+/**
+ * 트렌드 관련 MCP Tools
+ */
+
+import { z } from 'zod';
+import { callApi } from '../utils/api.js';
+
+// 트렌드 파라미터 스키마
+export const TrendsParamsSchema = z.object({
+    tag_code: z.string().describe('태그 코드 (예: STK005930)'),
+    days: z.number().min(1).max(30).default(7).describe('최근 N일 (기본: 7)'),
+});
+
+export type TrendsParams = z.infer<typeof TrendsParamsSchema>;
+
+// 트렌드 조회
+export async function getTrends(params: TrendsParams) {
+    const result = await callApi<{
+        success: boolean;
+        tag: {
+            code: string;
+            name: string;
+            type: string;
+            name_en?: string;
+        };
+        trend: Array<{
+            date: string;
+            count: number;
+            avg_score: number;
+        }>;
+        meta: { days: number; total_news: number };
+    }>('trends', params);
+
+    return result;
+}

package/src/utils/api.ts

@@ -0,0 +1,76 @@
+/**
+ * RagAlgo API 유틸리티
+ * Supabase Edge Functions 호출
+ */
+
+const SUPABASE_URL = 'https://xunrsikkybgxkybjzrgz.supabase.co/functions/v1';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6Inh1bnJzaWtreWJneGt5Ymp6cmd6Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjQ0NTExNTgsImV4cCI6MjA4MDAyNzE1OH0.SsXri828-Rf0gHlu4Bls-pewhfMNNII4mbiuLnc9ACs';
+
+// 환경변수에서 API 키 가져오기
+const getApiKey = (): string => {
+    const key = process.env.RAGALGO_API_KEY;
+    if (!key) {
+        throw new Error('RAGALGO_API_KEY 환경변수가 설정되지 않았습니다.');
+    }
+    return key;
+};
+
+// API 호출 기본 함수
+export async function callApi<T>(
+    endpoint: string,
+    params?: Record<string, string | number | undefined>
+): Promise<T> {
+    const apiKey = getApiKey();
+
+    // 쿼리 파라미터 생성
+    const url = new URL(`${SUPABASE_URL}/${endpoint}`);
+    if (params) {
+        Object.entries(params).forEach(([key, value]) => {
+            if (value !== undefined) {
+                url.searchParams.append(key, String(value));
+            }
+        });
+    }
+
+    const response = await fetch(url.toString(), {
+        method: 'GET',
+        headers: {
+            'Authorization': `Bearer ${SUPABASE_ANON_KEY}`,
+            'x-api-key': apiKey,
+            'Content-Type': 'application/json',
+        },
+    });
+
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`API 호출 실패: ${response.status} - ${error}`);
+    }
+
+    return response.json();
+}
+
+// POST API 호출
+export async function callApiPost<T>(
+    endpoint: string,
+    body: Record<string, unknown>
+): Promise<T> {
+    const apiKey = getApiKey();
+    const url = `${SUPABASE_URL}/${endpoint}`;
+
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${SUPABASE_ANON_KEY}`,
+            'x-api-key': apiKey,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`API 호출 실패: ${response.status} - ${error}`);
+    }
+
+    return response.json();
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "esModuleInterop": true,
+        "strict": true,
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "declaration": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}