velog-mcp

# velog-mcp > 에이전트에게 **"이 문서 벨로그에 올려줘"** 라고 말하면 되는 MCP 서버 로컬 마크다운 파일을 [벨로그](https://velog.io)에 발행합니다. 발행하면 파일에 글 id가 적히고, **같은 파일을 다시 올리면 새 글이 생기는 대신 그 글이 수정됩니다.** Cursor·Claude Desktop 등 MCP 클라이언트에 그대로 붙습니다. > ⚠️ **벨로그와 무관한 개인 프로젝트입니다.** 공식 API가 아니라 웹 클라이언트가 쓰는 GraphQL을 그대로 호출하므로, 벨로그가 스키마를 바꾸면 깨질 수 있습니다. _{An MCP server for publishing local Markdown files to velog with idempotent updates. Docs are in Korean since velog is a Korean platform.} --- ## 시작하기 내려받거나 가상환경을 만들 일이 없습니다. 설정에 세 줄 넣고 로그인 한 번이면 끝입니다. ### 1. uv 설치 (한 번만) 패키지를 받아 실행해주는 도구입니다. Node의 `npx`에 해당하고, 다른 파이썬 MCP에도 그대로 씁니다. ```bash curl -LsSf https://astral.sh/uv/install.sh | sh # 또는: brew install uv ``` ### 2. 클라이언트에 등록 ```json { "mcpServers": { "velog": { "command": "uvx", "args": ["--from", "velog-mcp[login]", "velog-mcp"] } } } ``` | 클라이언트 | 설정 파일 | | --- | --- | | Cursor | `~/.cursor/mcp.json` | | Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` | 경로도, 토큰도, 계정명도 적지 않습니다. 어느 컴퓨터에서든 이 세 줄이 같습니다. `[login]`은 브라우저 로그인에 필요합니다. 토큰을 직접 넣어 쓸 거라면 빼도 됩니다 — [토큰을 직접 넣기](https://github.com/mrpumpkin98/velog-mcp/blob/main/docs/reference.md#토큰을-직접-넣기) ### 3. 재시작하고 로그인 클라이언트를 완전히 종료한 뒤 다시 켭니다. MCP 서버는 시작할 때만 읽습니다. 그다음 대화에서 > 벨로그 로그인해줘 브라우저 창이 열리면 평소처럼 로그인하세요. 창이 저절로 닫히고 토큰이 저장됩니다. 벨로그는 **비밀번호 로그인이 없어서**(이메일 링크·소셜 OAuth뿐) 이 한 번만 사람이 해야 하고, 이후 만료는 서버가 알아서 갱신합니다. 확인은 이렇게 합니다. 계정명을 말할 필요가 없습니다. > 내 벨로그 글 목록 보여줘 <details> <summary><b>대화 대신 Connect 버튼으로 로그인하기 (선택)</b></summary> Cursor 설정 화면의 MCP 목록에서 **Connect** 버튼을 눌러 로그인하고 싶다면 HTTP 모드로 띄웁니다. Cursor는 OAuth를 지원하는 서버에만 그 버튼을 그리고, OAuth는 stdio가 아니라 HTTP 트랜스포트에서만 동작합니다. ```bash uvx --from "velog-mcp[login]" velog-mcp --http # 127.0.0.1:8790 ``` 설정에는 `command` 대신 `url`을 적습니다. ```json { "mcpServers": { "velog": { "url": "http://127.0.0.1:8790/mcp" } } } ``` 이제 Connect를 누르면 브라우저가 열려 벨로그 로그인이 진행되고, 끝나면 버튼이 Logout으로 바뀝니다. 한 번 로그인해두면 서버를 재시작해도 연결이 유지되고, 두 번째부터는 창이 뜨…