@sophia-vibelog/mcp-server 0.1.0 → 0.2.0

package/README.md

@@ -22,11 +22,13 @@ Sophia 웹 대시보드 → 설정 → API 키 관리에서 새 키를 생성합
 ```json
 {
   "mcpServers": {
-    "vibelog": {
-      "command": "vibelog-mcp",
+    "sophia": {
+      "command": "npx",
+      "args": ["@sophia-vibelog/mcp-server"],
       "env": {
-        "VIBELOG_API_KEY": "your-api-key-here",
-        "VIBELOG_API_URL": "https://your-sophia-instance.com"
+        "SOPHIA_API_KEY": "your-api-key-here",
+        "SOPHIA_API_URL": "https://sophia-vibelog.site",
+        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
       }
     }
   }
@@ -37,8 +39,9 @@ Sophia 웹 대시보드 → 설정 → API 키 관리에서 새 키를 생성합
 
 | 변수 | 필수 | 기본값 | 설명 |
 |------|------|--------|------|
-| `VIBELOG_API_KEY` | O | - | Sophia에서 발급받은 API 키 |
-| `VIBELOG_API_URL` | X | `http://localhost:3000` | Sophia 서버 URL |
+| `SOPHIA_API_KEY` | O | - | Sophia에서 발급받은 API 키 |
+| `SOPHIA_API_URL` | X | `http://localhost:3000` | Sophia 서버 URL |
+| `ANTHROPIC_API_KEY` | △ | - | Claude API 키 (rate-prompt 사용 시 필요) |
 
 ## 사용법
 
@@ -60,6 +63,44 @@ AI 코딩 세션 로그를 Sophia에 발행합니다.
 - `title` (선택) — 로그 제목
 - `projectId` (선택) — 프로젝트 ID
 
+#### `rate-prompt`
+
+사용자 질문의 품질을 평가하고 개선 방향을 제안합니다.
+
+**사용법:**
+
+질문 끝에 `@@`를 붙이면 소피아가 질문 코칭을 제공합니다:
+
+```
+사용자: "에러가 난다@@"
+
+→ Claude의 답변
+...
+━━━━━━━━━━━━━━━━━━━━━━━
+💬 소피아의 질문 코칭
+
+좀 더 구체적으로 말씀해주시면
+훨씬 정확한 답변을 드릴 수 있어요!
+
+🎯 이 정보가 있으면 완벽해요
+  • 어느 페이지/기능에서 발생했나요?
+  • 어떤 에러 메시지가 보이나요?
+
+✨ 예를 들면 이렇게요
+  "○○ 페이지에서 △△ 버튼을 눌렀을 때
+   'Type error: ...' 에러가 발생해요"
+━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**매개변수:**
+- `userMessage` (필수) — 평가할 사용자 메시지 (`@@`는 제거된 상태)
+- `conversationContext` (선택) — 대화 맥락
+
+**특징:**
+- 👓 `@@` = 안경 쓰고 자세히 보기
+- 💬 격려 중심 코칭 (점수/비판 없음)
+- 📍 답변 맨 마지막에 표시 (긴 스크롤 고려)
+
 ## 개발
 
 ```bash

package/dist/index.js

@@ -2,8 +2,13 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import Anthropic from "@anthropic-ai/sdk";
 const SOPHIA_API_URL = process.env.SOPHIA_API_URL || "http://localhost:3000";
 const SOPHIA_API_KEY = process.env.SOPHIA_API_KEY || "";
+const ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY || "";
+const anthropic = ANTHROPIC_API_KEY
+    ? new Anthropic({ apiKey: ANTHROPIC_API_KEY })
+    : null;
 const server = new McpServer({
     name: "sophia-mcp",
     version: "0.1.0",
@@ -74,6 +79,98 @@ server.tool("publish-log", "VibeLog에 AI 코딩 세션 로그를 발행합니
         };
     }
 });
