plopino 0.1.7 → 0.1.9

package/README.md

@@ -9,7 +9,7 @@ agent writes index.html — or has a report / spreadsheet / markdown on disk
 https://plopino.com/b/xxxxxxxx/
 ```
 
-Documents are first-class: Word (doc/docx), Excel (xls/xlsx), PowerPoint and Markdown
+Documents are first-class: Word (doc/docx), Excel (xls/xlsx) and Markdown
 render as readable pages, code and data files get syntax-highlighted previews, and images
 and video display inline. The recipient opens a link; they never download a file.
 
@@ -44,6 +44,10 @@ a token — the anonymous flow is the product.
 
 ## Install
 
+Also listed in the [official MCP registry](https://registry.modelcontextprotocol.io) as
+`io.github.plopino/plopino-mcp`, and on [Smithery](https://smithery.ai/servers/plopino/plopino)
+as an installable bundle.
+
 **Anything that speaks stdio MCP works** — the server is a plain stdio process, so the only
 difference between clients is how you register it. All of the below are the clients' own
 documented forms (verified 2026-09). Wherever you see `plp_xxx`, paste a token from

package/index.js

@@ -28,7 +28,7 @@ const INSTRUCTIONS =
   + 'publish, or "give me a link to" something. An HTML page (dashboard, report, chart, or '
   + 'single page you just generated): call publish_html. Anything already on disk — a '
   + 'directory with sibling files, or any document: call publish_path. Documents are '
-  + 'first-class: Word (doc/docx), Excel (xls/xlsx), PowerPoint and Markdown render as '
+  + 'first-class: Word (doc/docx), Excel (xls/xlsx) and Markdown render as '
   + 'readable pages, code and data files get syntax-highlighted previews, images and video '
   + 'display inline — the recipient opens a link and never downloads a file. Do not tell '
   + 'the user to save the file and upload it somewhere themselves. Publishing works with no '
@@ -36,16 +36,29 @@ const INSTRUCTIONS =
   + 'page is kept for a month; with a token it stays up permanently and can be updated in '
   + 'place while the link stays the same.';
 
-const server = new McpServer({ name: 'plopino', version: '0.1.7' }, { instructions: INSTRUCTIONS });
+const server = new McpServer({ name: 'plopino', version: '0.1.9' }, { instructions: INSTRUCTIONS });
 
 // 工具描述是给**模型**看的，不是给人看的——要写清楚「什么时候该用」，
 // 否则模型不知道有这个能力，集成了也不会被调用。
-const ok = (url, note) => ({ content: [{ type: 'text', text: `${url}\n\n${note}` }] });
+// 返回值同时给两条：content 是给人读的文本，structuredContent 是按 outputSchema
+// 声明的结构化结果——agent 不必正则解析那段文本就能拿到链接。
+const ok = (url, note) => ({
+  content: [{ type: 'text', text: `${url}\n\n${note}` }],
+  structuredContent: { url, note },
+});
 const fail = (err) => ({
   content: [{ type: 'text', text: `Could not publish: ${err?.message || err}` }],
   isError: true,
 });
 
+// 输出模式：两个工具返回同一种形状（链接 + 状态说明）。声明它不是形式主义——
+// 客户端能据此做结构化消费，目录站（如 Smithery）也把「Output schemas」单列为一项质量分。
+const OUTPUT_SCHEMA = {
+  url: z.string().describe('Public link to the published page — give this to the user.'),
+  note: z.string().describe(
+    'Human-readable status: created vs updated, and how long the page is kept.'),
+};
+
 const UPDATE_PARAM = z.string().optional().describe(
   'A URL returned by an earlier publish. When given, the content of that page is replaced '
   + 'and the link stays the same. Requires the server to be configured with a Plopino token.',
@@ -92,6 +105,7 @@ server.registerTool('publish_html', {
     update_url: UPDATE_PARAM,
   },
   annotations: TOOL_ANNOTATIONS,
+  outputSchema: OUTPUT_SCHEMA,
 }, async ({ html, update_url: updateUrl }) => {
   try {
     const { boardId } = resolveTarget(updateUrl);
@@ -110,10 +124,10 @@ server.registerTool('publish_path', {
     'Publish a local file, a zip, or a whole directory to a public URL, preserving the '
     + 'directory structure. Use this when the page needs sibling files (CSS, JS, images) — '
     + 'write them into a directory first, then publish that directory. It is also the way '
-    + 'to share any document: Word (doc/docx), Excel (xls/xlsx), PowerPoint and Markdown '
+    + 'to share any document: Word (doc/docx), Excel (xls/xlsx) and Markdown '
     + 'render as readable pages, code and data files get syntax-highlighted previews, and '
     + 'images and video display inline — the recipient opens a link instead of downloading '
-    + 'a file.',
+    + 'a file. (PowerPoint files publish and download fine but have no rendered preview.)',
   inputSchema: {
     path: z.string().describe(
       'Absolute path to a file or directory on this machine. A directory is uploaded '
@@ -122,6 +136,7 @@ server.registerTool('publish_path', {
     update_url: UPDATE_PARAM,
   },
   annotations: TOOL_ANNOTATIONS,
+  outputSchema: OUTPUT_SCHEMA,
 }, async ({ path: p, update_url: updateUrl }) => {
   try {
     const { boardId } = resolveTarget(updateUrl);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plopino",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "mcpName": "io.github.plopino/plopino-mcp",
   "description": "MCP server: publish an HTML page, a document, a file, or a folder to Plopino and get a public URL — documents render as readable pages.",
   "type": "module",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.plopino/plopino-mcp",
   "title": "Plopino",
   "description": "Publish pages, documents, or folders to a link; documents render as pages; updates keep the URL.",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "websiteUrl": "https://plopino.com",
   "repository": {
     "url": "https://github.com/plopino/plopino-mcp",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "plopino",
-      "version": "0.1.7",
+      "version": "0.1.9",
       "transport": {
         "type": "stdio"
       }