content-genie-mcp 2.9.0 → 2.9.2

package/Dockerfile

@@ -0,0 +1,29 @@
+FROM node:20-alpine
+
+WORKDIR /app
+
+# package.json과 tsconfig.json 복사
+COPY package*.json ./
+COPY tsconfig.json ./
+
+# 의존성 설치 (prepare 스크립트 무시)
+RUN npm ci --ignore-scripts
+
+# 소스 코드 복사
+COPY src/ ./src/
+
+# 빌드 실행
+RUN npm run build
+
+# 프로덕션 의존성만 남기기
+RUN npm prune --production
+
+# 환경 변수
+ENV NODE_ENV=production
+ENV MCP_HTTP_MODE=true
+ENV PORT=3000
+
+EXPOSE 3000
+
+# 서버 실행
+CMD ["node", "dist/index.js"]

package/README.md

@@ -4,6 +4,7 @@
 
 [![npm version](https://badge.fury.io/js/content-genie-mcp.svg)](https://www.npmjs.com/package/content-genie-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Wiki](https://img.shields.io/badge/docs-Wiki-blue.svg)](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki)
 
 Content Genie MCP는 블로거, 유튜버, 인스타그래머, 마케터를 위한 **17가지 강력한 도구**를 제공하는 MCP 서버입니다. 한국 시장에 특화된 트렌드 분석, 콘텐츠 아이디어 생성, SEO 최적화, 바이럴 예측, 인플루언서 협업 분석 기능을 제공합니다.
 
@@ -104,10 +105,25 @@ Content Genie MCP는 블로거, 유튜버, 인스타그래머, 마케터를 위
 claude mcp add content-genie-mcp -- npx -y content-genie-mcp
 ```
 
-### PlayMCP
+### PlayMCP (카카오)
 
 [PlayMCP](https://playmcp.kakao.com)에서 "Content Genie"를 검색하여 도구함에 추가하세요.
 
+> **참고**: PlayMCP는 등록 승인 후 사용 가능합니다. 현재 등록 진행 중입니다.
+
+## 문서
+
+- **[Wiki 문서](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki)** - 상세 사용법 및 가이드
+  - [설치 가이드](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Installation)
+  - [빠른 시작](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Quick-Start)
+  - [17가지 도구 개요](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Tools-Overview)
+  - [API 레퍼런스](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/API-Reference)
+- **활용 가이드**
+  - [블로거 가이드](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Guide-Blogger)
+  - [유튜버 가이드](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Guide-YouTuber)
+  - [인스타그래머 가이드](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Guide-Instagram)
+  - [마케터 가이드](https://github.com/MUSE-CODE-SPACE/content-genie-mcp/wiki/Guide-Marketer)
+
 ## 도구 상세
 
 ### 1. get_korean_trends

package/dist/index.js

@@ -1,15 +1,19 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { z } from "zod";
 import axios from "axios";
 import * as cheerio from "cheerio";
+import express from "express";
+import cors from "cors";
+import crypto from "crypto";
 // =============================================================================
 // Content Genie MCP v2.5 - 한국 콘텐츠 크리에이터를 위한 AI 어시스턴트 (프로 버전)
 // =============================================================================
 const server = new McpServer({
     name: "content-genie-mcp",
-    version: "2.7.0",
+    version: "2.9.2",
 });
 // =============================================================================
 // 공통 스키마
@@ -352,13 +356,13 @@ server.tool("optimize_title_hashtags", "AI 기반으로 콘텐츠 제목을 최
 // =============================================================================
 // Tool 4: SEO 키워드 분석 (analyze_seo_keywords) - 고도화
 // =============================================================================
-server.tool("analyze_seo_keywords", "키워드의 SEO 잠재력을 심층 분석하고 네이버/구글 최적화 전략을 제공합니다.", {
+server.tool("analyze_seo_keywords", "키워드의 SEO 잠재력을 심층 분석하고 다음/네이버/구글 최적화 전략을 제공합니다.", {
     keyword: z.string().describe("분석할 메인 키워드"),
-    search_engine: z.enum(["naver", "google", "both"]).optional().describe("검색엔진 (naver, google, both)"),
+    search_engine: z.enum(["daum", "naver", "google", "all"]).optional().describe("검색엔진 (daum, naver, google, all)"),
     include_questions: z.boolean().optional().describe("관련 질문 키워드 포함"),
     include_longtail: z.boolean().optional().describe("롱테일 키워드 포함"),
     competitor_analysis: z.boolean().optional().describe("경쟁 분석 포함"),
-}, async ({ keyword, search_engine = "both", include_questions = true, include_longtail = true, competitor_analysis = true }) => {
+}, async ({ keyword, search_engine = "all", include_questions = true, include_longtail = true, competitor_analysis = true }) => {
     try {
         const analysis = await analyzeAdvancedSEOKeywords(keyword, search_engine, include_questions, include_longtail, competitor_analysis);
         return {
@@ -616,6 +620,31 @@ async function getGoogleAutocomplete(keyword) {
         return [];
     }
 }
+// 다음 자동완성 키워드
+async function getDaumAutocomplete(keyword) {
+    try {
+        const response = await axios.get(`https://suggest.search.daum.net/sushi/ns`, {
+            params: {
+                w: 'tot',
+                mod: 'json',
+                code: 'utf_in_out',
+                q: keyword,
+            },
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36',
+            },
+            timeout: 5000,
+        });
+        // 응답 형식: {"q":"keyword","items":["suggestion1", "suggestion2", ...]}
+        if (response.data && Array.isArray(response.data.items)) {
+            return response.data.items.slice(0, 10);
+        }
+        return [];
+    }
+    catch {
+        return [];
+    }
+}
 // 네이버 연관검색어 스크래핑
 async function getNaverRelatedKeywords(keyword) {
     try {
@@ -703,6 +732,34 @@ async function getGoogleSearchResultCount(keyword) {
         return 100000;
     }
 }
+// 다음 검색 결과 수 추정
+async function getDaumSearchResultCount(keyword) {
+    try {
+        const response = await axios.get(`https://search.daum.net/search`, {
+            params: {
+                w: 'blog',
+                q: keyword,
+            },
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36',
+            },
+            timeout: 5000,
+        });
+        const $ = cheerio.load(response.data);
+        // 검색 결과 수 추출 시도
+        const countText = $('.sub_expander .txt_info, .cont_result .txt_info, [class*="count"]').first().text();
+        const match = countText.match(/[\d,]+/);
+        if (match) {
+            return parseInt(match[0].replace(/,/g, ''), 10);
+        }
+        // 대략적 추정: 검색 결과 아이템 수 기반
+        const itemCount = $('.wrap_cont.blog, .cont_blog').length;
+        return itemCount > 0 ? itemCount * 10000 : 50000;
+    }
+    catch {
+        return 50000; // 기본값
+    }
+}
 // 검색량 레벨 추정 (자동완성 순위 기반)
 function estimateSearchVolume(autocompleteRank, resultCount) {
     // 자동완성 상위 + 결과 수 많음 = 검색량 높음
@@ -1982,20 +2039,26 @@ function calculateReadabilityScore(text) {
 // 고급 SEO 키워드 분석 - 실시간 데이터 기반
 async function analyzeAdvancedSEOKeywords(keyword, searchEngine, includeQuestions, includeLongtail, competitorAnalysis) {
     // 병렬로 실시간 데이터 수집
-    const [naverAutocomplete, googleAutocomplete, naverRelated, naverResultCount, googleResultCount] = await Promise.all([
-        searchEngine !== 'google' ? getNaverAutocomplete(keyword) : Promise.resolve([]),
-        searchEngine !== 'naver' ? getGoogleAutocomplete(keyword) : Promise.resolve([]),
+    const includeNaver = searchEngine === 'naver' || searchEngine === 'all';
+    const includeGoogle = searchEngine === 'google' || searchEngine === 'all';
+    const includeDaum = searchEngine === 'daum' || searchEngine === 'all';
+    const [naverAutocomplete, googleAutocomplete, daumAutocomplete, naverRelated, naverResultCount, googleResultCount, daumResultCount] = await Promise.all([
+        includeNaver ? getNaverAutocomplete(keyword) : Promise.resolve([]),
+        includeGoogle ? getGoogleAutocomplete(keyword) : Promise.resolve([]),
+        includeDaum ? getDaumAutocomplete(keyword) : Promise.resolve([]),
         getNaverRelatedKeywords(keyword),
-        searchEngine !== 'google' ? getNaverSearchResultCount(keyword) : Promise.resolve(0),
-        searchEngine !== 'naver' ? getGoogleSearchResultCount(keyword) : Promise.resolve(0),
+        includeNaver ? getNaverSearchResultCount(keyword) : Promise.resolve(0),
+        includeGoogle ? getGoogleSearchResultCount(keyword) : Promise.resolve(0),
+        includeDaum ? getDaumSearchResultCount(keyword) : Promise.resolve(0),
     ]);
     // 주요 검색 엔진 결과 수 선택
     const primaryResultCount = searchEngine === 'naver' ? naverResultCount :
         searchEngine === 'google' ? googleResultCount :
-            Math.max(naverResultCount, googleResultCount);
+            searchEngine === 'daum' ? daumResultCount :
+                Math.max(naverResultCount, googleResultCount, daumResultCount);
     // 경쟁도 및 검색량 추정
     const competition = estimateCompetition(primaryResultCount);
-    const autocompleteKeywords = [...new Set([...naverAutocomplete, ...googleAutocomplete])];
+    const autocompleteKeywords = [...new Set([...daumAutocomplete, ...naverAutocomplete, ...googleAutocomplete])];
     const keywordRank = autocompleteKeywords.findIndex(k => k.includes(keyword)) + 1 || 10;
     const searchVolume = estimateSearchVolume(keywordRank, primaryResultCount);
     // SEO 난이도 계산
@@ -2138,6 +2201,18 @@ async function analyzeAdvancedSEOKeywords(keyword, searchEngine, includeQuestion
             ],
             content_types: ["웹사이트", "유튜브", "뉴스"],
         },
+        daum: {
+            result_count: daumResultCount.toLocaleString(),
+            competition: estimateCompetition(daumResultCount).level,
+            tips: [
+                "다음 블로그/카페에 발행하세요",
+                "카카오 채널과 연동 고려",
+                "티스토리 블로그 활용 추천",
+                "다음 뉴스 검색 노출 전략",
+                "카카오톡 공유 최적화",
+            ],
+            content_types: ["티스토리", "다음카페", "브런치"],
+        },
     };
     // 추천 액션 생성
     const recommendedAction = seoDifficulty > 70
@@ -2148,9 +2223,11 @@ async function analyzeAdvancedSEOKeywords(keyword, searchEngine, includeQuestion
     return {
         main_keyword: keyword,
         data_source: {
+            daum_autocomplete: daumAutocomplete.length,
             naver_autocomplete: naverAutocomplete.length,
             google_autocomplete: googleAutocomplete.length,
             naver_related: naverRelated.length,
+            daum_results: daumResultCount.toLocaleString(),
             naver_results: naverResultCount.toLocaleString(),
             google_results: googleResultCount.toLocaleString(),
         },
@@ -2167,7 +2244,7 @@ async function analyzeAdvancedSEOKeywords(keyword, searchEngine, includeQuestion
         related_keywords: relatedKeywords.slice(0, 15),
         question_keywords: questionKeywords.slice(0, 8),
         longtail_keywords: longtailKeywords.slice(0, 8),
-        search_engine_strategy: searchEngine === "both" ? searchEngineStrategy : searchEngineStrategy[searchEngine],
+        search_engine_strategy: searchEngine === "all" ? searchEngineStrategy : searchEngineStrategy[searchEngine],
         content_recommendations: {
             ideal_length: seoDifficulty > 60 ? "4000-6000자 (경쟁 대응)" : "2500-4000자",
             must_include: ["정의", "방법", "예시", "FAQ", "비교"],
@@ -3903,8 +3980,131 @@ function predictContentPerformance(title, description, platform, category, posti
 // Server Start
 // =============================================================================
 async function main() {
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error("Content Genie MCP Server v2.5 running on stdio");
+    const isHttpMode = process.env.MCP_HTTP_MODE === 'true' || process.argv.includes('--http');
+    const port = parseInt(process.env.PORT || '3000', 10);
+    if (isHttpMode) {
+        // HTTP/SSE 모드 (PlayMCP, 웹 클라이언트용)
+        console.log(`Starting Content Genie MCP Server v2.9.0 in HTTP mode on port ${port}...`);
+        const app = express();
+        app.use(cors());
+        app.use(express.json());
+        // 도구 목록 (PlayMCP 연결 확인용)
+        const toolsList = [
+            { name: "get_korean_trends", description: "다음/네이버 실시간 트렌드 조회" },
+            { name: "analyze_news_trends", description: "뉴스 트렌드 분석" },
+            { name: "get_seasonal_content_guide", description: "시즌 콘텐츠 가이드" },
+            { name: "analyze_seo_keywords", description: "SEO 키워드 심층 분석" },
+            { name: "generate_hashtag_strategy", description: "해시태그 전략 생성" },
+            { name: "analyze_competitor_content", description: "경쟁사 콘텐츠 분석" },
+            { name: "generate_content_ideas", description: "콘텐츠 아이디어 생성" },
+            { name: "optimize_title_hashtags", description: "제목/해시태그 최적화" },
+            { name: "create_content_calendar", description: "콘텐츠 캘린더 생성" },
+            { name: "generate_script_outline", description: "스크립트 아웃라인 생성" },
+            { name: "repurpose_content", description: "콘텐츠 리퍼포징" },
+            { name: "predict_viral_score", description: "바이럴 점수 예측" },
+            { name: "benchmark_content_performance", description: "성과 벤치마크" },
+            { name: "predict_content_performance", description: "콘텐츠 성과 예측" },
+            { name: "analyze_thumbnail", description: "썸네일 분석" },
+            { name: "generate_ab_test_variants", description: "A/B 테스트 변형 생성" },
+            { name: "analyze_influencer_collab", description: "인플루언서 협업 분석" },
+        ];
+        // Health check
+        app.get('/', (_req, res) => {
+            res.json({
+                status: 'ok',
+                server: 'content-genie-mcp',
+                version: '2.9.2',
+                tools: 17,
+                timestamp: new Date().toISOString()
+            });
+        });
+        app.get('/health', (_req, res) => {
+            res.json({
+                status: 'ok',
+                server: 'content-genie-mcp',
+                version: '2.9.2',
+                tools: 17,
+                timestamp: new Date().toISOString()
+            });
+        });
+        // MCP 엔드포인트 - PlayMCP 연결 확인용 (간단한 응답)
+        app.post('/mcp', (req, res) => {
+            const { method, id } = req.body;
+            // initialize 요청에 대한 응답
+            if (method === 'initialize') {
+                res.json({
+                    jsonrpc: '2.0',
+                    id,
+                    result: {
+                        protocolVersion: '2024-11-05',
+                        capabilities: { tools: { listChanged: true } },
+                        serverInfo: { name: 'content-genie-mcp', version: '2.9.2' }
+                    }
+                });
+                return;
+            }
+            // tools/list 요청에 대한 응답
+            if (method === 'tools/list') {
+                res.json({
+                    jsonrpc: '2.0',
+                    id,
+                    result: { tools: toolsList }
+                });
+                return;
+            }
+            // 기타 요청
+            res.json({
+                jsonrpc: '2.0',
+                id,
+                error: { code: -32601, message: 'Method not found' }
+            });
+        });
+        // SSE endpoint for MCP connection (MCP Inspector용)
+        const transports = new Map();
+        app.get('/sse', async (_req, res) => {
+            console.log('New SSE connection established');
+            const transport = new SSEServerTransport('/message', res);
+            const sessionId = crypto.randomUUID();
+            transports.set(sessionId, transport);
+            res.on('close', () => {
+                console.log('SSE connection closed');
+                transports.delete(sessionId);
+            });
+            await server.connect(transport);
+        });
+        // Message endpoint for MCP communication
+        app.post('/message', async (req, res) => {
+            const sessionId = req.query.sessionId;
+            if (!sessionId) {
+                const transport = Array.from(transports.values())[0];
+                if (transport) {
+                    await transport.handlePostMessage(req, res);
+                }
+                else {
+                    res.status(400).json({ error: 'No active session' });
+                }
+                return;
+            }
+            const transport = transports.get(sessionId);
+            if (transport) {
+                await transport.handlePostMessage(req, res);
+            }
+            else {
+                res.status(404).json({ error: 'Session not found' });
+            }
+        });
+        app.listen(port, () => {
+            console.log(`Content Genie MCP Server v2.9.0 running on HTTP port ${port}`);
+            console.log(`Health check: http://localhost:${port}/health`);
+            console.log(`MCP endpoint: http://localhost:${port}/mcp`);
+            console.log(`SSE endpoint: http://localhost:${port}/sse`);
+        });
+    }
+    else {
+        // stdio 모드 (Claude Desktop, Claude Code용)
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error("Content Genie MCP Server v2.9.0 running on stdio");
+    }
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "content-genie-mcp",
-  "version": "2.9.0",
+  "version": "2.9.2",
   "description": "AI Content Creation Assistant MCP - 한국 콘텐츠 크리에이터를 위한 트렌드 분석 및 콘텐츠 생성 도우미",
   "main": "dist/index.js",
   "bin": "dist/index.js",
@@ -12,6 +12,7 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
+    "start:http": "MCP_HTTP_MODE=true node dist/index.js",
     "dev": "ts-node src/index.ts",
     "prepare": "npm run build"
   },
@@ -35,9 +36,12 @@
     "@modelcontextprotocol/sdk": "^1.25.1",
     "axios": "^1.13.2",
     "cheerio": "^1.1.2",
+    "cors": "^2.8.5",
     "zod": "^4.2.1"
   },
   "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
     "@types/node": "^25.0.3",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"

package/railway.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://railway.app/railway.schema.json",
+  "build": {
+    "builder": "DOCKERFILE",
+    "dockerfilePath": "Dockerfile"
+  },
+  "deploy": {
+    "startCommand": "node dist/index.js",
+    "healthcheckPath": "/health",
+    "healthcheckTimeout": 30,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 3
+  }
+}