@milcho0604/velog-mcp 0.4.0

package/dist/render/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../src/render/page.ts"],"names":[],"mappings":"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"}

package/dist/render/tones.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 색 팔레트.
+ *
+ * ★ 색을 자유 문자열로 받지 않는 이유가 두 가지다.
+ *
+ *   ① 보안 — 이 값들은 결국 브라우저에서 SVG 속성이 된다. `url(#x)` 나
+ *      `image-set(...)` 같은 값이 들어가면 우리가 의도하지 않은 참조가 생긴다.
+ *      (렌더러가 네트워크를 못 쓰게 막아두긴 했지만, 입력 단계에서 한 번 더 좁힌다.)
+ *   ② 일관성 — 파스텔 배경 + 진한 테두리 조합을 매번 모델이 고르면 그림마다
+ *      톤이 달라진다. 이름으로만 고르게 해서 어느 글에 넣어도 같은 인상이 되게 한다.
+ */
+/** 그룹 박스용 — 옅은 배경 + 같은 계열의 진한 테두리. */
+export interface Tone {
+    readonly fill: string;
+    readonly stroke: string;
+    /** 이 톤을 액센트(배지·선)로 쓸 때의 진한 색 */
+    readonly solid: string;
+}
+export declare const TONES: Record<string, Tone>;
+export declare const TONE_NAMES: ReadonlyArray<string>;
+export declare function tone(name: string | undefined, fallback?: string): Tone;
+export declare function isHexColor(value: string): boolean;
+/** 평면(흐름 종류) 기본값 — 요청/외부/데이터/모니터링. */
+export interface Plane {
+    readonly key: string;
+    readonly name: string;
+    readonly color: string;
+    readonly dash?: string | undefined;
+}
+export declare const DEFAULT_PLANES: readonly Plane[];

package/dist/render/tones.js

@@ -0,0 +1,46 @@
+/**
+ * 색 팔레트.
+ *
+ * ★ 색을 자유 문자열로 받지 않는 이유가 두 가지다.
+ *
+ *   ① 보안 — 이 값들은 결국 브라우저에서 SVG 속성이 된다. `url(#x)` 나
+ *      `image-set(...)` 같은 값이 들어가면 우리가 의도하지 않은 참조가 생긴다.
+ *      (렌더러가 네트워크를 못 쓰게 막아두긴 했지만, 입력 단계에서 한 번 더 좁힌다.)
+ *   ② 일관성 — 파스텔 배경 + 진한 테두리 조합을 매번 모델이 고르면 그림마다
+ *      톤이 달라진다. 이름으로만 고르게 해서 어느 글에 넣어도 같은 인상이 되게 한다.
+ */
+export const TONES = {
+    slate: { fill: '#f8fafc', stroke: '#94a3b8', solid: '#475569' },
+    gray: { fill: '#f9fafb', stroke: '#9ca3af', solid: '#4b5563' },
+    blue: { fill: '#eff6ff', stroke: '#3b82f6', solid: '#2563eb' },
+    green: { fill: '#f0fdf4', stroke: '#22c55e', solid: '#16a34a' },
+    amber: { fill: '#fff7ed', stroke: '#f59e0b', solid: '#d97706' },
+    yellow: { fill: '#fefce8', stroke: '#ca8a04', solid: '#a16207' },
+    purple: { fill: '#faf5ff', stroke: '#a855f7', solid: '#7e5bd0' },
+    teal: { fill: '#f0fdfa', stroke: '#14b8a6', solid: '#0e7490' },
+    rose: { fill: '#fff1f2', stroke: '#f43f5e', solid: '#e11d48' },
+    indigo: { fill: '#eef2ff', stroke: '#6366f1', solid: '#4f46e5' },
+};
+export const TONE_NAMES = Object.keys(TONES);
+export function tone(name, fallback = 'gray') {
+    return TONES[name ?? fallback] ?? TONES[fallback] ?? {
+        fill: '#f9fafb',
+        stroke: '#9ca3af',
+        solid: '#4b5563',
+    };
+}
+/**
+ * 직접 지정한 색은 `#rgb` / `#rrggbb` 만 받는다.
+ * 함수 표기(`url(...)`, `var(...)`)와 상대 URL 을 원천 차단하기 위해서다.
+ */
+const HEX = /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/;
+export function isHexColor(value) {
+    return HEX.test(value);
+}
+export const DEFAULT_PLANES = [
+    { key: 'r', name: '요청', color: '#64748b' },
+    { key: 'e', name: '외부 호출', color: '#7e5bd0' },
+    { key: 'd', name: '데이터', color: '#d97706' },
+    { key: 'm', name: '관측', color: '#0e7490', dash: '6 4' },
+];
+//# sourceMappingURL=tones.js.map

