plopino 0.1.0 → 0.1.2

package/README.md

@@ -27,7 +27,8 @@ link is public and permanent.
 Set `PLOPINO_TOKEN` to publish to your account instead of anonymously. You get private
 boards, updates that keep the same link, and you are not subject to the anonymous rate limit.
 
-Create a token at **plopino.com/b** (it is shown once — the server only stores a hash), then:
+Create a token at **plopino.com/b** — the panel hands you a ready-made command with the token
+already in it (the server keeps an encrypted copy, so you can come back for it any time), then:
 
 ```bash
 claude mcp add plopino --env PLOPINO_TOKEN=plp_xxx -- npx -y plopino
@@ -38,6 +39,10 @@ a token — the anonymous flow is the product.
 
 ## Install
 
+**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
+**plopino.com/b** — the panel there fills it in for you and lets you pick your client.
 
 **Claude Code**
 
@@ -45,38 +50,63 @@ a token — the anonymous flow is the product.
 claude mcp add plopino -e PLOPINO_TOKEN=plp_xxx -- npx -y plopino
 ```
 
-**No npm?** The server also ships as a single self-contained file on the site. Two lines
-instead of one, but nothing to install:
+**Codex** (CLI and IDE extension share `~/.codex/config.toml`)
 
 ```bash
-curl -fsSL https://plopino.com/plopino-mcp.mjs -o "$HOME/.plopino-mcp.mjs"
-claude mcp add plopino -e PLOPINO_TOKEN=plp_xxx -- node "$HOME/.plopino-mcp.mjs"
+codex mcp add plopino --env PLOPINO_TOKEN=plp_xxx -- npx -y plopino
 ```
 
-> `"$HOME/…"` is expanded by your shell as you paste, so the absolute path is what gets
-> registered. That matters: MCP clients spawn the server from an arbitrary working
-> directory, so a relative path would break.
+**Gemini CLI**
+
+```bash
+gemini mcp add -e PLOPINO_TOKEN=plp_xxx plopino npx -y plopino
+```
 
-**Claude Desktop** — add to `claude_desktop_config.json`:
+**WorkBuddy** — `~/.workbuddy/mcp.json` (`%USERPROFILE%\.workbuddy\mcp.json` on Windows;
+needs WorkBuddy 5.3+), then restart WorkBuddy:
 
 ```json
 {
   "mcpServers": {
-    "plopino": { "command": "npx", "args": ["-y", "plopino"] }
+    "plopino": {
+      "command": "npx",
+      "args": ["-y", "plopino"],
+      "env": { "PLOPINO_TOKEN": "plp_xxx" }
+    }
   }
 }
 ```
 
-**Cursor** — add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
+**Cursor** — the same JSON in `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global).
+**Windsurf** — the same JSON in `~/.codeium/windsurf/mcp_config.json`.
+**Claude Desktop** — the same JSON in `claude_desktop_config.json`.
+
+**VS Code** — same idea in `.vscode/mcp.json`, but the key is `servers`, not `mcpServers`:
 
 ```json
 {
-  "mcpServers": {
-    "plopino": { "command": "npx", "args": ["-y", "plopino"] }
+  "servers": {
+    "plopino": {
+      "command": "npx",
+      "args": ["-y", "plopino"],
+      "env": { "PLOPINO_TOKEN": "plp_xxx" }
+    }
   }
 }
 ```
 
+**No npm?** The server also ships as a single self-contained file on the site. Two lines
+instead of one, but nothing to install:
+
+```bash
+curl -fsSL https://plopino.com/plopino-mcp.mjs -o "$HOME/.plopino-mcp.mjs"
+claude mcp add plopino -e PLOPINO_TOKEN=plp_xxx -- node "$HOME/.plopino-mcp.mjs"
+```
+
+> `"$HOME/…"` is expanded by your shell as you paste, so the absolute path is what gets
+> registered. That matters: MCP clients spawn the server from an arbitrary working
+> directory, so a relative path would break.
+
 Then just ask: *"publish this to Plopino"*, or *"give me a link for that page"*.
 
 ## Self-hosted / local

package/index.js

@@ -19,7 +19,19 @@ const BASE = process.env.PLOPINO_BASE_URL || DEFAULT_BASE;
 // 在 plopino.com/b 生成（服务端只存哈希，明文只显示一次）
 const TOKEN = (process.env.PLOPINO_TOKEN || '').trim();
 
-const server = new McpServer({ name: 'plopino', version: '0.1.0' });
+// 服务器级说明（initialize 时返回，客户端会读）。Codex 的文档明确要求把跨工具的用法与约束
+// 放在这里、且前 512 字符能独立成立；Claude Code 等客户端同样会读。放在工具描述之外写，
+// 是因为它要在模型看到工具列表之前就建立"什么时候该想到 Plopino"。
+// 工具描述仍逐个写清各自的适用场景（见下面的 description）。
+const INSTRUCTIONS =
+  'Plopino publishes a page to a public link. Use it whenever the user asks to share, send, '
+  + 'publish, or "give me a link to" something you just produced — a dashboard, report, chart, '
+  + 'or single-page HTML: call publish_html. For a page that needs sibling files (CSS, JS, '
+  + 'images), or content already on disk, call publish_path instead. Do not tell the user to '
+  + 'save the file and upload it somewhere themselves. Publishing works with no account. Every '
+  + 'call returns a permanent public URL that opens on any device — give that link to the user.';
+
+const server = new McpServer({ name: 'plopino', version: '0.1.2' }, { instructions: INSTRUCTIONS });
 
 // 工具描述是给**模型**看的，不是给人看的——要写清楚「什么时候该用」，
 // 否则模型不知道有这个能力，集成了也不会被调用。

package/package.json

@@ -1,14 +1,29 @@
 {
   "name": "plopino",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "mcpName": "io.github.plopino/plopino-mcp",
   "description": "MCP server: publish an HTML page, a file, or a folder to Plopino and get a public URL.",
   "type": "module",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "ai-agents",
+    "html",
+    "publish",
+    "share",
+    "static-hosting",
+    "url"
+  ],
   "bin": {
     "plopino": "index.js"
   },
   "files": [
     "index.js",
     "upload.js",
+    "server.json",
     "README.md",
     "LICENSE"
   ],
@@ -18,9 +33,12 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/AILogbook/boards.git",
-    "directory": "mcp"
+    "url": "https://github.com/plopino/plopino-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/plopino/plopino-mcp/issues"
   },
+  "homepage": "https://plopino.com",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^4.6.5"

package/server.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.plopino/plopino-mcp",
+  "title": "Plopino",
+  "description": "Drop in a page, get a link. Publish an HTML page, a file, or a folder and get a public URL — no account, no build, no config.",
+  "version": "0.1.2",
+  "websiteUrl": "https://plopino.com",
+  "repository": {
+    "url": "https://github.com/plopino/plopino-mcp",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "plopino",
+      "version": "0.1.2",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}