plopino 0.1.5 → 0.1.6

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.md CHANGED
@@ -4,17 +4,21 @@ MCP server for [Plopino](https://plopino.com) — lets an AI agent publish what
4
4
  and hand back a public link, without the user touching a browser.
5
5
 
6
6
  ```
7
- agent writes index.html
7
+ agent writes index.html — or has a report / spreadsheet / markdown on disk
8
8
  ↓ publish_html / publish_path
9
9
  https://plopino.com/b/xxxxxxxx/
10
10
  ```
11
11
 
12
+ Documents are first-class: Word (doc/docx), Excel (xls/xlsx), PowerPoint and Markdown
13
+ render as readable pages, code and data files get syntax-highlighted previews, and images
14
+ and video display inline. The recipient opens a link; they never download a file.
15
+
12
16
  ## Tools
13
17
 
14
18
  | Tool | Use it when |
15
19
  |---|---|
16
20
  | `publish_html` | You have the page as a string. The most direct path for generated HTML. |
17
- | `publish_path` | The page needs sibling files (CSS, JS, images), or you are sharing something that is already on disk. Point it at a directory and the structure is preserved — no need to zip first. |
21
+ | `publish_path` | The page needs sibling files (CSS, JS, images), or you are sharing something that is already on disk — including any document. Point it at a directory and the structure is preserved — no need to zip first. |
18
22
 
19
23
  Both take an optional `update_url`: pass a link returned by an earlier publish and that page's
20
24
  content is replaced **while the link stays the same**. This needs a token (see below).
package/index.js CHANGED
@@ -24,16 +24,19 @@ const TOKEN = (process.env.PLOPINO_TOKEN || '').trim();
24
24
  // 是因为它要在模型看到工具列表之前就建立"什么时候该想到 Plopino"。
25
25
  // 工具描述仍逐个写清各自的适用场景(见下面的 description)。
26
26
  const INSTRUCTIONS =
27
- 'Plopino publishes a page to a public link. Use it whenever the user asks to share, send, '
28
- + 'publish, or "give me a link to" something you just produced — a dashboard, report, chart, '
29
- + 'or single-page HTML: call publish_html. For a page that needs sibling files (CSS, JS, '
30
- + 'images), or content already on disk, call publish_path instead. Do not tell the user to '
31
- + 'save the file and upload it somewhere themselves. Publishing works with no account. Every '
32
- + 'call returns a public URL that opens on any device give that link to the user. Without '
33
- + 'a token the page is kept for a month; with a token it stays up permanently and can be '
34
- + 'updated in place while the link stays the same.';
27
+ 'Plopino turns content into a public link use it whenever the user asks to share, send, '
28
+ + 'publish, or "give me a link to" something. An HTML page (dashboard, report, chart, or '
29
+ + 'single page you just generated): call publish_html. Anything already on disk a '
30
+ + 'directory with sibling files, or any document: call publish_path. Documents are '
31
+ + 'first-class: Word (doc/docx), Excel (xls/xlsx), PowerPoint and Markdown render as '
32
+ + 'readable pages, code and data files get syntax-highlighted previews, images and video '
33
+ + 'display inline the recipient opens a link and never downloads a file. Do not tell '
34
+ + 'the user to save the file and upload it somewhere themselves. Publishing works with no '
35
+ + 'account; every call returns a public URL that opens on any device. Without a token the '
36
+ + 'page is kept for a month; with a token it stays up permanently and can be updated in '
37
+ + 'place while the link stays the same.';
35
38
 
36
- const server = new McpServer({ name: 'plopino', version: '0.1.5' }, { instructions: INSTRUCTIONS });
39
+ const server = new McpServer({ name: 'plopino', version: '0.1.6' }, { instructions: INSTRUCTIONS });
37
40
 
38
41
  // 工具描述是给**模型**看的,不是给人看的——要写清楚「什么时候该用」,
39
42
  // 否则模型不知道有这个能力,集成了也不会被调用。
@@ -106,8 +109,11 @@ server.registerTool('publish_path', {
106
109
  description:
107
110
  'Publish a local file, a zip, or a whole directory to a public URL, preserving the '
108
111
  + 'directory structure. Use this when the page needs sibling files (CSS, JS, images) — '
109
- + 'write them into a directory first, then publish that directory. Also use it for '
110
- + 'non-HTML files the user wants to share (Markdown, images, PDF, Office documents).',
112
+ + 'write them into a directory first, then publish that directory. It is also the way '
113
+ + 'to share any document: Word (doc/docx), Excel (xls/xlsx), PowerPoint and Markdown '
114
+ + 'render as readable pages, code and data files get syntax-highlighted previews, and '
115
+ + 'images and video display inline — the recipient opens a link instead of downloading '
116
+ + 'a file.',
111
117
  inputSchema: {
112
118
  path: z.string().describe(
113
119
  'Absolute path to a file or directory on this machine. A directory is uploaded '
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "plopino",
3
- "version": "0.1.5",
3
+ "version": "0.1.6",
4
4
  "mcpName": "io.github.plopino/plopino-mcp",
5
- "description": "MCP server: publish an HTML page, a file, or a folder to Plopino and get a public URL.",
5
+ "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.",
6
6
  "type": "module",
7
7
  "keywords": [
8
8
  "mcp",
package/server.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.plopino/plopino-mcp",
4
4
  "title": "Plopino",
5
- "description": "Publish an HTML page, file, or folder to a public link; update a page without changing its URL.",
6
- "version": "0.1.5",
5
+ "description": "Publish pages, documents, or folders to a link; documents render as pages; updates keep the URL.",
6
+ "version": "0.1.6",
7
7
  "websiteUrl": "https://plopino.com",
8
8
  "repository": {
9
9
  "url": "https://github.com/plopino/plopino-mcp",
@@ -13,7 +13,7 @@
13
13
  {
14
14
  "registryType": "npm",
15
15
  "identifier": "plopino",
16
- "version": "0.1.5",
16
+ "version": "0.1.6",
17
17
  "transport": {
18
18
  "type": "stdio"
19
19
  }