package/dist/render/tones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tones.js","sourceRoot":"","sources":["../../src/render/tones.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,CAAC,MAAM,KAAK,GAAyB;IAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC/D,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9D,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9D,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC/D,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC/D,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAChE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAChE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9D,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;IAC9D,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;CAChE,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAA0B,CAAC;AAEtE,MAAM,UAAU,IAAI,CAAC,IAAwB,EAAE,QAAQ,GAAG,MAAM;IAC/D,OAAO,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI;QACpD,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,SAAS;KAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,GAAG,GAAG,sCAAsC,CAAC;AAEnD,MAAM,UAAU,UAAU,CAAC,KAAa;IACvC,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxB,CAAC;AAUD,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC/C,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE;IAC1C,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;IAC7C,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;IAC3C,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;CACvD,CAAC"}

package/dist/slug.d.ts

@@ -0,0 +1,42 @@
+/**
+ * url_slug 생성.
+ *
+ * 벨로그는 `WritePostInput.url_slug` 를 필수로 받는다. 사용자가 안 주면 제목에서
+ * 만든다. 벨로그 자체는 한글 슬러그를 허용하므로(예: /@witwint/프로메테우스)
+ * 한글을 로마자로 바꾸지 않고 그대로 둔다 — 억지 음차보다 원문이 낫다.
+ */
+/**
+ * 이미지 URL 검사.
+ *
+ * ★ zod 의 `z.string().url()` 로는 부족하다. 실측하면 아래를 전부 통과시킨다:
+ *     javascript:alert(1)          data:text/html,<script>…
+ *     file:///etc/passwd           http://127.0.0.1/…
+ *   URL 형식이 맞는지만 보고 스킴은 안 따지기 때문이다. 썸네일은 결국 남의
+ *   페이지에서 렌더되므로 http/https 로 못 박는다.
+ */
+export declare function isSafeHttpUrl(value: string): boolean;
+/**
+ * 이미지용. 현재 규칙은 http(s) + 호스트 존재로 같아서 그대로 위임한다.
+ * 구현을 복사하지 않는다 — 한쪽만 고쳐지는 사고를 이 레포에서 이미 두 번 겪었다.
+ */
+export declare const isSafeImageUrl: typeof isSafeHttpUrl;
+/** URL 에서 실제로 문제가 되는 문자만 제거한다. */
+export declare function slugify(title: string): string;
+/** 벨로그 슬러그 길이 상한이 문서화돼 있지 않아 보수적으로 자른다. */
+export declare const MAX_SLUG_LENGTH = 120;
+export declare function toUrlSlug(title: string, provided?: string): string;
+/**
+ * 프로필 홈페이지 링크 검사.
+ *
+ * 벨로그 웹은 값에 http(s) 스킴이 없으면 렌더링 시점에 `https://` 를 붙인다
+ * (apps/web/src/lib/includeProtocol.ts). 그래서 `example.com` 도, `example.com:8080`
+ * 도 정상 입력이다. 우리가 http(s) 만 받으면 정상 사용을 막는다.
+ *
+ * ★ 반대로 막아야 하는 건 `javascript:`·`data:` 같은 위험 스킴인데, 정규식으로
+ *   '스킴처럼 생겼나' 를 보면 두 방향으로 다 틀린다:
+ *     - `example.com:8080` 을 스킴으로 오인해 거부
+ *     - `" javascript:…"` 처럼 앞에 공백을 붙이면 통과 (실측 확인)
+ *   그래서 정규식 대신 **웹과 같은 방식으로 실제 URL 을 만들어 본다.**
+ *   앞뒤 공백은 먼저 제거한다 — 공백 하나로 검사가 뚫리면 안 된다.
+ */
+export declare function isSafeProfileLink(value: string): boolean;

package/dist/slug.js

