todogether-mcp 1.0.0

package/README.md

@@ -0,0 +1,75 @@
+# todogether-mcp
+
+투두게더(todogether) MCP 서버. Claude에서 **로그인 → 오늘 할 일 조회**를 도구로 사용합니다.
+
+## 도구
+- `todogether_login(email, password)` — 이메일/비밀번호로 로그인 (NextAuth credentials). 세션은 서버 프로세스가 살아있는 동안 유지됩니다.
+- `todogether_today_todos()` — 로그인된 계정의 오늘 할 일 조회 (매일 투두 + 진행 중 + 마감 지난 미완료, 앱의 "오늘 할 일"과 동일 기준).
+
+> 소셜 로그인(카카오/네이버)은 브라우저가 필요해 MCP에선 지원하지 않습니다. 이메일 계정으로 사용하세요.
+
+## 빌드
+```bash
+cd todogether-mcp
+npm install
+npm run build   # dist/index.js 생성
+```
+
+## 배포 (만드는 사람 — npm publish)
+```bash
+cd todogether-mcp
+npm login                 # npm 계정 로그인 (최초 1회)
+npm publish --access public
+```
+- `prepublishOnly` 스크립트가 자동으로 빌드합니다.
+- 버전 올릴 때: `npm version patch && npm publish`
+
+## 설치 (받는 사람 — 클론·빌드 불필요)
+배포된 뒤에는 한 줄로 등록할 수 있습니다.
+
+**Claude Code:**
+```bash
+claude mcp add todogether -- npx -y todogether-mcp
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "todogether": {
+      "command": "npx",
+      "args": ["-y", "todogether-mcp"]
+    }
+  }
+}
+```
+
+## Claude Desktop 등록
+`~/Library/Application Support/Claude/claude_desktop_config.json` 의 `mcpServers` 에 추가:
+```json
+{
+  "mcpServers": {
+    "todogether": {
+      "command": "node",
+      "args": ["/Users/minhyuk/dev/workspace/thinkingcat_2.0/PROD_todogether/todogether-mcp/dist/index.js"]
+    }
+  }
+}
+```
+저장 후 Claude Desktop 재시작.
+
+## Claude Code 등록 (CLI)
+```bash
+claude mcp add todogether -- node /Users/minhyuk/dev/workspace/thinkingcat_2.0/PROD_todogether/todogether-mcp/dist/index.js
+```
+
+## 사용 예
+1. "투두게더에 로그인해줘 (이메일: me@example.com)" → `todogether_login` 실행 (비밀번호는 입력 요청)
+2. "오늘 할 일 가져와줘" → `todogether_today_todos` 실행
+
+## 환경 변수 (선택)
+- `TODOGETHER_BASE_URL` — 기본값 `https://todo.thinkingcatworks.com`. 로컬/스테이징 서버로 바꿀 때 사용.
+
+## 보안 참고
+- 비밀번호는 도구 인자로 전달되어 서버에 로그인 요청에만 쓰이고 디스크에 저장하지 않습니다(세션 쿠키만 메모리 유지).
+- 신뢰하는 환경에서만 사용하세요.

