@sophia-vibelog/mcp-server 0.3.2 → 0.4.1

package/README.md

@@ -69,10 +69,10 @@ AI 코딩 세션 로그를 Sophia에 발행합니다.
 
 **사용법:**
 
-질문 끝에 `@@`를 붙이면 소피아가 질문 코칭을 제공합니다:
+질문 끝에 `??`를 붙이면 소피아가 질문 코칭을 제공합니다:
 
 ```
-사용자: "에러가 난다@@"
+사용자: "에러가 난다??"
 
 → Claude의 답변
 ...
@@ -93,11 +93,11 @@ AI 코딩 세션 로그를 Sophia에 발행합니다.
 ```
 
 **매개변수:**
-- `userMessage` (필수) — 평가할 사용자 메시지 (`@@`는 제거된 상태)
+- `userMessage` (필수) — 평가할 사용자 메시지 (`??`는 제거된 상태)
 - `conversationContext` (선택) — 대화 맥락
 
 **특징:**
-- 👓 `@@` = 안경 쓰고 자세히 보기
+- ❓ `??` = 질문을 더 잘하고 싶을 때
 - 💬 격려 중심 코칭 (점수/비판 없음)
 - 📍 답변 맨 마지막에 표시 (긴 스크롤 고려)
 

package/dist/index.js

@@ -1,29 +1,61 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
-const SOPHIA_API_URL = process.env.SOPHIA_API_URL || "http://localhost:3000";
+// ── 버전 (package.json에서 동적 로드) ──
+const require = createRequire(import.meta.url);
+const { version: PKG_VERSION } = require("../package.json");
+// ── 프로세스 레벨 에러 핸들러 (복구 없이 로깅 + 종료) ──
+process.on("uncaughtException", (err) => {
+    console.error("[sophia-mcp] uncaughtException:", err.message);
+    process.exit(1);
+});
+process.on("unhandledRejection", (reason) => {
+    console.error("[sophia-mcp] unhandledRejection:", reason);
+    process.exit(1);
+});
+// ── env 검증 (P0: 미설정 시 즉시 실패) ──
+const SOPHIA_API_URL = process.env.SOPHIA_API_URL || "";
 const SOPHIA_API_KEY = process.env.SOPHIA_API_KEY || "";
+const FETCH_TIMEOUT_MS = 30_000;
+if (!SOPHIA_API_URL) {
+    console.error("[sophia-mcp] SOPHIA_API_URL이 설정되지 않았습니다. MCP config의 env에 설정해주세요.");
+}
+if (!SOPHIA_API_KEY) {
+    console.error("[sophia-mcp] SOPHIA_API_KEY가 설정되지 않았습니다. MCP config의 env에 설정해주세요.");
+}
+/** env 미설정 시 도구 호출에서 반환할 에러 */
+function envError() {
+    const missing = [];
+    if (!SOPHIA_API_URL)
+        missing.push("SOPHIA_API_URL");
+    if (!SOPHIA_API_KEY)
+        missing.push("SOPHIA_API_KEY");
+    if (missing.length === 0)
+        return null;
+    return {
+        content: [
+            {
+                type: "text",
+                text: `환경변수가 설정되지 않았습니다: ${missing.join(", ")}.\nMCP config의 env 블록에 추가해주세요.\n예: "env": { "SOPHIA_API_KEY": "sk-...", "SOPHIA_API_URL": "https://..." }`,
+            },
+        ],
+        isError: true,
+    };
+}
 const server = new McpServer({
     name: "sophia-mcp",
-    version: "0.3.0",
+    version: PKG_VERSION,
 });
 server.tool("publish-log", "VibeLog에 AI 코딩 세션 로그를 발행합니다. 세션 로그 텍스트를 전달하면 AI가 분석하고 소피아가 조언을 남깁니다.", {
     rawSessionLog: z.string().describe("AI 코딩 세션의 전체 로그 텍스트"),
     title: z.string().optional().describe("로그 제목 (선택)"),
     projectId: z.string().optional().describe("프로젝트 ID (선택)"),
 }, async ({ rawSessionLog, title, projectId }) => {
-    if (!SOPHIA_API_KEY) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "SOPHIA_API_KEY가 설정되지 않았습니다. VibeLog 설정에서 API 키를 생성한 후 환경변수에 설정해주세요.",
-                },
-            ],
-            isError: true,
-        };
-    }
+    const env = envError();
+    if (env)
+        return env;
     try {
         const response = await fetch(`${SOPHIA_API_URL}/api/logs`, {
             method: "POST",
@@ -36,6 +68,7 @@ server.tool("publish-log", "VibeLog에 AI 코딩 세션 로그를 발행합니
                 title: title || undefined,
                 projectId: projectId || undefined,
             }),
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
         });
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
@@ -63,35 +96,27 @@ server.tool("publish-log", "VibeLog에 AI 코딩 세션 로그를 발행합니
         };
     }
     catch (e) {
+        const isTimeout = e instanceof DOMException && e.name === "TimeoutError";
+        const msg = isTimeout
+            ? `VibeLog 서버 응답 없음 (${FETCH_TIMEOUT_MS / 1000}초 타임아웃). 서버 상태를 확인해주세요: ${SOPHIA_API_URL}`
+            : `VibeLog 서버 연결 실패: ${e instanceof Error ? e.message : "알 수 없는 오류"}. SOPHIA_API_URL을 확인해주세요.`;
+        console.error(`[sophia-mcp] publish-log: ${msg}`);
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `VibeLog 서버 연결 실패: ${e instanceof Error ? e.message : "알 수 없는 오류"}. SOPHIA_API_URL을 확인해주세요.`,
-                },
-            ],
+            content: [{ type: "text", text: msg }],
             isError: true,
         };
     }
 });
