velog_mcp

一个允许 Claude 直接在 Velog 上撰写和发布文章的 MCP 服务器。

通过 GraphQL 逆向工程支持没有公开 API 的 Velog。设计为“草稿 → 用户审核 → 发布”的人机协作流程，既实现了自动化，又让用户保持完全的控制权。

安装

npx velog_mcp_setup

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

令牌将以 0600 权限保存在 ~/.velog-mcp.json 中。请将其添加到 .gitignore 中。

Related MCP server: velog-mcp

Claude CLI (Claude Code) 设置

添加到项目

claude mcp add velog npx -y velog_mcp

或者直接添加到项目的 .claude/settings.json 中：

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

全局添加

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

全局设置可在所有项目中使用。

确认

claude mcp list

如果 velog 服务器出现在列表中，则准备就绪。之后可以直接在 Claude Code 对话中使用。

나: "React 훅에 대한 글 써줘"
Claude: (velog_draft_post 호출 → 검토 후 발행)

Claude Desktop 设置

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

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

使用方法

撰写并发布文章

나: "React 19 concurrent features에 대한 글 써줘"

Claude: velog_draft_post 호출
→ { draft_id: "abc123", title: "React 19 Concurrent Features 정리", body_preview: "..." }

나: "좋아, 발행해"

Claude: velog_publish_post(draft_id: "abc123") 호출
→ { url: "https://velog.io/@username/react-19-...", post_id: "..." }

私密发布

나: "이 글 비공개로 발행해줘"
Claude: velog_publish_post(draft_id: "abc123", is_private: true)

工具列表

认证

• access_token: TTL 约为 1-2 小时。Velog 服务器会在 GraphQL 响应中通过 Set-Cookie 自动更新。

• refresh_token: TTL 约为 30 天。过期时需要重新运行 npx velog_mcp_setup。

• 没有单独的刷新端点 — 由 Velog 中间件自动处理。

错误处理

注意事项

• 草稿保存在 MCP 服务器进程的会话内存中。重启 Claude Desktop 时会丢失。

• 若要保存而不发布，请使用 velog_publish_post(is_private: true) 进行私密保存。

• 图片：使用 Markdown 外部 URL 引用方式 (![alt](url))。

许可证

MIT