@opencraw/mcp 0.1.8 → 0.1.10

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.
Files changed (2) hide show
  1. package/README.md +15 -8
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -1,11 +1,18 @@
1
+ <p align="center">
2
+ <img src="https://raw.githubusercontent.com/russoedu/open.craw/main/docs/assets/opencraw-logo.svg" alt="OpenCraw" width="360">
3
+ </p>
4
+
1
5
  # @opencraw/mcp
2
6
 
3
- An MCP (Model Context Protocol) server exposing [`@opencraw/core`](../core) as tools an agent can call
4
- directly: probe a page, validate recipes, run a crawl, list what's already authored. Local transport only
5
- (stdio) — the host launches it as a subprocess, the same shape as the [`opencraw` cli](../cli).
7
+ An MCP (Model Context Protocol) server exposing [`@opencraw/core`](https://github.com/russoedu/open.craw/blob/main/packages/core) as tools an agent can call
8
+ directly: probe a page, validate recipes, run a crawl, list what's already authored, compare two runs. Local transport only
9
+ (stdio) — the host launches it as a subprocess, the same shape as the [`opencraw` cli](https://github.com/russoedu/open.craw/blob/main/packages/cli).
10
+
11
+ For a shared, remote endpoint that authors recipes where they will run (and publishes them to a crawl host), see
12
+ [`@opencraw/azure-durable`](https://github.com/russoedu/open.craw/blob/main/packages/azure-durable/README.md#write-recipes-over-mcp)'s `/mcp`.
6
13
 
7
- This does **not** auto-author recipes from a sentence. The four tools are the same primitives the
8
- `opencraw` cli gives a terminal; the calling agent still writes the JSON recipes, using `probe` and
14
+ This does **not** auto-author recipes from a sentence. The five tools are, `list_recipes` aside, the same
15
+ primitives the `opencraw` cli gives a terminal; the calling agent still writes the JSON recipes, using `probe` and
9
16
  `validate` to iterate, the same way this project's own example recipes were built by hand. An agent that
10
17
  can write files passes their `paths`; one that can't (a chat-only host) passes the `recipes` inline.
11
18
 
@@ -33,7 +40,7 @@ a module whose default export is `{ name: function }` is read as hooks alone. On
33
40
  names it, never a tool call, so an agent can run recipes that use your plugins but can't make the server load
34
41
  a module of its choosing.
35
42
 
36
- `OPENCRAW_ACCESS` points at an access config ([access.md](../../docs/recipes/access.md)): proxy profiles, with
43
+ `OPENCRAW_ACCESS` points at an access config ([access.md](https://github.com/russoedu/open.craw/blob/main/docs/recipes/access.md)): proxy profiles, with
37
44
  credentials as `{{env.NAME}}` read from the server's environment. The `probe` and `run` tools then take an
38
45
  `access` argument naming a profile. The file and the credentials never pass through a tool call.
39
46
 
@@ -63,8 +70,8 @@ spreadsheet type or `text/csv`, or a local `.xlsx`, `.csv` or `.tsv` path) it ad
63
70
  `workbook: { csv?: { encoding, delimiter }, sheets, rows, headers }`. For a presentation it adds
64
71
  `deck: { width, height, slides, headers, charts, grids }`, and for JSON, JSON Lines or YAML
65
72
  `json: { format, type, tree, lists }`: the structure, and every list of records with its path. An HTML page
66
- adds `html: { tables, outline?, frontMatter? }`: its tables' header rows, and for Markdown its sections and
67
- front matter keys.
73
+ adds `html: { tables, outline?, frontMatter? }`: its tables' header rows, and for Markdown or a Word document its
74
+ sections and front matter keys. XML (a feed, a sitemap) adds `xml: { root, namespaces, lists, tree, sitemap? }`.
68
75
 
69
76
  ### `validate`
70
77
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@opencraw/mcp",
3
- "version": "0.1.8",
3
+ "version": "0.1.10",
4
4
  "type": "module",
5
5
  "main": "./dist/index.esm.js",
6
6
  "module": "./dist/index.esm.js",
@@ -24,8 +24,8 @@
24
24
  "!**/*.js.map"
25
25
  ],
26
26
  "dependencies": {
27
- "@opencraw/core": "^0.1.8",
28
- "@opencraw/cli": "^0.1.8",
27
+ "@opencraw/core": "^0.1.10",
28
+ "@opencraw/cli": "^0.1.10",
29
29
  "@modelcontextprotocol/sdk": "^1.30.1",
30
30
  "playwright": "^1.63.0",
31
31
  "zod": "^4.6.5"