-server.tool("rate-prompt", "사용자의 질문 품질을 평가하고 개선 제안을 제공합니다. 질문 끝에 @@가 붙어있을 때만 사용하세요. 중요: 이 도구를 호출한 후, 반환된 텍스트를 반드시 당신의 응답 본문 텍스트에 직접 포함시켜 출력하세요. 도구 결과 블록에만 남겨두면 사용자가 볼 수 없습니다. 응답의 가장 마지막에 --- 구분선 아래, 원본 포맷 그대로(━━━ 테두리, 들여쓰기, 이모지 포함) 복사해서 출력하세요. 재가공, 요약, 마크다운 변환을 하지 마세요.", {
-    userMessage: z.string().describe("평가할 사용자 메시지 (@@는 제거된 상태)"),
+server.tool("rate-prompt", "사용자의 질문 품질을 평가하고 개선 제안을 제공합니다. 질문 끝에 ??가 붙어있을 때만 사용하세요. 중요: 이 도구를 호출한 후, 반환된 텍스트를 반드시 당신의 응답 본문 텍스트에 직접 포함시켜 출력하세요. 도구 결과 블록에만 남겨두면 사용자가 볼 수 없습니다. 응답의 가장 마지막에 --- 구분선 아래, 원본 포맷 그대로(━━━ 테두리, 들여쓰기, 이모지 포함) 복사해서 출력하세요. 재가공, 요약, 마크다운 변환을 하지 마세요.", {
+    userMessage: z.string().describe("평가할 사용자 메시지 (??는 제거된 상태)"),
     conversationContext: z
         .string()
         .optional()
         .describe("대화 맥락 (선택사항)"),
 }, async ({ userMessage, conversationContext }) => {
-    if (!SOPHIA_API_KEY) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "SOPHIA_API_KEY가 설정되지 않았습니다. VibeLog 설정에서 API 키를 생성한 후 환경변수에 설정해주세요.",
-                },
-            ],
-            isError: true,
-        };
-    }
+    const env = envError();
+    if (env)
+        return env;
     try {
         const response = await fetch(`${SOPHIA_API_URL}/api/rate-prompt`, {
             method: "POST",
@@ -103,6 +128,7 @@ server.tool("rate-prompt", "사용자의 질문 품질을 평가하고 개선
                 userMessage,
                 conversationContext: conversationContext || undefined,
             }),
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
         });
         if (!response.ok) {
             const error = await response.json().catch(() => ({}));
@@ -116,7 +142,27 @@ server.tool("rate-prompt", "사용자의 질문 품질을 평가하고 개선
                 isError: true,
             };
         }
-        const result = await response.json();
+        const CoachingResultSchema = z.object({
+            encouragement: z.string(),
+            strengths: z.array(z.string()),
+            improvements: z.array(z.string()),
+            example: z.string(),
+        });
+        const raw = await response.json();
+        const parsed = CoachingResultSchema.safeParse(raw);
+        if (!parsed.success) {
+            console.error("[sophia-mcp] rate-prompt: 응답 스키마 불일치:", parsed.error.message);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "프롬프트 평가 결과를 처리할 수 없습니다. 서버 응답 형식이 예상과 다릅니다.",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = parsed.data;
         // 피드백 포맷팅
         let feedback = `\n━━━━━━━━━━━━━━━━━━━━━━━\n`;
         feedback += `💬 소피아의 질문 코칭\n\n`;
@@ -145,13 +191,13 @@ server.tool("rate-prompt", "사용자의 질문 품질을 평가하고 개선
         };
     }
     catch (e) {
+        const isTimeout = e instanceof DOMException && e.name === "TimeoutError";
+        const msg = isTimeout
+            ? `프롬프트 평가 서버 응답 없음 (${FETCH_TIMEOUT_MS / 1000}초 타임아웃). 서버 상태를 확인해주세요: ${SOPHIA_API_URL}`
+            : `프롬프트 평가 실패: ${e instanceof Error ? e.message : "알 수 없는 오류"}`;
+        console.error(`[sophia-mcp] rate-prompt: ${msg}`);
         return {
-            content: [
-                {
-                    type: "text",
-                    text: `프롬프트 평가 실패: ${e instanceof Error ? e.message : "알 수 없는 오류"}`,
-                },
-            ],
+            content: [{ type: "text", text: msg }],
             isError: true,
         };
     }

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@sophia-vibelog/mcp-server",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "Sophia (VibeLog) MCP Server — Claude Code에서 AI 코딩 세션 로그를 자동 발행합니다",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "sophia-mcp": "dist/index.js"
+    "mcp-server": "dist/index.js"
   },
   "files": [
     "dist",
@@ -26,6 +26,7 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
+    "test:smoke": "node test/smoke.mjs",
     "prepublishOnly": "npm run build",
     "lint": "echo 'no lint configured'"
   },