package/dist/index.js

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+// ── 투두게더 서버 ────────────────────────────────────────────────
+const BASE_URL = process.env.TODOGETHER_BASE_URL ?? "https://todo.thinkingcatworks.com";
+// ── 쿠키 잔(메모리) ──────────────────────────────────────────────
+// MCP 서버 프로세스가 살아있는 동안 NextAuth 세션 쿠키를 유지한다.
+const cookieJar = new Map();
+function cookieHeader() {
+    return Array.from(cookieJar.entries())
+        .map(([k, v]) => `${k}=${v}`)
+        .join("; ");
+}
+function storeSetCookies(res) {
+    // Node 18+ fetch: getSetCookie() 로 여러 Set-Cookie 추출
+    const raw = res.headers.getSetCookie?.();
+    const list = raw ?? (res.headers.get("set-cookie") ? [res.headers.get("set-cookie")] : []);
+    for (const line of list) {
+        const [pair] = line.split(";");
+        const idx = pair.indexOf("=");
+        if (idx > 0) {
+            const name = pair.slice(0, idx).trim();
+            const value = pair.slice(idx + 1).trim();
+            if (value === "" || value === "deleted")
+                cookieJar.delete(name);
+            else
+                cookieJar.set(name, value);
+        }
+    }
+}
+async function api(path, init = {}) {
+    const headers = new Headers(init.headers);
+    headers.set("Accept", "application/json");
+    const cookie = cookieHeader();
+    if (cookie)
+        headers.set("Cookie", cookie);
+    const res = await fetch(`${BASE_URL}${path}`, { ...init, headers, redirect: "manual" });
+    storeSetCookies(res);
+    return res;
+}
+function isLoggedIn() {
+    // NextAuth 세션 쿠키 존재 여부로 1차 판단
+    return Array.from(cookieJar.keys()).some((k) => k.includes("session-token"));
+}
+// ── 로그인 (이메일/비밀번호 credentials) ─────────────────────────
+async function login(email, password) {
+    // 1) CSRF 토큰
+    const csrfRes = await api("/api/auth/csrf");
+    if (!csrfRes.ok)
+        throw new Error(`CSRF 요청 실패 (${csrfRes.status})`);
+    const { csrfToken } = (await csrfRes.json());
+    // 2) credentials 콜백 (NextAuth)
+    const body = new URLSearchParams({
+        email,
+        password,
+        csrfToken,
+        redirect: "false",
+        json: "true",
+    });
+    await api("/api/auth/callback/credentials", {
+        method: "POST",
+        headers: { "Content-Type": "application/x-www-form-urlencoded" },
+        body: body.toString(),
+    });
+    // 3) 세션 확인
+    const sessionRes = await api("/api/auth/session");
+    const session = (await sessionRes.json().catch(() => null));
+    if (!session?.user) {
+        throw new Error("로그인에 실패했습니다. 이메일 또는 비밀번호를 확인해 주세요.");
+    }
+    const who = session.user.handle ?? session.user.name ?? session.user.email ?? "사용자";
+    return `로그인 성공: ${who}`;
+}
+// ── 소셜 로그인 (핸드오프 토큰 방식) ─────────────────────────────
+// 카카오/네이버는 브라우저 OAuth 가 필요하므로 2단계로 동작한다:
+//  1) todogether_social_login_url 로 시작 URL 을 받아 브라우저에서 로그인
+//  2) 로그인 후 리다이렉트되는 todogether://...?handoff=JWT 의 handoff 값을
+//     todogether_login_handoff 에 넣으면 세션 쿠키로 교환
+function socialLoginStartUrl(provider) {
+    return `${BASE_URL}/auth/mobile/oauth-clear/${provider}`;
+}
+/** 입력이 콜백 URL 이면 handoff 쿼리값을, JWT 문자열이면 그대로 반환 */
+function extractHandoff(input) {
+    const s = input.trim();
+    // URL 형태(todogether://... 또는 https://...)면 handoff 파라미터 추출
+    if (s.includes("handoff=")) {
+        try {
+            const q = s.split("?")[1] ?? s;
+            const params = new URLSearchParams(q);
+            const h = params.get("handoff");
+            if (h)
+                return h;
+        }
+        catch {
+            /* fallthrough */
+        }
+    }
+    return s; // JWT 그대로
+}
+async function loginWithHandoff(input) {
+    const handoff = extractHandoff(input);
+    if (!handoff || handoff.split(".").length < 2) {
+        throw new Error("유효한 handoff 토큰이 아닙니다. (JWT 또는 todogether://...?handoff=... URL)");
+    }
+    // 세션 쿠키 교환
+    const res = await api(`/api/auth/mobile-webview-session?handoff=${encodeURIComponent(handoff)}`);
+    if (!res.ok) {
+        throw new Error(`핸드오프 세션 교환 실패 (${res.status})`);
+    }
+    // 세션 확인
+    const session = (await (await api("/api/auth/session")).json().catch(() => null));
+    if (!session?.user) {
+        throw new Error("핸드오프 로그인에 실패했습니다. 토큰이 만료되었을 수 있습니다(보통 2분 이내 유효).");
+    }
+    const who = session.user.handle ?? session.user.name ?? session.user.email ?? "사용자";
+    return `소셜 로그인 성공: ${who}`;
+}
+function kstToday() {
+    // KST 기준 오늘 0시 ~ 24시
+    const now = new Date();
+    const kstMs = now.getTime() + 9 * 60 * 60 * 1000;
+    const kst = new Date(kstMs);
+    const y = kst.getUTCFullYear();
+    const m = kst.getUTCMonth();
+    const d = kst.getUTCDate();
+    const startUtc = Date.UTC(y, m, d) - 9 * 60 * 60 * 1000;
+    return { start: new Date(startUtc), end: new Date(startUtc + 24 * 60 * 60 * 1000) };
+}
+async function getTodayTodos() {
+    if (!isLoggedIn()) {
+        return "로그인이 필요합니다. 먼저 `todogether_login` 도구로 로그인해 주세요.";
+    }
+    const { start, end } = kstToday();
+    // 진행 중(doing) + 만료(expired·미완료) 를 합쳐 앱의 "오늘 할 일"과 동일하게 구성
+    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 ?? [])
+        : [];
+    // 오늘 할 일: 매일 투두 + 이미 시작된 투두(startAt <= 오늘 끝) + 마감 지난 미완료
+    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 lines = todos.map((p, 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 sub = p.subTodos?.length
+            ? ` (${p.subTodos.filter((s) => s.isDone).length}/${p.subTodos.length})`
+            : "";
+        const head = badges ? `${p.title}  [${badges}]` : p.title;
+        return `${i + 1}. ${head}${sub}`;
+    });
+    return `오늘 할 일 ${todos.length}개:\n${lines.join("\n")}`;
+}
+// ── MCP 서버 ─────────────────────────────────────────────────────
+const server = new McpServer({ name: "todogether", version: "1.0.0" });
+server.registerTool("todogether_login", {
+    title: "투두게더 로그인",
+    description: "투두게더에 이메일/비밀번호로 로그인합니다. 로그인 후 같은 세션에서 오늘 할 일 등을 조회할 수 있습니다.",
+    inputSchema: {
+        email: z.string().describe("투두게더 계정 이메일"),
+        password: z.string().describe("비밀번호"),
+    },
+}, async ({ email, password }) => {
+    try {
+        const msg = await login(email, password);
+        return { content: [{ type: "text", text: msg }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: `❌ ${e.message}` }],
+            isError: true,
+        };
+    }
+});
+server.registerTool("todogether_social_login_url", {
+    title: "소셜 로그인 시작 URL",
+    description: "카카오/네이버 소셜 로그인 시작 URL을 반환합니다. 사용자는 이 URL을 브라우저에서 열어 로그인한 뒤, 리다이렉트되는 'todogether://...?handoff=...' URL(또는 handoff 토큰)을 todogether_login_handoff 에 전달해야 합니다.",
+    inputSchema: {
+        provider: z.enum(["kakao", "naver"]).describe("소셜 로그인 제공자"),
+    },
+}, async ({ provider }) => {
+    const url = socialLoginStartUrl(provider);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${provider} 로그인 URL:\n${url}\n\n` +
+                    `① 위 URL을 브라우저에서 열어 로그인하세요.\n` +
+                    `② 로그인 후 'todogether://...?handoff=...' 로 리다이렉트되면, 그 전체 URL(또는 handoff 값)을 복사해\n` +
+                    `   todogether_login_handoff 도구에 전달하세요. (handoff 토큰은 보통 2분 내 만료되니 바로 진행하세요)`,
+            },
+        ],
+    };
+});
+server.registerTool("todogether_login_handoff", {
+    title: "핸드오프 토큰으로 로그인",
+    description: "소셜 로그인 후 받은 handoff 토큰(JWT) 또는 'todogether://...?handoff=...' 콜백 URL로 세션을 교환해 로그인합니다.",
+    inputSchema: {
+        handoff: z
+            .string()
+            .describe("handoff JWT 토큰 또는 todogether://...?handoff=... 형태의 콜백 URL"),
+    },
+}, async ({ handoff }) => {
+    try {
+        const msg = await loginWithHandoff(handoff);
+        return { content: [{ type: "text", text: msg }] };
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: `❌ ${e.message}` }],
+            isError: true,
+        };
+    }
+});
+server.registerTool("todogether_today_todos", {
+    title: "오늘 할 일 가져오기",
+    description: "로그인된 투두게더 계정의 오늘 할 일 목록을 가져옵니다. (매일 투두 + 진행 중 + 마감 지난 미완료 포함)",
+    inputSchema: {},
+}, async () => {
+    try {
+        const text = await getTodayTodos();
+        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

@@ -0,0 +1,38 @@
+{
+  "name": "todogether-mcp",
+  "version": "1.0.0",
+  "description": "투두게더(todogether) MCP 서버 — 로그인 후 오늘 할 일 조회",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "todogether",
+    "claude",
+    "todo"
+  ],
+  "bin": {
+    "todogether-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^20.14.0"
+  }
+}