postmd-mcp-server 2.5.0 → 2.6.1

package/README.md

@@ -1,6 +1,6 @@
 # PostMD MCP Server
 
-[Model Context Protocol](https://modelcontextprotocol.io) server for **[PostMD](https://postmd.turink.com)** — publish a Markdown document, get a web page you share by link, and add a document graph that the viewer draws beside the text: the reading order, the bodies and rules a document names, a procedure spread over its chapters. Optional groups, document passwords and viewer themes. This server wraps PostMD's public API (`/api/v1`) so assistants can publish, read, update and organize documents.
+[Model Context Protocol](https://modelcontextprotocol.io) server for **[PostMD](https://postmd.turink.com)** — publish a Markdown document, get a web page you share by link, and add a document graph that the viewer draws: the reading order, the bodies and rules a document names, a procedure spread over its chapters. Optional groups, document passwords and viewer themes. This server wraps PostMD's public API (`/api/v1`) so assistants can publish, read, update and organize documents.
 
 **Publishing needs no account and no key.** With zero configuration this server can already turn Markdown into a shareable page, and the hosted server at `https://postmd.turink.com/mcp` needs no install either. An API key adds management: organizing documents in groups, and notes.
 
@@ -59,7 +59,7 @@ Managing documents — key with `documents:write` (or password / no credential f
 
 ### Graphs
 
-A PostMD document can carry graph data that the viewer draws in a panel beside the text, showing
+A PostMD document can carry graph data that the viewer draws, showing
 how the parts of the document relate. No tool here creates or edits a graph, because there is no
 endpoint for one: the data sits in the Markdown as an HTML comment and travels with the body.
 
@@ -71,6 +71,14 @@ The format is at <https://postmd.turink.com/docs/graph>. Working out what the no
 they connect requires reading the document, which is the calling agent's part; PostMD only draws
 what it finds.
 
+### Keeping the code in the file
+
+A Markdown file can carry the code of the document it was published as, in an HTML comment at its
+top marked `postmd:document`. A later session that opens the file can then tell which document to
+update without being given the address. The format is at <https://postmd.turink.com/docs/api>,
+"Keeping the code in the file". No tool here writes the comment; the calling agent edits its own
+file.
+
 ### Replacing content on a document that has notes
 
 Notes are located by the text they quote, not by a stored position. Replacing a

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "postmd-mcp-server",
-  "version": "2.5.0",
-  "description": "MCP server for PostMD — publish Markdown as a shareable web page, with document graphs beside the text",
+  "version": "2.6.1",
+  "description": "MCP server for PostMD — publish Markdown as a shareable web page, with document graphs",
   "mcpName": "io.github.reinlainer/postmd-mcp-server",
   "type": "module",
   "main": "src/index.js",

package/server.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.reinlainer/postmd-mcp-server",
-  "description": "Publish Markdown as a shareable web page, with document graphs drawn beside the text",
-  "version": "2.5.0",
+  "description": "Publish Markdown as a shareable web page, with document graphs",
+  "version": "2.6.1",
   "repository": {
     "url": "https://github.com/reinlainer/postmd-mcp-server",
     "source": "github"
@@ -11,7 +11,7 @@
     {
       "registryType": "npm",
       "identifier": "postmd-mcp-server",
-      "version": "2.5.0",
+      "version": "2.6.1",
       "transport": {
         "type": "stdio"
       },

package/src/server.js

@@ -6,9 +6,10 @@
  * 전송에 따라 달라지는 것은 어느 도구를 여느냐 하나뿐이다(REMOTE_TOOLS).
  *
  * 필수 환경변수는 없다. POSTMD_BASE_URL 이 없으면 운영(https://postmd.turink.com)을
- * 부르고, POSTMD_API_KEY 가 없으면 발행과 읽기만 할 수 있다 — 그것만으로도 PostMD 의
- * 기본 쓰임은 다 된다. 문서 관리(수정·삭제)·첨부·그룹에는 키가 필요하며, 키 없이
- * 그런 도구를 부르면 어느 스코프가 왜 필요한지 알려 준다.
+ * 부른다. POSTMD_API_KEY 가 없어도 문서 한 건의 발행·조회·수정·삭제는 다 된다 — 비밀번호가
+ * 없는 문서는 누구나 고치고 지울 수 있고, 걸린 문서는 그 비밀번호를 받는다. 키는 여러 파일을
+ * 한꺼번에 올리거나 메모와 그룹을 다룰 때 필요하며, 키 없이 그런 도구를 부르면 어느 스코프가
+ * 필요한지 알려 준다.
  *
  * 도구 설명과 오류 문구는 영어다. 이 문장들은 사람이 아니라 에이전트가 읽는다.
  */
@@ -51,8 +52,8 @@ const INSTRUCTIONS_REMOTE =
   "data.shareUrl - hand that URL to people. What else the service can do, and which page describes it, is listed at https://postmd.turink.com/llms.txt - including graph data, which is carried inside the Markdown rather than through a tool.";
 
 /**
- * 원격에서 여는 도구. 자격 증명 없이 끝까지 가는 것만 남겼다 - 발행과 조회, 그리고 발행할
- * 때 받은 제어 토큰으로 하는 수정·삭제다.
+ * 원격에서 여는 도구. 자격 증명 없이 끝까지 가는 것만 남겼다 - 발행과 조회, 수정·삭제다.
+ * 비밀번호가 없는 문서는 누구나 고치고 지울 수 있고, 걸린 문서는 그 비밀번호를 받는다.
  *
  * 뺀 것은 두 부류다. API 키를 요구하는 도구는 원격에 키를 줄 길이 없어 부르면 반드시
  * 실패하고, `filePath` 를 받는 도구는 그 파일이 이 서버가 도는 기계에 없다.
@@ -132,7 +133,7 @@ function textErr(message) {
  * 키가 필요한 도구의 문지기. 키가 없으면 네트워크에 나가지 않고 여기서 알려 준다.
  *
  * 원격에는 키를 건네줄 길 자체가 없다. 그 자리에서 환경변수를 설정하라고 하면 부르는 쪽이
- * 할 수 없는 일을 시키는 것이므로, 대신 발행할 때 받은 제어 토큰을 가리킨다.
+ * 할 수 없는 일을 시키는 것이므로, 대신 키를 넣어 로컬 서버를 띄우는 길을 가리킨다.
  */
 function missingKey(ctx, scopes) {
   if (ctx.key) return null;
@@ -213,7 +214,6 @@ async function readLocalFile(filePath) {
   return { buffer: await fs.readFile(resolved), suggestedName: path.basename(resolved) };
 }
 
-/** 첨부는 서버가 확장자로 받아 준다. Content-Type 은 예의상 맞춰 보낸다. */
 /**
  * 만든 문서에는 나눠 줄 주소를 붙여 준다. 에이전트의 다음 행동이 바로 그것이다.
  *
@@ -314,7 +314,9 @@ const TOOL_DEFS = [
       "30-day retention period (data.retainedUntil) that extends on each read. Documents " +
       "without a password can be updated or deleted by anyone; password-protected documents " +
       "require the password or the owner's API key. With an API key the document belongs to " +
-      "that member; groupId files it into that group (key with documents:write).",
+      "that member; groupId files it into that group (key with documents:write). The returned " +
+      "docCode can be kept at the top of the source file in a `postmd:document` comment " +
+      "(format at /docs/api) so a later session finds the document.",
     annotations: { title: "Publish document", destructiveHint: false },
     inputSchema: {
       type: "object",
@@ -323,7 +325,7 @@ const TOOL_DEFS = [
           type: "string",
           description:
             "Full Markdown document as one UTF-8 string (the entire source, not a summary). " +
-            "May include graph data in an HTML comment, which the viewer draws beside the text; " +
+            "May include graph data in an HTML comment, which the viewer draws; " +
             "the format is at /docs/graph.",
         },
         title: {