Velog

velog-mcp-claude

这是一个独立开源项目，已获得 Velog 开发者（@velopert）许可运营。

可让 Claude 直接在 Velog 上撰写、发布、修改和删除文章，还能处理评论、点赞、搜索和趋势内容的 MCP 服务。

这是基于 stdio 的标准 MCP 服务，可在 Claude Code、Claude Desktop、Codex CLI 等支持 MCP 的客户端中运行。

npm： velog-mcp-claude | 要求：Node.js 18+

安装

npx -p velog-mcp-claude velog-mcp-setup

登录 Velog 后，在浏览器 DevTools → Application → Cookies → https://velog.io 中复制 access_token 和 refresh_token 的值并输入。

令牌会以 0600 权限保存在 ~/.velog-mcp.json 中。

配置

Claude Code

claude mcp add velog -- npx -y velog-mcp-claude

如需全局添加：

claude mcp add --scope global velog -- npx -y velog-mcp-claude

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "velog": {
      "command": "npx",
      "args": ["-y", "velog-mcp-claude"]
    }
  }
}

Codex CLI

codex mcp add velog -- npx -y velog-mcp-claude

或直接添加到 ~/.codex/config.toml：

[mcp_servers.velog]
command = "npx"
args = ["-y", "velog-mcp-claude"]

运行 codex mcp list 确认是否已注册。

工具列表

文章

工具	说明
velog_draft_post	创建文章草稿
velog_publish_post	将草稿发布到 Velog
velog_list_posts	查看我的文章列表
velog_get_post	查看指定文章的完整内容（包括浏览量）
velog_update_post	修改现有文章
velog_delete_post	删除文章
velog_upload_image	将本地图片上传到 Velog CDN
velog_import_from_github	将 GitHub 博客 Markdown 导入为 Velog 草稿
velog_git_to_post	分析 git 提交记录和 diff，生成博客草稿提示词

系列

工具	说明
velog_list_series	查看我的系列列表
velog_create_series	创建新系列
velog_update_series	修改系列名称和说明
velog_append_to_series	将文章添加到系列
velog_delete_series	删除系列

评论

工具	说明
velog_get_comments	查看文章评论列表（包括回复）
velog_write_comment	撰写评论或回复
velog_update_comment	修改评论
velog_delete_comment	删除评论

点赞

工具	说明
velog_like_post	为文章点赞
velog_unlike_post	取消文章点赞

探索

工具	说明
velog_search_posts	按关键词搜索文章
velog_get_trending	查看趋势文章（day / week / month / year）
velog_trend_report	趋势文章分析报告
velog_topic_research	通过交叉分析趋势标签和我的文章，发掘尚未撰写的热门主题
velog_get_rss	查看指定用户的 RSS feed（无需认证）

我的账号

工具	说明
velog_list_tags	查看我的标签列表和各标签的文章数量
velog_list_temp_posts	查看临时保存的文章列表
velog_get_notifications	查看通知列表（点赞、评论、关注，含未读数量）
velog_get_reading_list	查看阅读列表（书签）

git 提交 → 博客草稿

分析最近的提交记录和 diff，让 Claude 自动撰写韩语技术博客文章。

나: "오늘 작업한 커밋들로 벨로그 포스트 작성해줘"
나: "지난 10개 커밋 기반으로 블로그 글 써줘"
나: "v0.19.0 태그 이후 변경사항으로 포스트 초안 만들어줘"

• repo_path：要分析的本地 git 仓库路径（默认值：当前目录）
• commits：获取最近的提交数量（默认值：5）
• since：指定某个提交或标签之后的范围（例如：v0.19.0、HEAD~10）
• include_diff：是否包含代码 diff（默认值：true）
• max_diff_lines：从 diff 中获取的最大行数（默认值：200）
• tags：文章标签提示（未指定时根据文件扩展名自动推断）

GitHub 博客迁移

支持带有 front matter 的 Markdown 文件，例如 Jekyll / Hugo。请先使用 dry_run: true 预览。

나: "내 깃허브 블로그 _posts 폴더 글들을 벨로그 초안으로 옮겨줘"

• 相对路径图片会自动转换为 GitHub raw URL
• 可通过 github_token 参数访问 Private 仓库

超出 GitHub API 限额时

不使用令牌时，每小时限制为 60 次。仅运行一次 dry_run: true 也可能消耗相当一部分限额。

超出限额时，请生成并传入 github_token。

生成令牌：GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token

• 公开仓库：可以不设置范围，但勾选 public_repo 更稳妥
• 私有仓库：勾选 repo

传入令牌后，每小时限额会提升至 5,000 次。

认证

• access_token：TTL 约为 24 小时，由 Velog 服务自动续期
• refresh_token：TTL 约为 30 天。过期后，重新运行 npx -p velog-mcp-claude velog-mcp-setup

注意事项

• draft 保存在 MCP 服务会话内存中。服务重启时会丢失，并在 24 小时后自动过期。
• 如需保留，请使用 velog_publish_post(is_private: true) 以私密方式保存。

路线图

请参阅 docs/roadmap.md。

기능 제안

원하는 기능이 있으면 기능 제안 이슈로 남겨 주세요. 먼저 로드맵과 기존 이슈에 같은 제안이 있는지 확인하고, 있으면 👍 반응이나 댓글로 의견을 보태 주세요.

링크로 열면 제목 앞에 [기능 제안]이 붙고 아래 양식이 자동으로 채워집니다. 각 칸을 채워 주시면 검토가 빠릅니다.

## 하고 싶은 일
Claude에게 어떤 요청을 했을 때 무엇이 되길 원하는지
예) "내 시리즈 글 순서를 발행일 순으로 바꿔줘"

## 지금 불편한 점
현재 툴로는 왜 안 되는지, 어떻게 우회하고 있는지

## 참고 (선택)
Velog 웹에서 같은 동작을 하는 화면, 관련 API 요청 등

Velog 비공개 API에 없는 동작이거나 대량 발행·스팸처럼 정상적인 블로그 활동 범위를 벗어나는 기능은 구현하지 않을 수 있습니다.

면책 조항

내부 GraphQL API를 리버스 엔지니어링하여 구현되었습니다. API 구조 변경으로 예고 없이 동작이 중단될 수 있습니다.