@milcho0604/velog-mcp 0.4.0

package/dist/tools/posts.js

@@ -0,0 +1,82 @@
+/**
+ * 글 조회 도구 — 전부 읽기 전용.
+ *
+ * 인증이 없어도 공개 글은 조회된다 (ADR 0003).
+ */
+import { z } from 'zod';
+import { QUERY_POST, QUERY_POSTS } from "../graphql.js";
+import { formatPostDetail, formatPostList, textResult } from "../format.js";
+/** 읽기 도구 공통 표식 — 클라이언트가 위험도를 판단할 수 있게 한다. */
+export const READ_ONLY = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    openWorldHint: true,
+};
+export function registerPostTools(server, client) {
+    server.registerTool('velog_get_post', {
+        title: '벨로그 글 읽기',
+        description: '벨로그 글 하나를 본문까지 읽어온다. username + url_slug 조합이나 글 id 로 지정한다. ' +
+            '예: https://velog.io/@velopert/react-context-tutorial → username="velopert", url_slug="react-context-tutorial"',
+        inputSchema: {
+            username: z.string().optional().describe('@ 없이. 예: "velopert"'),
+            url_slug: z.string().optional().describe('URL 마지막 조각'),
+            id: z.string().optional().describe('글 UUID. 이걸 주면 username/url_slug 는 불필요'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ username, url_slug, id }) => {
+        // 분기 안에서 값을 쓰면 타입이 그대로 좁혀져 단언이 필요 없다.
+        const input = {};
+        if (id) {
+            input['id'] = id;
+        }
+        else if (username && url_slug) {
+            input['username'] = username;
+            input['url_slug'] = url_slug;
+        }
+        else {
+            throw new Error('id 를 주거나, username 과 url_slug 를 함께 주세요.');
+        }
+        const data = await client.request(QUERY_POST, {
+            input,
+        });
+        if (!data.post)
+            return textResult('해당 글을 찾지 못했습니다.');
+        return textResult(formatPostDetail(data.post));
+    });
+    server.registerTool('velog_list_posts', {
+        title: '벨로그 글 목록',
+        description: '특정 사용자의 글 목록을 최신순으로 가져온다. tag 로 좁힐 수 있다. ' +
+            'cursor 에 직전 응답의 마지막 글 id 를 주면 다음 페이지를 읽는다.',
+        inputSchema: {
+            username: z.string().describe('@ 없이'),
+            tag: z.string().optional().describe('이 태그가 달린 글만'),
+            limit: z.number().int().min(1).max(50).default(20),
+            cursor: z.string().optional().describe('이전 페이지 마지막 글의 id'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ username, tag, limit, cursor }) => {
+        const input = { username, limit };
+        if (tag)
+            input['tag'] = tag;
+        if (cursor)
+            input['cursor'] = cursor;
+        const data = await client.request(QUERY_POSTS, {
+            input,
+        });
+        const posts = data.posts ?? [];
+        const body = formatPostList(posts);
+        const last = posts.at(-1);
+        // ★ tag 를 주면 벨로그가 요청 limit 을 무시하고 고정 20건을 준다
+        //   (2026-07-30 실측: tag='React', limit=5 → 20건).
+        //   그래서 `posts.length === limit` 으로 다음 페이지를 판정하면
+        //   태그 조회에서 항상 '더 없음'으로 오판한다. 반환이 비지 않았으면
+        //   커서를 안내하는 쪽이 안전하다 — 헛걸음 한 번이 누락보다 낫다.
+        const hasMore = tag ? posts.length > 0 : posts.length >= limit;
+        const more = hasMore && last ? `\n\n다음 페이지: cursor="${last.id}"` : '';
+        const tagNote = tag
+            ? '\n(벨로그는 태그 조회에서 limit 을 무시하고 20건 단위로 줍니다)'
+            : '';
+        return textResult(body + more + tagNote);
+    });
+}
+//# sourceMappingURL=posts.js.map

package/dist/tools/posts.js.map

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

package/dist/tools/profile-edit.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 프로필 수정 도구.
+ *
+ * `VELOG_ALLOW_PROFILE=1` 이 있어야 실제로 동작한다. 근거는 capabilities.ts 주석 —
+ * 위험해서가 아니라 `short_bio`(프로필)와 `short_description`(글) 혼동 때문이다.
+ *
+ * ★ 병합이 핵심이다. `UpdateProfileInput` 은 `display_name` 과 `short_bio` 를
+ *   **둘 다 필수**로 받는다. 하나만 바꾸겠다고 한쪽만 보내면 다른 쪽이 빈 문자열로
+ *   덮인다. 그래서 항상 현재 값을 읽어 채운 뒤 보낸다.
+ *   (초안 도구의 '생략=초기화'가 사고를 부른다는 걸 이미 확인했다.)
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VelogClient } from '../client.ts';
+import type { Capabilities } from '../capabilities.ts';
+export declare function registerProfileEditTools(server: McpServer, client: VelogClient, capabilities: Capabilities): void;

package/dist/tools/profile-edit.js

@@ -0,0 +1,216 @@
+/**
+ * 프로필 수정 도구.
+ *
+ * `VELOG_ALLOW_PROFILE=1` 이 있어야 실제로 동작한다. 근거는 capabilities.ts 주석 —
+ * 위험해서가 아니라 `short_bio`(프로필)와 `short_description`(글) 혼동 때문이다.
+ *
+ * ★ 병합이 핵심이다. `UpdateProfileInput` 은 `display_name` 과 `short_bio` 를
+ *   **둘 다 필수**로 받는다. 하나만 바꾸겠다고 한쪽만 보내면 다른 쪽이 빈 문자열로
+ *   덮인다. 그래서 항상 현재 값을 읽어 채운 뒤 보낸다.
+ *   (초안 도구의 '생략=초기화'가 사고를 부른다는 걸 이미 확인했다.)
+ */
+import { z } from 'zod';
+import { textResult } from "../format.js";
+import { isSafeImageUrl, isSafeProfileLink } from "../slug.js";
+import { fetchCurrentUser, invalidateMe } from "../me.js";
+const MUTATION_UPDATE_PROFILE = `
+  mutation UpdateProfile($input: UpdateProfileInput!) {
+    updateProfile(input: $input) { id display_name short_bio }
+  }
+`;
+const MUTATION_UPDATE_ABOUT = `
+  mutation UpdateAbout($input: UpdateAboutInput!) {
+    updateAbout(input: $input) { id about }
+  }
+`;
+const MUTATION_UPDATE_VELOG_TITLE = `
+  mutation UpdateVelogTitle($input: UpdateVelogTitleInput!) {
+    updateVelogTitle(input: $input) { title logo_image }
+  }
+`;
+const MUTATION_UPDATE_SOCIAL = `
+  mutation UpdateSocialInfo($input: UpdateSocialInfoInput!) {
+    updateSocialInfo(input: $input) { id profile_links }
+  }
+`;
+const MUTATION_UPDATE_THUMBNAIL = `
+  mutation UpdateThumbnail($input: UpdateThumbnailInput!) {
+    updateThumbnail(input: $input) { id thumbnail }
+  }
+`;
+/** 현재 프로필 전체. 병합에 필요해 한 번에 읽는다. */
+const QUERY_MY_PROFILE = `
+  query MyProfile($input: GetUserInput!) {
+    user(input: $input) {
+      id
+      username
+      profile { display_name short_bio about thumbnail profile_links }
+      velog_config { title }
+    }
+  }
+`;
+/** 벨로그가 받는 SNS 링크 키. 임의 키를 넣으면 프로필 화면에서 안 보인다. */
+const SOCIAL_KEYS = ['github', 'twitter', 'facebook', 'url', 'email'];
+export function registerProfileEditTools(server, client, capabilities) {
+    // 꺼져 있으면 도구를 아예 등록하지 않는다. 목록에 없으면 부를 수도 없다.
+    if (!capabilities.editProfile)
+        return;
+    /** 현재 프로필을 읽는다. 병합의 기준값이다. */
+    async function current(toolName) {
+        client.requireAuth(toolName);
+        const me = await fetchCurrentUser(client);
+        if (!me.username) {
+            throw new Error(`${toolName}: 현재 계정의 username 을 확인하지 못했습니다.`);
+        }
+        const data = await client.request(QUERY_MY_PROFILE, {
+            input: { username: me.username },
+        });
+        if (!data.user) {
+            throw new Error(`${toolName}: 프로필을 불러오지 못했습니다.`);
+        }
+        return data.user;
+    }
+    server.registerTool('velog_update_profile', {
+        title: '프로필 수정 (이름·한줄소개)',
+        description: '벨로그 프로필의 표시 이름과 한줄 소개를 바꾼다. ' +
+            '★ 이건 **블로그 주인의 프로필**이다 — 글의 요약문(short_description)이 아니다. ' +
+            '생략한 항목은 현재 값을 그대로 유지한다.',
+        inputSchema: {
+            // 서버가 공백뿐인 이름을 거부하므로 여기서 먼저 막는다.
+            display_name: z
+                .string()
+                .max(255)
+                .refine((v) => v.trim().length > 0, '표시 이름은 공백만으로 둘 수 없습니다')
+                .optional()
+                .describe('표시 이름. 생략하면 유지'),
+            // ★ 서버가 short_bio 를 255자로 **조용히 자른다**(userResolvers 의 slice).
+            //   여기서 안 막으면 "저장했습니다" 라고 해놓고 뒷부분이 사라진다.
+            short_bio: z
+                .string()
+                .max(255, '한줄 소개는 255자까지입니다 (서버가 그 이상을 조용히 자릅니다)')
+                .optional()
+                .describe('한줄 소개 (255자 이내). 생략하면 유지'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, async ({ display_name, short_bio }) => {
+        const user = await current('velog_update_profile');
+        const p = user.profile;
+        // ★ 둘 다 필수 필드라 한쪽만 보내면 다른 쪽이 지워진다. 반드시 채워 보낸다.
+        const input = {
+            display_name: display_name ?? p?.display_name ?? '',
+            short_bio: short_bio ?? p?.short_bio ?? '',
+        };
+        await client.mutate(MUTATION_UPDATE_PROFILE, { input });
+        invalidateMe(client);
+        const after = await current('velog_update_profile');
+        return textResult([
+            '✅ 프로필을 수정했습니다.',
+            '',
+            `- 이름: ${after.profile?.display_name ?? '—'}`,
+            `- 한줄 소개: ${after.profile?.short_bio ?? '—'}`,
+            `- 확인: https://velog.io/@${after.username ?? ''}`,
+        ].join('\n'));
+    });
+    server.registerTool('velog_update_about', {
+        title: '소개글 수정',
+        description: '벨로그 "소개" 탭의 긴 글을 통째로 바꾼다(마크다운). ' +
+            '★ 전체 교체다 — 기존 내용에 덧붙이려면 먼저 velog_get_user 로 읽어 합친 뒤 넘길 것.',
+        inputSchema: {
+            about: z.string().describe('소개글 전문 (마크다운). 빈 문자열이면 소개글이 비워진다'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, async ({ about }) => {
+        client.requireAuth('velog_update_about');
+        await client.mutate(MUTATION_UPDATE_ABOUT, { input: { about } });
+        invalidateMe(client);
+        const after = await current('velog_update_about');
+        const saved = after.profile?.about ?? '';
+        return textResult([
+            '✅ 소개글을 수정했습니다.',
+            '',
+            `- 길이: ${saved.length}자`,
+            `- 확인: https://velog.io/@${after.username ?? ''}/about`,
+            '',
+            '--- 저장된 내용 앞부분 ---',
+            saved.slice(0, 300) + (saved.length > 300 ? '…' : ''),
+        ].join('\n'));
+    });
+    server.registerTool('velog_update_blog_title', {
+        title: '블로그 제목 수정',
+        description: '벨로그 상단에 뜨는 블로그 제목을 바꾼다 (예: "velopert.log").',
+        inputSchema: { title: z.string().min(1).describe('새 블로그 제목') },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, async ({ title }) => {
+        client.requireAuth('velog_update_blog_title');
+        await client.mutate(MUTATION_UPDATE_VELOG_TITLE, { input: { title } });
+        const after = await current('velog_update_blog_title');
+        return textResult(`✅ 블로그 제목을 "${after.velog_config?.title ?? title}" 로 바꿨습니다.\n` +
+            `- 확인: https://velog.io/@${after.username ?? ''}`);
+    });
+    server.registerTool('velog_update_social_links', {
+        title: 'SNS 링크 수정',
+        description: `프로필의 SNS 링크를 바꾼다. 지원 키: ${SOCIAL_KEYS.join(', ')}. ` +
+            '생략한 키는 현재 값을 유지하고, 빈 문자열을 주면 그 항목이 지워진다.',
+        inputSchema: {
+            // 빈 문자열은 '삭제' 의미라 허용한다. 그 외에는 형식을 본다 —
+            // 잘못된 링크를 프로필에 박아두면 방문자가 깨진 링크를 밟는다.
+            github: z.string().max(100).optional().describe('사용자명 또는 URL'),
+            twitter: z.string().max(100).optional(),
+            facebook: z.string().max(100).optional(),
+            // 벨로그 웹과 같은 규칙으로 본다 — slug.ts 의 isSafeProfileLink 주석 참고.
+            url: z
+                .string()
+                .max(255)
+                .refine(isSafeProfileLink, 'javascript:·data: 같은 스킴은 넣을 수 없습니다')
+                .optional()
+                .describe('홈페이지. scheme 없이 example.com 도 됩니다 (빈 문자열이면 삭제)'),
+            email: z
+                .string()
+                .refine((v) => v === '' || /^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(v), '이메일 형식이 아닙니다')
+                .optional()
+                .describe('공개 이메일 (빈 문자열이면 삭제)'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, async (args) => {
+        const user = await current('velog_update_social_links');
+        const existing = user.profile?.profile_links ?? {};
+        // ★ profile_links 는 JSON 통째로 교체된다. 기존 값 위에 덮어써야
+        //   지정하지 않은 링크가 사라지지 않는다.
+        const merged = { ...existing };
+        for (const key of SOCIAL_KEYS) {
+            const value = args[key];
+            if (typeof value === 'string')
+                merged[key] = value;
+        }
+        await client.mutate(MUTATION_UPDATE_SOCIAL, {
+            input: { profile_links: merged },
+        });
+        invalidateMe(client);
+        const after = await current('velog_update_social_links');
+        const links = after.profile?.profile_links ?? {};
+        const shown = Object.entries(links)
+            .filter(([, v]) => typeof v === 'string' && v.length > 0)
+            .map(([k, v]) => `  - ${k}: ${String(v)}`)
+            .join('\n');
+        return textResult(`✅ SNS 링크를 수정했습니다.\n\n${shown || '  (등록된 링크 없음)'}`);
+    });
+    server.registerTool('velog_update_profile_image', {
+        title: '프로필 사진 변경',
+        description: '프로필 이미지를 지정한 URL 로 바꾼다. http(s) 이미지 주소만 받는다. ' +
+            '이미지 업로드 기능은 없으므로 이미 어딘가에 올라간 주소가 필요하다.',
+        inputSchema: {
+            url: z
+                .string()
+                .refine(isSafeImageUrl, 'http(s) 이미지 URL 만 허용합니다')
+                .describe('이미지 URL'),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true },
+    }, async ({ url }) => {
+        client.requireAuth('velog_update_profile_image');
+        await client.mutate(MUTATION_UPDATE_THUMBNAIL, { input: { url } });
+        invalidateMe(client);
+        const after = await current('velog_update_profile_image');
+        return textResult(`✅ 프로필 사진을 바꿨습니다.\n- 현재: ${after.profile?.thumbnail ?? '—'}`);
+    });
+}
+//# sourceMappingURL=profile-edit.js.map

package/dist/tools/profile-edit.js.map

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

package/dist/tools/profile.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 사용자·시리즈·태그 조회. 전부 읽기 전용이고 인증이 필요 없다.
+ *
+ * 시리즈와 태그는 "이 사람이 무엇을 꾸준히 쓰는가"를 한눈에 보여준다.
+ * 글 목록을 다 훑는 것보다 훨씬 싸다.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VelogClient } from '../client.ts';
+export declare function registerProfileTools(server: McpServer, client: VelogClient): void;

package/dist/tools/profile.js

@@ -0,0 +1,133 @@
+/**
+ * 사용자·시리즈·태그 조회. 전부 읽기 전용이고 인증이 필요 없다.
+ *
+ * 시리즈와 태그는 "이 사람이 무엇을 꾸준히 쓰는가"를 한눈에 보여준다.
+ * 글 목록을 다 훑는 것보다 훨씬 싸다.
+ */
+import { z } from 'zod';
+import { textResult } from "../format.js";
+import { READ_ONLY } from "./posts.js";
+import { fetchCurrentUser } from "../me.js";
+const QUERY_USER = `
+  query GetUser($input: GetUserInput!) {
+    user(input: $input) {
+      id
+      username
+      followers_count
+      followings_count
+      profile { display_name short_bio thumbnail about profile_links }
+      velog_config { title }
+    }
+  }
+`;
+const QUERY_SERIES_LIST = `
+  query SeriesList($input: GetSeriesListInput!) {
+    seriesList(input: $input) {
+      id
+      name
+      url_slug
+      description
+      posts_count
+      updated_at
+    }
+  }
+`;
+const QUERY_USER_TAGS = `
+  query UserTags($input: UserTagsInput!) {
+    userTags(input: $input) {
+      tags { id name posts_count }
+    }
+  }
+`;
+export function registerProfileTools(server, client) {
+    server.registerTool('velog_whoami', {
+        title: '내 계정 확인',
+        description: '현재 토큰으로 인증된 계정을 확인한다. 토큰이 살아있는지 점검하는 용도로도 쓴다. ' +
+            '다른 도구에서 username 을 생략하면 여기서 얻는 계정을 쓴다.',
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => {
+        client.requireAuth('velog_whoami');
+        const me = await fetchCurrentUser(client);
+        return textResult([
+            `✅ 인증됨 — @${me.username ?? '(username 없음)'}`,
+            '',
+            `- 이름: ${me.profile?.display_name ?? '—'}`,
+            `- 소개: ${me.profile?.short_bio ?? '—'}`,
+            `- 내 블로그: https://velog.io/@${me.username ?? ''}`,
+            '',
+            '※ 공개 발행은 VELOG_ALLOW_PUBLIC=1 이 설정돼 있을 때만 가능합니다.',
+        ].join('\n'));
+    });
+    server.registerTool('velog_get_user', {
+        title: '벨로그 사용자 정보',
+        description: '벨로그 사용자의 프로필과 팔로워 수를 조회한다.',
+        inputSchema: { username: z.string().describe('@ 없이') },
+        annotations: READ_ONLY,
+    }, async ({ username }) => {
+        const data = await client.request(QUERY_USER, {
+            input: { username },
+        });
+        const user = data.user;
+        if (!user)
+            return textResult(`@${username} 을(를) 찾지 못했습니다.`);
+        const p = user.profile;
+        const lines = [
+            `# @${user.username ?? username}`,
+            '',
+            `- 이름: ${p?.display_name ?? '—'}`,
+            `- 소개: ${p?.short_bio ?? '—'}`,
+            `- 블로그 제목: ${user.velog_config?.title ?? '—'}`,
+            `- 팔로워 ${user.followers_count ?? 0} · 팔로잉 ${user.followings_count ?? 0}`,
+            `- URL: https://velog.io/@${user.username ?? username}`,
+        ];
+        if (p?.about?.trim()) {
+            lines.push('', '## 소개글', p.about.trim().slice(0, 1000));
+        }
+        return textResult(lines.join('\n'));
+    });
+    server.registerTool('velog_list_series', {
+        title: '시리즈 목록',
+        description: '사용자의 연재 시리즈 목록. 각 시리즈에 글이 몇 편인지 함께 준다. ' +
+            '초안을 특정 시리즈에 넣으려면 여기서 얻은 id 를 velog_create_draft 의 series_id 에 준다.',
+        inputSchema: { username: z.string().describe('@ 없이') },
+        annotations: READ_ONLY,
+    }, async ({ username }) => {
+        const data = await client.request(QUERY_SERIES_LIST, {
+            input: { username },
+        });
+        const list = data.seriesList ?? [];
+        if (list.length === 0)
+            return textResult(`@${username} 의 시리즈가 없습니다.`);
+        const body = list
+            .map((s, i) => `${i + 1}. ${s.name ?? '(제목 없음)'} — ${s.posts_count ?? 0}편\n` +
+            `    id: \`${s.id}\`\n` +
+            `    https://velog.io/@${username}/series/${s.url_slug ?? ''}`)
+            .join('\n\n');
+        return textResult(`시리즈 ${list.length}개\n\n${body}`);
+    });
+    server.registerTool('velog_user_tags', {
+        title: '사용자 태그 목록',
+        description: '사용자가 쓴 태그와 각 태그의 글 수. "이 사람이 뭘 주로 쓰나"를 가장 싸게 파악하는 방법이다.',
+        inputSchema: {
+            username: z.string().describe('@ 없이'),
+            top: z.number().int().min(1).max(100).default(30),
+        },
+        annotations: READ_ONLY,
+    }, async ({ username, top }) => {
+        const data = await client.request(QUERY_USER_TAGS, {
+            input: { username },
+        });
+        const tags = data.userTags?.tags ?? [];
+        if (tags.length === 0)
+            return textResult(`@${username} 의 태그가 없습니다.`);
+        const sorted = [...tags]
+            .sort((a, b) => (b.posts_count ?? 0) - (a.posts_count ?? 0))
+            .slice(0, top);
+        const body = sorted
+            .map((t) => `  #${t.name ?? '?'} — ${t.posts_count ?? 0}편`)
+            .join('\n');
+        return textResult(`@${username} 의 태그 ${tags.length}개 (상위 ${sorted.length})\n\n${body}`);
+    });
+}
+//# sourceMappingURL=profile.js.map

package/dist/tools/profile.js.map

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

package/dist/tools/publish.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 발행 도구.
+ *
+ * 기본은 **비공개 발행**이다. 공개 발행은 `VELOG_ALLOW_PUBLIC=1` 이 있어야 한다
+ * — 근거는 src/capabilities.ts 주석 참고 (비공개 글은 벨로그의 파괴적 제한에
+ * 걸리지 않지만 공개 글은 걸리고, RSS·검색·구독메일로 나가면 회수가 안 된다).
+ *
+ * 초안 작성과 발행을 **별도 도구**로 나눈 이유: 같은 도구에 `is_temp` 파라미터를
+ * 두면 초안을 쓰려다 값 하나 잘못 넣어 발행되는 경로가 생긴다. 이름이 다르면
+ * 그 사고가 안 난다.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { VelogClient } from '../client.ts';
+import type { Capabilities } from '../capabilities.ts';
+import type { PublishRateLimiter } from '../ratelimit.ts';
+export declare function registerPublishTools(server: McpServer, client: VelogClient, capabilities: Capabilities, limiter: PublishRateLimiter): void;