@@ -0,0 +1,79 @@
+/**
+ * url_slug 생성.
+ *
+ * 벨로그는 `WritePostInput.url_slug` 를 필수로 받는다. 사용자가 안 주면 제목에서
+ * 만든다. 벨로그 자체는 한글 슬러그를 허용하므로(예: /@witwint/프로메테우스)
+ * 한글을 로마자로 바꾸지 않고 그대로 둔다 — 억지 음차보다 원문이 낫다.
+ */
+/**
+ * 이미지 URL 검사.
+ *
+ * ★ zod 의 `z.string().url()` 로는 부족하다. 실측하면 아래를 전부 통과시킨다:
+ *     javascript:alert(1)          data:text/html,<script>…
+ *     file:///etc/passwd           http://127.0.0.1/…
+ *   URL 형식이 맞는지만 보고 스킴은 안 따지기 때문이다. 썸네일은 결국 남의
+ *   페이지에서 렌더되므로 http/https 로 못 박는다.
+ */
+export function isSafeHttpUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:')
+        return false;
+    return url.hostname.length > 0;
+}
+/**
+ * 이미지용. 현재 규칙은 http(s) + 호스트 존재로 같아서 그대로 위임한다.
+ * 구현을 복사하지 않는다 — 한쪽만 고쳐지는 사고를 이 레포에서 이미 두 번 겪었다.
+ */
+export const isSafeImageUrl = isSafeHttpUrl;
+/** URL 에서 실제로 문제가 되는 문자만 제거한다. */
+export function slugify(title) {
+    const slug = title
+        .trim()
+        .toLowerCase()
+        // 경로·쿼리·프래그먼트 구분자와 공백류를 하이픈으로
+        .replace(/[\s/?#&=+%<>\\[\]{}|^~`"'`]+/g, '-')
+        // 나머지 구두점 제거 (한글·영숫자·하이픈·밑줄만 남긴다)
+        .replace(/[^\p{Letter}\p{Number}\-_]/gu, '')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-+|-+$/g, '');
+    // 전부 걸러진 경우(기호만으로 된 제목) 빈 슬러그를 주면 벨로그가 거부한다.
+    return slug || 'untitled';
+}
+/** 벨로그 슬러그 길이 상한이 문서화돼 있지 않아 보수적으로 자른다. */
+export const MAX_SLUG_LENGTH = 120;
+export function toUrlSlug(title, provided) {
+    const base = provided?.trim() ? slugify(provided) : slugify(title);
+    if (base.length <= MAX_SLUG_LENGTH)
+        return base;
+    // 자른 자리에 하이픈이 남지 않게 한다.
+    return base.slice(0, MAX_SLUG_LENGTH).replace(/-+$/, '');
+}
+/**
+ * 프로필 홈페이지 링크 검사.
+ *
+ * 벨로그 웹은 값에 http(s) 스킴이 없으면 렌더링 시점에 `https://` 를 붙인다
+ * (apps/web/src/lib/includeProtocol.ts). 그래서 `example.com` 도, `example.com:8080`
+ * 도 정상 입력이다. 우리가 http(s) 만 받으면 정상 사용을 막는다.
+ *
+ * ★ 반대로 막아야 하는 건 `javascript:`·`data:` 같은 위험 스킴인데, 정규식으로
+ *   '스킴처럼 생겼나' 를 보면 두 방향으로 다 틀린다:
+ *     - `example.com:8080` 을 스킴으로 오인해 거부
+ *     - `" javascript:…"` 처럼 앞에 공백을 붙이면 통과 (실측 확인)
+ *   그래서 정규식 대신 **웹과 같은 방식으로 실제 URL 을 만들어 본다.**
+ *   앞뒤 공백은 먼저 제거한다 — 공백 하나로 검사가 뚫리면 안 된다.
+ */
+export function isSafeProfileLink(value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return true; // 빈 값 = 삭제
+    // 있는 그대로 http(s) 이거나, https:// 를 붙였을 때 http(s) 가 되면 통과.
+    // javascript:·data: 는 두 경우 모두 http(s) 가 되지 않는다.
+    return isSafeHttpUrl(trimmed) || isSafeHttpUrl(`https://${trimmed}`);
+}
+//# sourceMappingURL=slug.js.map

package/dist/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../src/slug.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IAC1C,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,OAAO,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACxE,OAAO,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAE5C,kCAAkC;AAClC,MAAM,UAAU,OAAO,CAAC,KAAa;IACpC,MAAM,IAAI,GAAG,KAAK;SAChB,IAAI,EAAE;SACN,WAAW,EAAE;QACd,8BAA8B;SAC7B,OAAO,CAAC,+BAA+B,EAAE,GAAG,CAAC;QAC9C,kCAAkC;SACjC,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC;SAC3C,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE1B,6CAA6C;IAC7C,OAAO,IAAI,IAAI,UAAU,CAAC;AAC3B,CAAC;AAED,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,QAAiB;IACzD,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe;QAAE,OAAO,IAAI,CAAC;IAChD,wBAAwB;IACxB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,CAAC,WAAW;IAC5C,wDAAwD;IACxD,gDAAgD;IAChD,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/tools/discover.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 탐색 도구 — 검색·트렌딩·최신. 전부 읽기 전용이고 인증이 필요 없다.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VelogClient } from '../client.ts';
+export declare function registerDiscoverTools(server: McpServer, client: VelogClient): void;

