npm - todogether-mcp - Versions diffs - 1.0.0 → 1.0.2 - Mend

todogether-mcp 1.0.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/README.md CHANGED Viewed

@@ -3,10 +3,20 @@
 투두게더(todogether) MCP 서버. Claude에서 **로그인 → 오늘 할 일 조회**를 도구로 사용합니다.
 ## 도구
-- `todogether_login(email, password)` — 이메일/비밀번호로 로그인 (NextAuth credentials). 세션은 서버 프로세스가 살아있는 동안 유지됩니다.
-- `todogether_today_todos()` — 로그인된 계정의 오늘 할 일 조회 (매일 투두 + 진행 중 + 마감 지난 미완료, 앱의 "오늘 할 일"과 동일 기준).
+- `todogether_login(email, password)` — 이메일/비밀번호 로그인 (NextAuth credentials).
+- `todogether_login_social(provider)` — **카카오/네이버 자동 로그인**. 기본 브라우저가 자동으로 열리고, 로그인을 마치면 토큰이 자동 수신됩니다. (복사·붙여넣기 불필요)
+- `todogether_today_todos()` — 오늘 할 일 조회 (매일 투두 + 진행 중 + 마감 지난 미완료, 앱의 "오늘 할 일"과 동일 기준).
-> 소셜 로그인(카카오/네이버)은 브라우저가 필요해 MCP에선 지원하지 않습니다. 이메일 계정으로 사용하세요.
+세션은 MCP 서버 프로세스가 살아있는 동안 유지됩니다.
+### 보조 도구 (자동 로그인이 안 될 때만)
+- `todogether_social_login_url(provider)` — 소셜 로그인 시작 URL만 반환.
+- `todogether_login_handoff(handoff)` — 직접 받은 handoff 토큰/콜백 URL로 로그인.
+## 로그인 방법
+- **이메일 계정**: "투두게더 로그인해줘 (이메일: me@example.com)" → 비밀번호 입력 → 끝.
+- **카카오/네이버**: "카카오로 로그인해줘" → 브라우저가 자동으로 열림 → 로그인 → **자동 완료**.
+  - 동작 원리: MCP가 로컬 콜백 서버(`127.0.0.1:랜덤포트`)를 띄우고, 서버는 로그인 후 handoff를 그 콜백으로 전달합니다. 브라우저와 같은 PC에서 실행해야 합니다.
 ## 빌드
 ```bash

package/dist/index.js CHANGED Viewed

@@ -2,6 +2,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { createServer } from "node:http";
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
 // ── 투두게더 서버 ────────────────────────────────────────────────
 const BASE_URL = process.env.TODOGETHER_BASE_URL ?? "https://todo.thinkingcatworks.com";
 // ── 쿠키 잔(메모리) ──────────────────────────────────────────────
@@ -116,6 +119,84 @@ async function loginWithHandoff(input) {
     const who = session.user.handle ?? session.user.name ?? session.user.email ?? "사용자";
     return `소셜 로그인 성공: ${who}`;
 }
+// ── 소셜 자동 로그인 (브라우저 + 로컬 콜백 서버) ─────────────────
+// 로컬 HTTP 콜백 서버를 띄우고 브라우저를 자동으로 연다.
+// 서버는 oauth-clear?return_uri=http://127.0.0.1:PORT/cb 로 시작하고,
+// 로그인 완료 후 서버가 handoff 를 그 콜백으로 302 리다이렉트 → 자동 수신.
+function openBrowser(url) {
+    const p = platform();
+    const cmd = p === "darwin" ? "open" : p === "win32" ? "cmd" : "xdg-open";
+    const args = p === "win32" ? ["/c", "start", "", url] : [url];
+    try {
+        const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+        child.unref();
+    }
+    catch {
+        /* 브라우저 자동 오픈 실패 시 안내 메시지로 폴백 */
+    }
+}
+const DONE_HTML = (title, msg) => `<!DOCTYPE html><html lang="ko"><head><meta charset="utf-8"/>` +
+    `<meta name="viewport" content="width=device-width,initial-scale=1"/>` +
+    `<title>${title}</title></head>` +
+    `<body style="font-family:system-ui,-apple-system,sans-serif;display:flex;` +
+    `align-items:center;justify-content:center;min-height:90vh;margin:0;background:#1A1C1B;color:#fff">` +
+    `<div style="text-align:center;max-width:24rem;padding:2rem"><h2 style="margin:0 0 .5rem">${title}</h2>` +
+    `<p style="color:#a1a1aa;line-height:1.6">${msg}</p></div></body></html>`;
+function loginSocialAuto(provider) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const finish = (fn) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            try {
+                server.close();
+            }
+            catch {
+                /* noop */
+            }
+            fn();
+        };
+        const server = createServer(async (req, res) => {
+            const reqUrl = new URL(req.url ?? "/", "http://127.0.0.1");
+            if (!reqUrl.pathname.startsWith("/cb")) {
+                res.writeHead(404);
+                res.end();
+                return;
+            }
+            const handoff = reqUrl.searchParams.get("handoff");
+            if (!handoff) {
+                res.writeHead(400, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(DONE_HTML("로그인 실패", "handoff 토큰을 받지 못했습니다. 다시 시도해 주세요."));
+                finish(() => reject(new Error("콜백에 handoff 토큰이 없습니다.")));
+                return;
+            }
+            try {
+                const msg = await loginWithHandoff(handoff);
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(DONE_HTML("로그인 완료 ✅", "이 창을 닫고 Claude로 돌아가세요."));
+                finish(() => resolve(msg));
+            }
+            catch (e) {
+                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.end(DONE_HTML("로그인 실패", e.message));
+                finish(() => reject(e));
+            }
+        });
+        server.on("error", (e) => finish(() => reject(e)));
+        const timer = setTimeout(() => finish(() => reject(new Error("로그인 시간 초과(3분). 다시 시도해 주세요."))), 180_000);
+        // host 미지정 listen → 듀얼스택(IPv4 127.0.0.1 + IPv6 ::1) 모두 수신.
+        // 서버가 return_uri 를 localhost(::1)로 콜백하든 127.0.0.1 로 하든 안전하게 받기 위함.
+        server.listen(0, () => {
+            const addr = server.address();
+            const port = typeof addr === "object" && addr ? addr.port : 0;
+            const cb = `http://127.0.0.1:${port}/cb`;
+            const startUrl = `${BASE_URL}/auth/mobile/oauth-clear/${provider}?return_uri=${encodeURIComponent(cb)}`;
+            openBrowser(startUrl);
+        });
+    });
+}
 function kstToday() {
     // KST 기준 오늘 0시 ~ 24시
     const now = new Date();
@@ -179,6 +260,79 @@ async function getTodayTodos() {
     });
     return `오늘 할 일 ${todos.length}개:\n${lines.join("\n")}`;
 }