+server.tool("rate-prompt", "사용자의 질문 품질을 평가하고 개선 제안을 제공합니다. 질문 끝에 @@가 붙어있을 때만 사용하세요.", {
+    userMessage: z.string().describe("평가할 사용자 메시지 (@@는 제거된 상태)"),
+    conversationContext: z
+        .string()
+        .optional()
+        .describe("대화 맥락 (선택사항)"),
+}, async ({ userMessage, conversationContext }) => {
+    if (!anthropic) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "ANTHROPIC_API_KEY가 설정되지 않았습니다. 환경변수에 API 키를 설정해주세요.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        const prompt = `당신은 '소피아'로, 사용자의 질문을 더 나아지도록 돕는 친절한 코치입니다.
+
+사용자의 질문을 분석하고, 격려하면서 개선 포인트를 제안해주세요.
+절대 점수를 매기거나 비판하지 마세요. 파트너처럼 함께 더 나은 질문을 만들어가는 느낌으로.
+
+평가 기준:
+- 위치: 어디서 발생했는지 명확한가?
+- 동작: 무엇을 했는지 명확한가?
+- 증상: 무슨 일이 일어났는지 명확한가?
+- 에러 메시지: 구체적인 에러가 있는가?
+- 예상 vs 실제: 원래 어떻게 되어야 하는지 설명했는가?
+
+사용자 질문:
+"${userMessage}"
+
+${conversationContext ? `대화 맥락:\n${conversationContext}` : ""}
+
+출력 형식 (반드시 JSON):
+{
+  "encouragement": "격려 메시지 (예: '좀 더 구체적으로 말씀해주시면 훨씬 정확한 답변을 드릴 수 있어요!')",
+  "strengths": ["이미 좋은 점1", "이미 좋은 점2"] (없으면 빈 배열),
+  "improvements": ["필요한 정보1", "필요한 정보2"] (예: "어느 페이지/기능에서 발생했나요?"),
+  "example": "구체적인 질문 예시 (한 문장)"
+}`;
+        const response = await anthropic.messages.create({
+            model: "claude-3-5-sonnet-20241022",
+            max_tokens: 1024,
+            messages: [{ role: "user", content: prompt }],
+        });
+        const textContent = response.content.find((c) => c.type === "text");
+        if (!textContent || textContent.type !== "text") {
+            throw new Error("No text content in response");
+        }
+        const result = JSON.parse(textContent.text);
+        // 피드백 포맷팅
+        let feedback = `\n━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        feedback += `💬 소피아의 질문 코칭\n\n`;
+        feedback += `${result.encouragement}\n`;
+        if (result.strengths.length > 0) {
+            feedback += `\n✨ 이미 좋은 점 / 이 질문이 좋은 이유\n`;
+            result.strengths.forEach((s) => {
+                feedback += `  • ${s}\n`;
+            });
+        }
+        if (result.improvements.length > 0) {
+            const header = result.strengths.length > 0
+                ? `\n💡 한 가지만 더하면 완벽\n`
+                : `\n🎯 이것만 더 알려주세요\n`;
+            feedback += header;
+            result.improvements.forEach((i) => {
+                feedback += `  • ${i}\n`;
+            });
+        }
+        if (result.example) {
+            feedback += `\n✨ 예를 들면 이렇게요\n  "${result.example}"\n`;
+        }
+        feedback += `\n━━━━━━━━━━━━━━━━━━━━━━━\n`;
+        return {
+            content: [{ type: "text", text: feedback }],
+        };
+    }
+    catch (e) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `프롬프트 평가 실패: ${e instanceof Error ? e.message : "알 수 없는 오류"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sophia-vibelog/mcp-server",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Sophia (VibeLog) MCP Server — Claude Code에서 AI 코딩 세션 로그를 자동 발행합니다",
   "type": "module",
   "main": "dist/index.js",
@@ -30,6 +30,7 @@
     "lint": "echo 'no lint configured'"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.74.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^4.3.6"
   },