package/dist/tools/discover.js

@@ -0,0 +1,106 @@
+/**
+ * 탐색 도구 — 검색·트렌딩·최신. 전부 읽기 전용이고 인증이 필요 없다.
+ */
+import { z } from 'zod';
+import { QUERY_RECENT_POSTS, QUERY_SEARCH_POSTS, QUERY_TRENDING_POSTS, } from "../graphql.js";
+import { formatPostList, textResult } from "../format.js";
+import { READ_ONLY } from "./posts.js";
+/** 벨로그 트렌딩이 받는 기간 값. */
+const TIMEFRAMES = ['day', 'week', 'month', 'year'];
+/**
+ * ★ timeframe='year' 에는 별도 상한이 있다. 넘기면 **에러가 아니라 빈 배열**이 온다.
+ *
+ *   // velog-io/velog · apps/server/src/services/PostService/index.ts
+ *   if (timeframe === 'year' && (offset > 1000 || limit > 20)) {
+ *     console.log('Detected GraphQL Abuse', ip)
+ *     return []
+ *   }
+ *
+ * 최악의 실패 모드다 — 오류가 없으니 "올해 인기글이 없나보다"로 오독되고,
+ * 서버는 우리를 abuse 로 기록한다. 2026-07-30 실측으로 재현 확인
+ * (year+limit:50 → [], year+limit:20 → 정상).
+ * 그래서 넘기기 전에 우리가 깎고, 깎았다는 사실을 사용자에게 말한다.
+ */
+const YEAR_MAX_LIMIT = 20;
+const YEAR_MAX_OFFSET = 1000;
+export function registerDiscoverTools(server, client) {
+    server.registerTool('velog_search_posts', {
+        title: '벨로그 글 검색',
+        description: '키워드로 벨로그 전체를 검색한다. username 을 주면 그 사람 글 안에서만 찾는다 — ' +
+            '"내가 예전에 쓴 그 글" 을 찾을 때 이 조합을 쓴다.',
+        inputSchema: {
+            keyword: z.string().min(1).describe('검색어'),
+            username: z.string().optional().describe('이 사용자의 글로 한정'),
+            limit: z.number().int().min(1).max(50).default(20),
+            offset: z.number().int().min(0).default(0).describe('페이지네이션'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ keyword, username, limit, offset }) => {
+        const input = { keyword, limit, offset };
+        if (username)
+            input['username'] = username;
+        const data = await client.request(QUERY_SEARCH_POSTS, { input });
+        const result = data.searchPosts;
+        const posts = result.posts ?? [];
+        const body = formatPostList(posts, {
+            total: result.count,
+            showAuthor: !username,
+        });
+        // count 는 '필터 이전' 총계다. 벨로그는 조회 후 일부 글을 걸러내므로
+        // 반환 건수가 limit 보다 적을 수 있다 (2026-07-30 실측: "프로메테우스"
+        // limit=5 → 4건, "리액트" limit=5 → 5건). 그래도 offset 산술 자체는
+        // 정상이라(중복·누락 0 확인) 다음 페이지는 limit 만큼 더한다.
+        // 반환 건수로 판정하면 필터링된 페이지에서 조기 종료된다.
+        const more = offset + limit < result.count ? `\n\n다음 페이지: offset=${offset + limit}` : '';
+        return textResult(body + more);
+    });
+    server.registerTool('velog_trending_posts', {
+        title: '벨로그 트렌딩',
+        description: '벨로그 인기 글. 기간을 골라 본다.',
+        inputSchema: {
+            timeframe: z.enum(TIMEFRAMES).default('week'),
+            limit: z.number().int().min(1).max(50).default(20),
+            offset: z.number().int().min(0).default(0),
+        },
+        annotations: READ_ONLY,
+    }, async ({ timeframe, limit, offset }) => {
+        const notes = [];
+        let safeLimit = limit;
+        let safeOffset = offset;
+        if (timeframe === 'year') {
+            if (limit > YEAR_MAX_LIMIT) {
+                safeLimit = YEAR_MAX_LIMIT;
+                notes.push(`limit 을 ${limit}→${YEAR_MAX_LIMIT} 로 낮췄습니다 ` +
+                    `(벨로그는 year 기간에 limit>${YEAR_MAX_LIMIT} 이면 빈 결과를 줍니다).`);
+            }
+            if (offset > YEAR_MAX_OFFSET) {
+                safeOffset = YEAR_MAX_OFFSET;
+                notes.push(`offset 을 ${offset}→${YEAR_MAX_OFFSET} 로 낮췄습니다.`);
+            }
+        }
+        const data = await client.request(QUERY_TRENDING_POSTS, { input: { timeframe, limit: safeLimit, offset: safeOffset } });
+        const head = notes.length > 0 ? `⚠️ ${notes.join(' ')}\n\n` : '';
+        return textResult(head +
+            `[트렌딩 · ${timeframe}]\n\n` +
+            formatPostList(data.trendingPosts ?? [], { showAuthor: true }));
+    });
+    server.registerTool('velog_recent_posts', {
+        title: '벨로그 최신 글',
+        description: '벨로그 전체 최신 글. 지금 무슨 글이 올라오는지 훑을 때.',
+        inputSchema: {
+            limit: z.number().int().min(1).max(50).default(20),
+            cursor: z.string().optional().describe('이전 페이지 마지막 글의 id'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ limit, cursor }) => {
+        const input = { limit };
+        if (cursor)
+            input['cursor'] = cursor;
+        const data = await client.request(QUERY_RECENT_POSTS, { input });
+        const posts = data.recentPosts ?? [];
+        const last = posts.at(-1);
+        const more = posts.length === limit && last ? `\n\n다음 페이지: cursor="${last.id}"` : '';
+        return textResult(formatPostList(posts, { showAuthor: true }) + more);
+    });
+}
+//# sourceMappingURL=discover.js.map

package/dist/tools/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/tools/discover.ts"],"names":[],"mappings":"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"}

package/dist/tools/drafts.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 초안 도구 — 이 파일이 이 레포의 '유일한' 쓰기 경로다.
+ *
+ * ★★ is_temp 는 상수다. 도구 입력 스키마에 없으므로 호출자가 덮어쓸 수 없고,
+ *    따라서 **이 도구들은** 어떤 설정에서도 글을 발행하지 않는다.
+ *    발행은 별도 파일(tools/publish.ts)이 담당한다 — 이름이 다르면 초안을
+ *    쓰려다 실수로 발행되는 사고가 안 난다.
+ *
+ * 이 파일을 고칠 때는 ADR 0004 를 먼저 읽을 것.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VelogClient } from '../client.ts';
+import { formatPostList } from '../format.ts';
+export declare function registerDraftTools(server: McpServer, client: VelogClient): void;
+/** 테스트에서 상수를 직접 검사하기 위해 노출한다. */
+export declare const __testing: {
+    DRAFT_ONLY: {
+        readonly is_temp: true;
+        readonly is_markdown: true;
+        readonly is_private: true;
+    };
+    formatPostList: typeof formatPostList;
+};

package/dist/tools/drafts.js

@@ -0,0 +1,227 @@
+/**
+ * 초안 도구 — 이 파일이 이 레포의 '유일한' 쓰기 경로다.
+ *
+ * ★★ is_temp 는 상수다. 도구 입력 스키마에 없으므로 호출자가 덮어쓸 수 없고,
+ *    따라서 **이 도구들은** 어떤 설정에서도 글을 발행하지 않는다.
+ *    발행은 별도 파일(tools/publish.ts)이 담당한다 — 이름이 다르면 초안을
+ *    쓰려다 실수로 발행되는 사고가 안 난다.
+ *
+ * 이 파일을 고칠 때는 ADR 0004 를 먼저 읽을 것.
+ */
+import { z } from 'zod';
+import { QUERY_POSTS } from "../graphql.js";
+import { formatPostList, textResult } from "../format.js";
+import { toUrlSlug, isSafeImageUrl } from "../slug.js";
+import { resolveMyUsername } from "../me.js";
+import { assertOwned, assertOwnsSeries } from "../ownership.js";
+import { READ_ONLY } from "./posts.js";
+/**
+ * ★ 발행 차단 지점. 이 값은 파라미터가 아니라 상수다.
+ *   true = 임시저장(남에게 보이지 않음), false = 발행(되돌릴 수 없음).
+ */
+const DRAFT_ONLY = { is_temp: true, is_markdown: true, is_private: true };
+const MUTATION_WRITE_POST = `
+  mutation WriteDraft($input: WritePostInput!) {
+    writePost(input: $input) { id title url_slug is_temp user { username } }
+  }
+`;
+const MUTATION_EDIT_POST = `
+  mutation EditDraft($input: EditPostInput!) {
+    editPost(input: $input) { id title url_slug is_temp user { username } }
+  }
+`;
+/** 수정 전 상태 확인용. 필요한 필드만 받는다. */
+const QUERY_POST_STATE = `
+  query PostState($input: ReadPostInput!) {
+    post(input: $input) { id title is_temp meta user { username } }
+  }
+`;
+/** 벨로그가 정말 임시저장으로 받았는지 응답으로 확인한다. */
+function assertStayedDraft(post) {
+    if (post.is_temp !== true) {
+        throw new Error(`예상치 못한 상태: 벨로그가 이 글을 임시저장이 아닌 것으로 저장했습니다 ` +
+            `(is_temp=${post.is_temp}, id=${post.id}). 즉시 벨로그에서 확인하세요.`);
+    }
+}
+function draftResult(post, verb) {
+    const username = post.user?.username;
+    const where = username
+        ? `https://velog.io/write?id=${post.id}`
+        : `(id: ${post.id})`;
+    return [
+        `✅ 초안을 ${verb}했습니다. **아직 발행되지 않았습니다.**`,
+        '',
+        `- 제목: ${post.title}`,
+        `- id: \`${post.id}\``,
+        `- 상태: 임시저장 (is_temp=true) — 나만 볼 수 있음`,
+        `- 편집: ${where}`,
+        '',
+        '발행하려면 velog_publish_draft 를 쓰거나, 벨로그에서 직접 "출간하기"를 누르세요.',
+    ].join('\n');
+}
+export function registerDraftTools(server, client) {
+    server.registerTool('velog_create_draft', {
+        title: '벨로그 초안 작성',
+        description: '벨로그에 임시저장 글(초안)을 만든다. 발행되지 않으며 작성자 본인만 볼 수 있다. ' +
+            '이 도구는 어떤 설정에서도 발행하지 않는다 — 발행하려면 velog_publish_draft 를 따로 부를 것. ' +
+            'body 는 마크다운으로 쓴다.',
+        inputSchema: {
+            title: z.string().min(1).describe('글 제목'),
+            body: z.string().min(1).describe('본문 (마크다운)'),
+            tags: z.array(z.string()).default([]).describe('태그 목록'),
+            url_slug: z.string().optional().describe('생략하면 제목에서 생성'),
+            thumbnail: z
+                .string()
+                .refine(isSafeImageUrl, 'http(s) 이미지 URL 만 허용합니다')
+                .optional()
+                .describe('썸네일 이미지 URL (http/https 만)'),
+            series_id: z
+                .string()
+                .optional()
+                .describe('소속시킬 시리즈 id. ★ 벨로그는 임시저장 단계에서 이걸 무시한다 — ' +
+                '초안 생성 후 velog_update_draft 로 다시 지정해야 실제로 붙는다'),
+        },
+        // 되돌릴 수 있는 쓰기다 — 비공개 초안이므로 파괴적이지 않다.
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false },
+    }, async ({ title, body, tags, url_slug, thumbnail, series_id }) => {
+        client.requireAuth('velog_create_draft');
+        if (series_id)
+            await assertOwnsSeries(client, series_id, 'velog_create_draft');
+        // ★ 초안은 is_private:true 라 벨로그 계수(is_private:false 만 셈)에
+        //   잡히지 않는다. 그래서 상한을 걸지 않는다 — 상한은 '공개 발행' 쪽에 있다.
+        const input = {
+            title,
+            body,
+            tags,
+            url_slug: toUrlSlug(title, url_slug),
+            meta: {},
+            ...DRAFT_ONLY, // ★ 마지막에 펼쳐서 위 값들이 덮어쓸 수 없게 한다
+        };
+        if (thumbnail)
+            input['thumbnail'] = thumbnail;
+        if (series_id)
+            input['series_id'] = series_id;
+        // mutate 는 재시도하지 않는다 — 응답 유실 시 초안이 중복 생성된다.
+        const data = await client.mutate(MUTATION_WRITE_POST, { input });
+        assertStayedDraft(data.writePost);
+        // ★ 벨로그는 임시저장 생성 시 series_id 를 조용히 버린다:
+        //   // apps/server/src/services/PostApiService/index.mts
+        //   if (series_id && !data.is_temp) await appendToSeries(...)
+        // edit 경로에는 이 조건이 없어 update_draft 로는 붙는다. 이 비대칭을
+        // 사용자가 알 방법이 없으므로 직접 알린다.
+        const seriesNote = series_id
+            ? '\n\n⚠️ 시리즈는 **적용되지 않았습니다.** 벨로그가 임시저장 생성 단계에서는' +
+                ' series_id 를 무시합니다. 방금 만든 초안 id 로 velog_update_draft 를' +
+                ' 한 번 호출하면 그때 실제로 붙습니다.'
+            : '';
+        return textResult(draftResult(data.writePost, '저장') + seriesNote);
+    });
+    server.registerTool('velog_update_draft', {
+        title: '벨로그 초안 수정',
+        description: '기존 초안을 **통째로 교체**한다. 부분 수정이 아니다. ' +
+            '생략한 필드는 유지되지 않고 초기화된다 — tags 를 안 주면 기존 태그가 전부 지워지고, ' +
+            'url_slug 를 안 주면 제목에서 새로 만들어 주소가 바뀌며, series_id 를 안 주면 ' +
+            '기존 시리즈 연결이 끊긴다. 그래서 수정 전에 velog_get_post 로 현재 값을 읽어 ' +
+            '바꾸지 않을 필드도 그대로 다시 넘기는 것을 권한다. ' +
+            '발행된 글의 id 는 거부한다(비공개로 내려가는 사고 방지).',
+        inputSchema: {
+            id: z.string().min(1).describe('초안의 id (velog_list_drafts 로 확인)'),
+            title: z.string().min(1),
+            body: z.string().min(1).describe('본문 전체 (마크다운). 부분 수정이 아니라 교체다'),
+            tags: z.array(z.string()).default([]),
+            url_slug: z.string().optional(),
+            thumbnail: z
+                .string()
+                .refine(isSafeImageUrl, 'http(s) 이미지 URL 만 허용합니다')
+                .optional(),
+            series_id: z.string().optional(),
+        },
+        // ★ destructive 가 맞다. 생략 필드가 보존되지 않고 초기화된다 —
+        //   MCP 명세상 destructiveHint:false 는 '추가만 한다'는 뜻이라 거짓이 된다.
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, async ({ id, title, body, tags, url_slug, thumbnail, series_id }) => {
+        client.requireAuth('velog_update_draft');
+        // ★ 두 가지를 확인한 뒤에야 수정한다.
+        //   ① 내 글인가 — 벨로그 서버가 edit 에서 소유권을 안 본다(ownership.ts)
+        //   ② 정말 초안인가 — editPost 는 is_temp 를 덮어쓰므로 발행글 id 가
+        //      들어오면 그 글이 조용히 비공개로 내려간다
+        const before = await client.request(QUERY_POST_STATE, { input: { id } });
+        if (!before.post) {
+            throw new Error(`id=${id} 인 글을 찾지 못했습니다. velog_list_drafts 로 id 를 확인하세요.`);
+        }
+        await assertOwned(client, before.post, 'velog_update_draft');
+        if (series_id)
+            await assertOwnsSeries(client, series_id, 'velog_update_draft');
+        if (before.post.is_temp !== true) {
+            throw new Error(`id=${id} 는 이미 발행된 글입니다. 이 도구로 수정하면 임시저장으로 내려가 ` +
+                `비공개가 되므로 중단했습니다. 발행된 글은 벨로그에서 직접 수정하세요.`);
+        }
+        const input = {
+            id,
+            title,
+            body,
+            tags,
+            url_slug: toUrlSlug(title, url_slug),
+            // ★ {} 를 보내면 short_description 등 표시 데이터가 지워진다.
+            //   서버가 받은 값을 그대로 DB 에 넣으므로 기존 값을 실어야 한다.
+            //   (publish.ts 만 고치고 여기를 또 빠뜨렸었다 — 소유권 때와 같은 실수)
+            meta: before.post.meta ?? {},
+            ...DRAFT_ONLY,
+        };
+        if (thumbnail)
+            input['thumbnail'] = thumbnail;
+        if (series_id)
+            input['series_id'] = series_id;
+        const data = await client.mutate(MUTATION_EDIT_POST, {
+            input,
+        });
+        // ★ editPost 의 응답으로는 사후 상태를 알 수 없다. 공식 구현이
+        //   `return { ...post, url_slug: data.url_slug }` 로 **갱신 전에 읽은**
+        //   post 를 돌려주고 url_slug 만 덮기 때문이다
+        //   (apps/server/src/services/PostApiService/index.mts).
+        //   그래서 응답의 is_temp 는 '수정 전' 값이다 — 그걸 검사해봐야 사전확인을
+        //   한 번 더 하는 것에 불과하다. 진짜 사후 확인은 재조회뿐이다.
+        // ★ 재조회 결과를 '보기만' 하면 검증이 아니다. null 도 실패로 처리한다.
+        const after = await client.request(QUERY_POST_STATE, { input: { id } });
+        if (!after.post) {
+            throw new Error(`velog_update_draft: 수정 후 글(id=${id})을 다시 찾지 못했습니다. ` +
+                '벨로그에서 상태를 직접 확인하세요.');
+        }
+        if (after.post.is_temp !== true) {
+            throw new Error(`⚠️ 수정 후 확인 결과 이 글이 임시저장이 아닙니다 ` +
+                `(id=${id}, is_temp=${after.post.is_temp}). ` +
+                '수정 직전에 다른 곳에서 발행됐을 수 있습니다. 벨로그에서 상태를 확인하세요.');
+        }
+        // ★ data.editPost 는 '갱신 전' 객체다(공식 서버가 그렇게 반환한다).
+        //   그걸로 문구를 만들면 제목을 바꿔도 옛 제목이 표시된다.
+        //   이미 재조회했으므로 그 결과를 얹는다.
+        return textResult(draftResult({ ...data.editPost, title: after.post.title ?? data.editPost.title ?? null }, '수정'));
+    });
+    server.registerTool('velog_list_drafts', {
+        title: '내 초안 목록',
+        description: '내 임시저장 글 목록. 초안을 이어 쓰거나 수정하기 전에 id 를 여기서 확인한다.',
+        inputSchema: {
+            username: z
+                .string()
+                .optional()
+                .describe('생략하면 토큰의 계정을 쓴다. 남의 초안은 어차피 안 보인다'),
+            limit: z.number().int().min(1).max(50).default(20),
+        },
+        annotations: READ_ONLY,
+    }, async ({ username, limit }) => {
+        client.requireAuth('velog_list_drafts');
+        // 토큰이 있으면 서버가 이미 누군지 안다. 사용자가 매번 칠 이유가 없다.
+        const target = username ?? (await resolveMyUsername(client));
+        const data = await client.request(QUERY_POSTS, { input: { username: target, limit, temp_only: true } });
+        const posts = data.posts ?? [];
+        if (posts.length === 0)
+            return textResult('임시저장된 초안이 없습니다.');
+        const withIds = posts
+            .map((p, i) => `${i + 1}. ${p.title}\n    id: \`${p.id}\``)
+            .join('\n\n');
+        return textResult(`초안 ${posts.length}건\n\n${withIds}`);
+    });
+}
+/** 테스트에서 상수를 직접 검사하기 위해 노출한다. */
+export const __testing = { DRAFT_ONLY, formatPostList };
+//# sourceMappingURL=drafts.js.map

package/dist/tools/drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.js","sourceRoot":"","sources":["../../src/tools/drafts.ts"],"names":[],"mappings":"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"}

package/dist/tools/export.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 글 백업 — 벨로그 글을 프론트매터 붙인 마크다운으로 내려받는다.
+ *
+ * ★ 이 레포에서 파일을 쓰는 유일한 모듈이다. 쓰는 내용은 '글 본문'뿐이고
+ *   토큰은 절대 닿지 않는다. safety.test.ts 가 이 파일만 예외로 둔다.
+ *
+ * 벨로그에 공식 내보내기가 없어서 만든다. 서비스가 사라져도 글은 남아야 한다.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VelogClient } from '../client.ts';
+import type { VelogPostDetail } from '../types.ts';
+export declare function toMarkdown(post: VelogPostDetail, username: string): string;
+/**
+ * 파일명 안전화.
+ *
+ * 슬러그에 경로 구분자가 들어오면 지정한 디렉터리 밖에 쓸 수 있다.
+ * slugify 가 이미 `/` 를 제거하지만, 여기서 한 번 더 막는다 —
+ * 파일을 쓰는 코드는 이중으로 방어한다.
+ */
+export declare function safeFileName(slug: string, index: number): string;
+export declare function registerExportTools(server: McpServer, client: VelogClient): void;