+// ── 오늘 할 일 세부 조회 ─────────────────────────────────────────
+async function getPledgeDetail(id) {
+    const res = await api(`/api/pledges/${id}`);
+    if (!res.ok)
+        return null;
+    const data = (await res.json().catch(() => null));
+    if (!data)
+        return null;
+    // API가 { pledge: ... } 또는 직접 Pledge 객체를 반환할 수 있음
+    return data.pledge ?? data;
+}
+async function getTodayTodosDetail() {
+    if (!isLoggedIn()) {
+        return "로그인이 필요합니다. 먼저 `todogether_login` 도구로 로그인해 주세요.";
+    }
+    const { start, end } = kstToday();
+    const [doingRes, expiredRes] = await Promise.all([
+        api("/api/pledges?type=doing&limit=50"),
+        api("/api/pledges?type=expired&limit=50"),
+    ]);
+    if (doingRes.status === 401 || doingRes.status === 403) {
+        return "세션이 만료되었습니다. 다시 로그인해 주세요.";
+    }
+    const doing = (await doingRes.json().catch(() => ({ pledges: [] }))).pledges ?? [];
+    const expired = expiredRes.ok
+        ? ((await expiredRes.json().catch(() => ({ pledges: [] }))).pledges ?? [])
+        : [];
+    const todayDoing = doing.filter((p) => {
+        if (p.isEveryday)
+            return true;
+        if (!p.startAt)
+            return true;
+        return new Date(p.startAt) <= end;
+    });
+    const overdue = expired.filter((p) => !p.isEveryday && p.isSuccess !== true);
+    const seen = new Set();
+    const todos = [...todayDoing, ...overdue].filter((p) => {
+        if (seen.has(p.id))
+            return false;
+        seen.add(p.id);
+        return true;
+    });
+    if (todos.length === 0)
+        return "오늘 할 일이 없습니다. 🎉";
+    // 각 할 일의 세부 정보를 병렬로 가져옴
+    const details = await Promise.all(todos.map((p) => getPledgeDetail(p.id)));
+    const lines = [];
+    for (let i = 0; i < todos.length; i++) {
+        const p = details[i] ?? todos[i];
+        const project = p.channelPledges?.[0]?.channel?.title;
+        const badges = [
+            p.isEveryday ? "매일" : null,
+            project ? `📁 ${project}` : p.category && p.category !== "미지정" ? p.category : null,
+        ]
+            .filter(Boolean)
+            .join(" · ");
+        const doneCount = p.subTodos?.filter((s) => s.isDone).length ?? 0;
+        const totalCount = p.subTodos?.length ?? 0;
+        const progress = totalCount > 0 ? ` (${doneCount}/${totalCount})` : "";
+        const deadline = p.endAt ? ` · 마감: ${p.endAt.slice(0, 10)}` : "";
+        lines.push(`\n${i + 1}. ${p.title}${badges ? `  [${badges}]` : ""}${progress}${deadline}`);
+        if (p.memo) {
+            lines.push(`   메모: ${p.memo}`);
+        }
+        if (p.subTodos && p.subTodos.length > 0) {
+            for (const sub of p.subTodos) {
+                const check = sub.isDone ? "✅" : "⬜";
+                lines.push(`   ${check} ${sub.title}${sub.memo ? ` (${sub.memo})` : ""}`);
+            }
+        }
+    }
+    return `오늘 할 일 ${todos.length}개:${lines.join("\n")}`;
+}
 // ── MCP 서버 ─────────────────────────────────────────────────────
 const server = new McpServer({ name: "todogether", version: "1.0.0" });
 server.registerTool("todogether_login", {
@@ -200,6 +354,31 @@ server.registerTool("todogether_login", {
         };
     }
 });
