@milcho0604/velog-mcp 0.4.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +27 -4
- package/README.md +29 -4
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
package/README.ko.md
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# velog-mcp
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@milcho0604/velog-mcp)
|
|
3
4
|
[](https://nodejs.org)
|
|
4
5
|
[](LICENSE)
|
|
5
6
|
[](package.json)
|
|
@@ -55,6 +56,18 @@ HTTP·테스트 러너·타입스크립트 실행은 전부 Node 24 내장을
|
|
|
55
56
|
|
|
56
57
|
값을 나중에 바꾸려면 `/plugin manage`.
|
|
57
58
|
|
|
59
|
+
### 그냥 MCP 서버로
|
|
60
|
+
|
|
61
|
+
npm 에 올려뒀으니 클론할 것 없이 MCP 클라이언트가 `npx` 로 띄운다. 설정 블록과
|
|
62
|
+
클라이언트 지원 범위는 [설정](#설정) 을 볼 것.
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
claude mcp add velog -e VELOG_REFRESH_TOKEN=여기에_토큰 \
|
|
66
|
+
-- npx -y @milcho0604/velog-mcp@0.4.1
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
이 방식은 토큰이 클라이언트 설정 파일에 남는다. 위의 플러그인 방식은 키체인에 넣는다.
|
|
70
|
+
|
|
58
71
|
### 직접 빌드해서
|
|
59
72
|
|
|
60
73
|
```bash
|
|
@@ -71,8 +84,8 @@ MCP 클라이언트 설정 파일(`claude_desktop_config.json`, `.mcp.json` 등)
|
|
|
71
84
|
{
|
|
72
85
|
"mcpServers": {
|
|
73
86
|
"velog": {
|
|
74
|
-
"command": "
|
|
75
|
-
"args": ["
|
|
87
|
+
"command": "npx",
|
|
88
|
+
"args": ["-y", "@milcho0604/velog-mcp@0.4.1"],
|
|
76
89
|
"env": {
|
|
77
90
|
"VELOG_REFRESH_TOKEN": "여기에 토큰"
|
|
78
91
|
}
|
|
@@ -84,10 +97,20 @@ MCP 클라이언트 설정 파일(`claude_desktop_config.json`, `.mcp.json` 등)
|
|
|
84
97
|
Claude Code CLI 라면:
|
|
85
98
|
|
|
86
99
|
```bash
|
|
87
|
-
claude mcp add velog
|
|
88
|
-
|
|
100
|
+
claude mcp add velog -e VELOG_REFRESH_TOKEN=여기에_토큰 \
|
|
101
|
+
-- npx -y @milcho0604/velog-mcp@0.4.1
|
|
89
102
|
```
|
|
90
103
|
|
|
104
|
+
로컬 체크아웃으로 돌리려면 command 를
|
|
105
|
+
`node /절대경로/velog-mcp/dist/index.js` 로 바꾼다.
|
|
106
|
+
|
|
107
|
+
> **어떤 클라이언트에서 되나?** 이건 stdio 서버다 — 클라이언트가 로컬 프로세스로 띄운다.
|
|
108
|
+
> Claude Code·Claude Desktop·Cursor 처럼 MCP 서버를 로컬에서 실행하는 클라이언트에서 된다.
|
|
109
|
+
> **claude.ai 와 ChatGPT 웹앱에서는 안 된다** — 둘 다 HTTP 로 접근 가능한 원격 MCP 서버만
|
|
110
|
+
> 받는다. 연결이 내 기계가 아니라 그쪽 서버에서 출발하기 때문이다. 웹에서 쓰려면 서버를
|
|
111
|
+
> 공개 호스팅하고 벨로그 토큰을 그 배포본에 넘겨야 하는데, 그러면 토큰을 내 기계에만
|
|
112
|
+
> 두려던 이유가 사라진다.
|
|
113
|
+
|
|
91
114
|
### 토큰 얻는 법
|
|
92
115
|
|
|
93
116
|
벨로그는 공개 쓰기 API 가 없어서 브라우저 세션 쿠키로 인증한다.
|
package/README.md
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# velog-mcp
|
|
2
2
|
|
|
3
|
+
[](https://www.npmjs.com/package/@milcho0604/velog-mcp)
|
|
3
4
|
[](https://nodejs.org)
|
|
4
5
|
[](LICENSE)
|
|
5
6
|
[](package.json)
|
|
@@ -60,6 +61,19 @@ that declaration (P7).
|
|
|
60
61
|
|
|
61
62
|
Change values later with `/plugin manage`.
|
|
62
63
|
|
|
64
|
+
### As a plain MCP server
|
|
65
|
+
|
|
66
|
+
Published on npm, so nothing to clone — your MCP client runs it via `npx`. See
|
|
67
|
+
[Configure](#configure) for the config block and the client-support note.
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
claude mcp add velog -e VELOG_REFRESH_TOKEN=your_refresh_token \
|
|
71
|
+
-- npx -y @milcho0604/velog-mcp@0.4.1
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
The token stays in your client's config file here. The plugin route above puts it in
|
|
75
|
+
the Keychain instead.
|
|
76
|
+
|
|
63
77
|
### From source
|
|
64
78
|
|
|
65
79
|
```bash
|
|
@@ -76,8 +90,8 @@ Add this to your MCP client config (`claude_desktop_config.json`, `.mcp.json`,
|
|
|
76
90
|
{
|
|
77
91
|
"mcpServers": {
|
|
78
92
|
"velog": {
|
|
79
|
-
"command": "
|
|
80
|
-
"args": ["/
|
|
93
|
+
"command": "npx",
|
|
94
|
+
"args": ["-y", "@milcho0604/velog-mcp@0.4.1"],
|
|
81
95
|
"env": {
|
|
82
96
|
"VELOG_REFRESH_TOKEN": "your_refresh_token"
|
|
83
97
|
}
|
|
@@ -89,10 +103,21 @@ Add this to your MCP client config (`claude_desktop_config.json`, `.mcp.json`,
|
|
|
89
103
|
With the Claude Code CLI:
|
|
90
104
|
|
|
91
105
|
```bash
|
|
92
|
-
claude mcp add velog
|
|
93
|
-
|
|
106
|
+
claude mcp add velog -e VELOG_REFRESH_TOKEN=your_refresh_token \
|
|
107
|
+
-- npx -y @milcho0604/velog-mcp@0.4.1
|
|
94
108
|
```
|
|
95
109
|
|
|
110
|
+
To run a local checkout instead, swap the command for
|
|
111
|
+
`node /absolute/path/to/velog-mcp/dist/index.js`.
|
|
112
|
+
|
|
113
|
+
> **Which clients can run this?** This is a stdio server: the client starts it as a
|
|
114
|
+
> local process. That works in Claude Code, Claude Desktop, Cursor, and other clients
|
|
115
|
+
> that run MCP servers locally. It does **not** work in the claude.ai or ChatGPT web
|
|
116
|
+
> apps — both accept only remote MCP servers reachable over HTTP, since the connection
|
|
117
|
+
> originates from their servers rather than your machine. Using it there would mean
|
|
118
|
+
> hosting it publicly and handing your Velog token to that deployment, which defeats
|
|
119
|
+
> the point of keeping the token on your own machine.
|
|
120
|
+
|
|
96
121
|
### Getting your token
|
|
97
122
|
|
|
98
123
|
Velog has no public write API, so the server authenticates with your browser session
|
package/dist/index.d.ts
CHANGED
|
@@ -10,7 +10,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
|
10
10
|
import { type Capabilities } from './capabilities.ts';
|
|
11
11
|
import { VelogClient } from './client.ts';
|
|
12
12
|
export declare const SERVER_NAME = "velog-mcp";
|
|
13
|
-
export declare const SERVER_VERSION = "0.4.
|
|
13
|
+
export declare const SERVER_VERSION = "0.4.1";
|
|
14
14
|
export declare function createServer(client: VelogClient, capabilities?: Capabilities): McpServer;
|
|
15
15
|
/**
|
|
16
16
|
* 크롬이 있어야만 되는 도구들.
|
package/dist/index.js
CHANGED
|
@@ -28,7 +28,7 @@ import { registerImageTools } from "./tools/images.js";
|
|
|
28
28
|
export const SERVER_NAME = 'velog-mcp';
|
|
29
29
|
// ⚠️ 이 값은 네 곳이 함께 움직인다 — package.json / plugin.json / .mcp.json 의
|
|
30
30
|
// npx 핀 / 여기. 어긋나면 P8 테스트가 잡는다. 손으로 맞추지 말고 테스트를 믿을 것.
|
|
31
|
-
export const SERVER_VERSION = '0.4.
|
|
31
|
+
export const SERVER_VERSION = '0.4.1';
|
|
32
32
|
export function createServer(client, capabilities = { publicPublish: false, editProfile: false }) {
|
|
33
33
|
const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
|
|
34
34
|
instructions: [
|
package/npm-shrinkwrap.json
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@milcho0604/velog-mcp",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"lockfileVersion": 3,
|
|
5
5
|
"requires": true,
|
|
6
6
|
"packages": {
|
|
7
7
|
"": {
|
|
8
8
|
"name": "@milcho0604/velog-mcp",
|
|
9
|
-
"version": "0.4.
|
|
9
|
+
"version": "0.4.1",
|
|
10
10
|
"license": "MIT",
|
|
11
11
|
"dependencies": {
|
|
12
12
|
"@modelcontextprotocol/sdk": "^1.30.0",
|
package/package.json
CHANGED