postmd-mcp-server 2.1.0 → 2.1.1

package/README.md

@@ -73,19 +73,21 @@ For uploads: either pass the full Markdown as the `markdown` argument, or pass a
 
 ## Quickstart
 
+Nothing to install. `npx` fetches the package and the MCP client spawns it.
+
 ```bash
-git clone https://github.com/reinlainer/postmd-mcp-server.git
-cd postmd-mcp-server
-npm ci
-node src/index.js      # normally spawned by the MCP client; use for debugging
+npx -y postmd-mcp-server
 ```
 
+Run it by hand only to check that it starts — it speaks MCP over stdin and stdout, so it
+will sit there waiting for a client.
+
 ## Client configuration
 
 Claude Code:
 
 ```bash
-claude mcp add postmd -- node /absolute/path/to/postmd-mcp-server/src/index.js
+claude mcp add postmd -- npx -y postmd-mcp-server
 ```
 
 Cursor (`~/.cursor/mcp.json`) and most other stdio clients:
@@ -95,14 +97,23 @@ Cursor (`~/.cursor/mcp.json`) and most other stdio clients:
   "mcpServers": {
     "PostMD": {
       "type": "stdio",
-      "command": "node",
-      "args": ["/absolute/path/to/postmd-mcp-server/src/index.js"],
+      "command": "npx",
+      "args": ["-y", "postmd-mcp-server"],
       "env": { "POSTMD_API_KEY": "pmk_…" }
     }
   }
 }
 ```
 
+To run a checkout instead — changing the code, or debugging against a local PostMD —
+point the client at the file.
+
+```bash
+git clone https://github.com/reinlainer/postmd-mcp-server.git
+cd postmd-mcp-server && npm ci
+claude mcp add postmd-dev -- node "$PWD/src/index.js"
+```
+
 Leave `env` out entirely for publish/read-only use. `cp .env.example .env` works too — the server loads its own `.env`.
 
 ## Smoke test

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postmd-mcp-server",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "MCP server for PostMD — publish Markdown, get a shareable web page",
   "mcpName": "io.github.reinlainer/postmd-mcp-server",
   "type": "module",

package/server.json

@@ -2,7 +2,7 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.reinlainer/postmd-mcp-server",
   "description": "Publish Markdown to PostMD and get a shareable web page",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "repository": {
     "url": "https://github.com/reinlainer/postmd-mcp-server",
     "source": "github"
@@ -11,7 +11,7 @@
     {
       "registryType": "npm",
       "identifier": "postmd-mcp-server",
-      "version": "2.1.0",
+      "version": "2.1.1",
       "transport": {
         "type": "stdio"
       },

package/src/index.js

@@ -176,9 +176,18 @@ const ATTACHMENT_MIME = {
   pdf: "application/pdf",
 };
 
-/** 만든 문서에는 나눠 줄 주소를 붙여 준다. 에이전트의 다음 행동이 바로 그것이다. */
+/**
+ * 만든 문서에는 나눠 줄 주소를 붙여 준다. 에이전트의 다음 행동이 바로 그것이다.
+ *
+ * 서버가 이미 `shareUrl` 을 돌려주면 그것을 쓴다. 서버는 요청이 실제로 들어온 주소를
+ * 보고 만들고, 여기서는 `POSTMD_BASE_URL` 을 보고 만든다. 자체 호스팅에서 그 둘이
+ * 다르면 값이 갈리는데, 사람에게 건너가는 주소는 서버가 아는 쪽이 맞다.
+ *
+ * 그래도 이 함수를 남겨 둔다. `shareUrl` 을 돌려주지 않는 구 버전 서버를 가리키는
+ * 설정이 있을 수 있고, 그때도 에이전트는 건넬 주소를 받아야 한다.
+ */
 function addShareUrl(ctx, data) {
-  if (data && typeof data.docCode === "string" && data.docCode) {
+  if (data && typeof data.docCode === "string" && data.docCode && !data.shareUrl) {
     data.shareUrl = `${ctx.base}/share/${encodeURIComponent(data.docCode)}`;
   }
 }