+server.registerTool("todogether_login_social", {
+    title: "소셜 로그인 (자동)",
+    description: "카카오/네이버 소셜 로그인을 자동으로 처리합니다. 기본 브라우저가 자동으로 열리며, 사용자가 로그인을 완료하면 토큰이 자동 수신되어 로그인됩니다. (복사·붙여넣기 불필요)",
+    inputSchema: {
+        provider: z.enum(["kakao", "naver"]).describe("소셜 로그인 제공자"),
+    },
+}, async ({ provider }) => {
+    try {
+        const msg = await loginSocialAuto(provider);
+        return { content: [{ type: "text", text: msg }] };
+    }
+    catch (e) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ ${e.message}\n\n` +
+                        `브라우저가 자동으로 열리지 않았다면, 직접 로그인 후 ` +
+                        `todogether_login_handoff 도구로 handoff 토큰을 전달하는 방법(todogether_social_login_url)도 있습니다.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
 server.registerTool("todogether_social_login_url", {
     title: "소셜 로그인 시작 URL",
     description: "카카오/네이버 소셜 로그인 시작 URL을 반환합니다. 사용자는 이 URL을 브라우저에서 열어 로그인한 뒤, 리다이렉트되는 'todogether://...?handoff=...' URL(또는 handoff 토큰)을 todogether_login_handoff 에 전달해야 합니다.",
@@ -256,5 +435,21 @@ server.registerTool("todogether_today_todos", {
         };
     }
 });
+server.registerTool("todogether_today_todos_detail", {
+    title: "오늘 할 일 세부 내용 가져오기",
+    description: "로그인된 투두게더 계정의 오늘 할 일 목록을 세부 내용(서브태스크 제목·완료 여부·메모, 마감일 등)까지 포함해 가져옵니다.",
+    inputSchema: {},
+}, async () => {
+    try {
+        const text = await getTodayTodosDetail();
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: `❌ 조회 실패: ${e.message}` }],
+            isError: true,
+        };
+    }
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "todogether-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "투두게더(todogether) MCP 서버 — 로그인 후 오늘 할 일 조회",
   "type": "module",
   "license": "MIT",