{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_33nqm5e5nx4n","handle":"velog-mcp","url":"https://wellknown.network/agents/velog-mcp","links":{"self":"https://wellknown.network/agents/velog-mcp/record.json","html":"https://wellknown.network/agents/velog-mcp","markdown":"https://wellknown.network/agents/velog-mcp/record.md","api":"https://wellknown.network/api/v1/agents/velog-mcp","status":"https://wellknown.network/api/v1/agents/velog-mcp/status","claim":"https://wellknown.network/agents/velog-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/velog-mcp/claim.json","badge":"https://wellknown.network/agents/velog-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:velog-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"velog-mcp","summary":"벨로그(velog) 글 발행·수정을 MCP 도구로 노출하는 서버 / MCP server for publishing and updating velog posts","description":"# velog-mcp\n\n> 에이전트에게 **\"이 문서 벨로그에 올려줘\"** 라고 말하면 되는 MCP 서버\n\n로컬 마크다운 파일을 [벨로그](https://velog.io)에 발행합니다. 발행하면 파일에 글 id가 적히고, **같은 파일을 다시 올리면 새 글이 생기는 대신 그 글이 수정됩니다.** Cursor·Claude Desktop 등 MCP 클라이언트에 그대로 붙습니다.\n\n> ⚠️ **벨로그와 무관한 개인 프로젝트입니다.** 공식 API가 아니라 웹 클라이언트가 쓰는 GraphQL을 그대로 호출하므로, 벨로그가 스키마를 바꾸면 깨질 수 있습니다.\n\n<sub>An MCP server for publishing local Markdown files to velog with idempotent updates. Docs are in Korean since velog is a Korean platform.</sub>\n\n---\n\n## 시작하기\n\n내려받거나 가상환경을 만들 일이 없습니다. 설정에 세 줄 넣고 로그인 한 번이면 끝입니다.\n\n### 1. uv 설치 (한 번만)\n\n패키지를 받아 실행해주는 도구입니다. Node의 `npx`에 해당하고, 다른 파이썬 MCP에도 그대로 씁니다.\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh   # 또는: brew install uv\n```\n\n### 2. 클라이언트에 등록\n\n```json\n{\n  \"mcpServers\": {\n    \"velog\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"velog-mcp[login]\", \"velog-mcp\"]\n    }\n  }\n}\n```\n\n| 클라이언트 | 설정 파일 |\n| --- | --- |\n| Cursor | `~/.cursor/mcp.json` |\n| Claude Desktop (macOS) | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n\n경로도, 토큰도, 계정명도 적지 않습니다. 어느 컴퓨터에서든 이 세 줄이 같습니다.\n\n`[login]`은 브라우저 로그인에 필요합니다. 토큰을 직접 넣어 쓸 거라면 빼도 됩니다 — [토큰을 직접 넣기](https://github.com/mrpumpkin98/velog-mcp/blob/main/docs/reference.md#토큰을-직접-넣기)\n\n### 3. 재시작하고 로그인\n\n클라이언트를 완전히 종료한 뒤 다시 켭니다. MCP 서버는 시작할 때만 읽습니다. 그다음 대화에서\n\n> 벨로그 로그인해줘\n\n브라우저 창이 열리면 평소처럼 로그인하세요. 창이 저절로 닫히고 토큰이 저장됩니다. 벨로그는 **비밀번호 로그인이 없어서**(이메일 링크·소셜 OAuth뿐) 이 한 번만 사람이 해야 하고, 이후 만료는 서버가 알아서 갱신합니다.\n\n확인은 이렇게 합니다. 계정명을 말할 필요가 없습니다.\n\n> 내 벨로그 글 목록 보여줘\n\n<details>\n<summary><b>대화 대신 Connect 버튼으로 로그인하기 (선택)</b></summary>\n\nCursor 설정 화면의 MCP 목록에서 **Connect** 버튼을 눌러 로그인하고 싶다면 HTTP 모드로 띄웁니다. Cursor는 OAuth를 지원하는 서버에만 그 버튼을 그리고, OAuth는 stdio가 아니라 HTTP 트랜스포트에서만 동작합니다.\n\n```bash\nuvx --from \"velog-mcp[login]\" velog-mcp --http      # 127.0.0.1:8790\n```\n\n설정에는 `command` 대신 `url`을 적습니다.\n\n```json\n{\n  \"mcpServers\": {\n    \"velog\": { \"url\": \"http://127.0.0.1:8790/mcp\" }\n  }\n}\n```\n\n이제 Connect를 누르면 브라우저가 열려 벨로그 로그인이 진행되고, 끝나면 버튼이 Logout으로 바뀝니다. 한 번 로그인해두면 서버를 재시작해도 연결이 유지되고, 두 번째부터는 창이 뜨…","publisher":null,"homepage":"https://github.com/mrpumpkin98/velog-mcp/blob/main/docs/how-it-works.md","repository":"https://github.com/mrpumpkin98/velog-mcp/blob/main/docs/how-it-works.md","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["blog","markdown","mcp","publishing","velog"],"pricing":null,"endpoints":[{"url":"pypi:velog-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.docs-lookup","name":"Documentation Lookup","confidence":0.791,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"velog-mcp","registry":"pypi","observedAt":"2026-09-10T15:25:07.363Z","publishedAt":"2026-07-29T02:16:50.276480Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"velog-mcp","url":"https://pypi.org/project/velog-mcp/","firstSeenAt":"2026-09-10T15:23:18.071Z","fetchedAt":"2026-09-10T15:23:18.071Z","normalizedAt":"2026-09-10T15:23:18.071Z"}]},"firstSeenAt":"2026-09-10T15:23:18.071Z","updatedAt":"2026-09-10T15:25:07.363Z"}