brewpage-mcp 1.15.3 → 1.15.4
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 +12 -8
- package/dist/tools.d.ts +1 -1
- package/dist/tools.js +6 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -17,7 +17,7 @@ Choosing a host? See how BrewPage compares with GitHub Pages, Netlify Drop, Tiin
|
|
|
17
17
|
## Quick Start
|
|
18
18
|
|
|
19
19
|
```bash
|
|
20
|
-
npx -y brewpage-mcp@1.15.
|
|
20
|
+
npx -y brewpage-mcp@1.15.4
|
|
21
21
|
```
|
|
22
22
|
|
|
23
23
|
Requires Node.js 20 or newer. This starts the stdio server for an MCP client.
|
|
@@ -50,7 +50,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
|
|
50
50
|
"mcpServers": {
|
|
51
51
|
"brewpage": {
|
|
52
52
|
"command": "npx",
|
|
53
|
-
"args": ["-y", "brewpage-mcp@1.15.
|
|
53
|
+
"args": ["-y", "brewpage-mcp@1.15.4"]
|
|
54
54
|
}
|
|
55
55
|
}
|
|
56
56
|
}
|
|
@@ -61,7 +61,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
|
|
|
61
61
|
Register a project-scoped stdio server:
|
|
62
62
|
|
|
63
63
|
```bash
|
|
64
|
-
claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.15.
|
|
64
|
+
claude mcp add --transport stdio --scope project brewpage -- npx -y brewpage-mcp@1.15.4
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
This writes `.mcp.json` in the project root. Use `--scope user` for user-scoped registration. See the [official Claude Code MCP guide](https://code.claude.com/docs/en/mcp).
|
|
@@ -75,7 +75,7 @@ Open **Settings > MCP** and add:
|
|
|
75
75
|
"mcpServers": {
|
|
76
76
|
"brewpage": {
|
|
77
77
|
"command": "npx",
|
|
78
|
-
"args": ["-y", "brewpage-mcp@1.15.
|
|
78
|
+
"args": ["-y", "brewpage-mcp@1.15.4"]
|
|
79
79
|
}
|
|
80
80
|
}
|
|
81
81
|
}
|
|
@@ -89,7 +89,7 @@ Open the Cline MCP settings panel and add:
|
|
|
89
89
|
{
|
|
90
90
|
"brewpage": {
|
|
91
91
|
"command": "npx",
|
|
92
|
-
"args": ["-y", "brewpage-mcp@1.15.
|
|
92
|
+
"args": ["-y", "brewpage-mcp@1.15.4"]
|
|
93
93
|
}
|
|
94
94
|
}
|
|
95
95
|
```
|
|
@@ -97,7 +97,7 @@ Open the Cline MCP settings panel and add:
|
|
|
97
97
|
### Global Install
|
|
98
98
|
|
|
99
99
|
```bash
|
|
100
|
-
npm install -g brewpage-mcp@1.15.
|
|
100
|
+
npm install -g brewpage-mcp@1.15.4
|
|
101
101
|
brewpage-mcp
|
|
102
102
|
```
|
|
103
103
|
|
|
@@ -107,7 +107,7 @@ Twenty tools are available. Creation returns an owner token; keep it to modify o
|
|
|
107
107
|
|
|
108
108
|
| Tool | Purpose |
|
|
109
109
|
|------|---------|
|
|
110
|
-
| `publish_html` | Publish HTML or
|
|
110
|
+
| `publish_html` | Publish HTML, Markdown, code or JSON |
|
|
111
111
|
| `update_html` | Replace page content; omitted format preserves stored format |
|
|
112
112
|
| `get_page` | Fetch raw page content |
|
|
113
113
|
| `publish_file` | Fetch a source URL and upload the file |
|
|
@@ -156,7 +156,7 @@ update_hosting(type="html", namespace="public", id="aBcDeFgHiJ", ownerToken="tok
|
|
|
156
156
|
|
|
157
157
|
### `publish_html`
|
|
158
158
|
|
|
159
|
-
Publish HTML or
|
|
159
|
+
Publish HTML, Markdown, code or JSON content to BrewPage; with `format` omitted the server detects it. Returns a public URL and owner token. Markdown raw HTML is rendered through an allowlist: scripts, styles, event handlers, forms, frames/embeds and `meta`/`base`/`link` are removed; links allow `http`, `https`, `mailto`, `tel` and relative URLs, images also `data:`; a lone unknown tag such as `<author>` shows as text.
|
|
160
160
|
|
|
161
161
|
Parameters: `content` (string), `format` (optional; omit to let the server detect HTML, Markdown, code or JSON; `html` keeps code/JSON as HTML; also `markdown`/`md` or a code language), `namespace` (optional -- **omit for private, unlisted content**; `public` lists the page in the gallery and sitemap for Google, Bing and AI search, served on the brewpage.app domain; never put secrets there), `password` (optional), `ttlDays` (days or a string such as `2w`; default 15; the server clamps to 1--30), `filename` (optional, used as title fallback), `showTopBar` (optional boolean -- adds a toolbar with filename, Download button, and theme toggle), `deliveryMode` (optional).
|
|
162
162
|
|
|
@@ -530,6 +530,10 @@ Every publish response includes an **owner token** -- the only credential that a
|
|
|
530
530
|
|
|
531
531
|
## Changelog
|
|
532
532
|
|
|
533
|
+
## 1.15.4 -- 2026-10-29
|
|
534
|
+
|
|
535
|
+
- `publish_html` and `update_html` texts name HTML, Markdown, code or JSON; `format` omitted -> server detects it.
|
|
536
|
+
|
|
533
537
|
## 1.15.3 -- 2026-10-29
|
|
534
538
|
|
|
535
539
|
- `publish_html` sends `format` only when given, so the server detects code or JSON (contract 2.8.27); pass `html` to keep HTML.
|
package/dist/tools.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/server";
|
|
2
2
|
export declare const DEFAULT_BASE_URL = "https://brewpage.app";
|
|
3
|
-
export declare const USER_AGENT = "brewpage-mcp/1.15.
|
|
3
|
+
export declare const USER_AGENT = "brewpage-mcp/1.15.4";
|
|
4
4
|
export declare const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
|
|
5
5
|
export interface ServerOptions {
|
|
6
6
|
/** BrewPage origin for API calls; default https://brewpage.app. */
|
package/dist/tools.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { McpServer } from "@modelcontextprotocol/server";
|
|
2
2
|
import { z } from "zod";
|
|
3
3
|
export const DEFAULT_BASE_URL = "https://brewpage.app";
|
|
4
|
-
export const USER_AGENT = "brewpage-mcp/1.15.
|
|
4
|
+
export const USER_AGENT = "brewpage-mcp/1.15.4";
|
|
5
5
|
export const OWNER_TOKEN_ENV = "BREWPAGE_OWNER_TOKEN";
|
|
6
6
|
const READ_ONLY = { readOnlyHint: true };
|
|
7
7
|
const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true };
|
|
@@ -188,7 +188,7 @@ export function createServer(options = {}) {
|
|
|
188
188
|
const apiFetch = options.fetch ?? fetch;
|
|
189
189
|
const server = new McpServer({
|
|
190
190
|
name: "brewpage-mcp",
|
|
191
|
-
version: "1.15.
|
|
191
|
+
version: "1.15.4",
|
|
192
192
|
});
|
|
193
193
|
/** Caller argument first, then the configured default; `fromEnv` marks the configured one. */
|
|
194
194
|
function ownerTokenFor(argument) {
|
|
@@ -261,8 +261,8 @@ export function createServer(options = {}) {
|
|
|
261
261
|
return lines.join("\n");
|
|
262
262
|
}
|
|
263
263
|
server.registerTool("publish_html", {
|
|
264
|
-
...toolMeta("Publish HTML or
|
|
265
|
-
description: "Publish HTML or
|
|
264
|
+
...toolMeta("Publish HTML, Markdown, code or JSON page", ADDITIVE),
|
|
265
|
+
description: "Publish HTML, Markdown, code or JSON content to BrewPage (repository default limit 5 MiB); format omitted -> the server detects it. Returns its primary share link and owner token. Supports password protection, custom TTL, optional filename, and an opt-in top toolbar (showTopBar). " +
|
|
266
266
|
"When deliveryMode is omitted for a `public` page, the server may publish it on its own subdomain if the page needs browser features a BrewPage link does not provide; " +
|
|
267
267
|
"the result then includes deliveryModeReason and a delivery notice. Markdown raw HTML is allowlisted: scripts, styles, event handlers, forms and embeds are removed. " +
|
|
268
268
|
MANAGE_URL_TEXT + " " + SECRETS,
|
|
@@ -715,12 +715,12 @@ export function createServer(options = {}) {
|
|
|
715
715
|
});
|
|
716
716
|
server.registerTool("update_html", {
|
|
717
717
|
...toolMeta("Update page", DESTRUCTIVE),
|
|
718
|
-
description: "Update an existing BrewPage HTML
|
|
718
|
+
description: "Update an existing BrewPage HTML, Markdown, code or JSON page. Requires owner token. Returns the updated page metadata. " +
|
|
719
719
|
"The link and delivery mode never change on update; an advisory deliveryModeReason and delivery notice are included when the new content uses browser features that may not work fully on a BrewPage link." + OLD_READ_ONLY_TEXT,
|
|
720
720
|
inputSchema: {
|
|
721
721
|
namespace: z.string().describe("Page namespace"),
|
|
722
722
|
id: z.string().describe("Page ID"),
|
|
723
|
-
content: z.string().describe("New HTML or
|
|
723
|
+
content: z.string().describe("New HTML, Markdown, code or JSON content"),
|
|
724
724
|
ownerToken: z.string().optional().describe(OWNER_TOKEN_DESCRIPTION),
|
|
725
725
|
format: z
|
|
726
726
|
.string()
|
package/package.json
CHANGED