@wireweave/mcp-server 1.8.2-beta.10 → 1.8.2-beta.12

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 +14 -75
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,90 +1,29 @@
1
1
  # @wireweave/mcp-server
2
2
 
3
- A Model Context Protocol (MCP) server that exposes the Wireweave wireframe DSL to MCP clients like Claude Desktop and Cursor.
3
+ An MCP transport adapter for Wireweave tools.
4
4
 
5
- ## What it does
5
+ The [public tool contract](../../docs/spec/TOOLING.md#5-mcp-and-agent-plugins) defines this package's APIs, behavior, configuration and compatibility. The [language contract](../../docs/spec/LANGUAGE.md) defines the DSL. [Package metadata](package.json) owns package versions, exports, dependencies and scripts.
6
6
 
7
- This server is a thin wrapper over [`@wireweave/sdk`](https://github.com/wireweave/sdk). Every tool call from the MCP client is forwarded to the SDK's single `dispatch()` entry point, which routes it to one of two places:
7
+ ## Installation
8
8
 
9
- - **Local tools** run in-process via `@wireweave/core` and `@wireweave/ux-rules`. No network, no credits — they work even without an API key.
10
- - **Server tools** are proxied to the Wireweave API server (`api-server`) over HTTP. These require an API key (cloud project/wireframe storage, account & billing, hosted reference content such as the grammar and LLM guide).
11
-
12
- It serves **32 tools** (9 local + 23 server) plus the prompts and resources defined by the api-server contract. The server does not classify, cache, or post-process results — the SDK and api-server own that logic.
13
-
14
- Local tools:
15
-
16
- `wireweave_parse` · `wireweave_validate` · `wireweave_render_html_code` · `wireweave_validate_ux` · `wireweave_diff` · `wireweave_analyze` · `wireweave_list_components` · `wireweave_export_json` · `wireweave_export_figma`
17
-
18
- ## Install
9
+ Use Node.js >=22.13.0. Replace `<pinned-version>` with the release selected for your toolchain.
19
10
 
20
11
  ```bash
21
- npm install -g @wireweave/mcp-server
22
- ```
23
-
24
- Or run directly:
25
-
26
- ```bash
27
- npx @wireweave/mcp-server
28
- ```
29
-
30
- Requires Node.js 20+. Get an API key from the [Wireweave dashboard](https://wireweave.org).
31
-
32
- ## Usage
33
-
34
- ### MCP client configuration
35
-
36
- Add the server to your MCP client config. For Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`):
37
-
38
- ```json
39
- {
40
- "mcpServers": {
41
- "wireweave": {
42
- "command": "npx",
43
- "args": ["@wireweave/mcp-server"],
44
- "env": {
45
- "WIREWEAVE_API_KEY": "your-api-key"
46
- }
47
- }
48
- }
49
- }
12
+ npm install --global '@wireweave/mcp-server@<pinned-version>'
50
13
  ```
51
14
 
52
- The same `command` / `args` / `env` shape works for any stdio MCP client (Cursor, etc.).
15
+ The installed executable is `wireweave-mcp`. Setup, transports and credentials are defined by the tool contract.
53
16
 
54
- ### Transport
17
+ ## Development
55
18
 
56
- The server runs over **stdio** by default. A streamable-HTTP transport is available with `--http` (or `WIREWEAVE_TRANSPORT=http`), serving the MCP endpoint at `/mcp` and a health check at `/health`.
19
+ Run from the monorepo root after the [workspace setup](../../README.md).
57
20
 
58
21
  ```bash
59
- wireweave-mcp # stdio (default)
60
- wireweave-mcp --http # streamable HTTP on 127.0.0.1:3305
22
+ pnpm --filter @wireweave/mcp-server run build
23
+ pnpm --filter @wireweave/mcp-server run typecheck
24
+ pnpm --filter @wireweave/mcp-server run lint
25
+ pnpm --filter @wireweave/mcp-server run test
26
+ pnpm --filter @wireweave/mcp-server run format:check
61
27
  ```
62
28
 
63
- ## Environment
64
-
65
- | Variable | Default | Purpose |
66
- | ---------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
67
- | `WIREWEAVE_API_KEY` | — | API key from the dashboard. Required for server tools; local tools work without it. The server logs a warning at startup if unset. |
68
- | `WIREWEAVE_API_URL` | `https://api.wireweave.org` | Override the API base. |
69
- | `WIREWEAVE_TRANSPORT` | `stdio` | Set to `http` for streamable HTTP (same as `--http`). |
70
- | `WIREWEAVE_MCP_PORT` | `3305` | HTTP transport port. |
71
- | `WIREWEAVE_MCP_HOST` | `127.0.0.1` | HTTP transport host. |
72
- | `WIREWEAVE_MCP_MAX_SESSIONS` | `10` | Max concurrent HTTP sessions. |
73
-
74
- ## Tools
75
-
76
- Once connected, ask your MCP client to work with wireframes, for example:
77
-
78
- > "Parse and validate this Wireweave DSL." (local)
79
- >
80
- > "Check this wireframe against UX best practices." (local)
81
- >
82
- > "Save this wireframe as 'Dashboard v2' in my project." (server — needs an API key)
83
-
84
- Server tools cover cloud project/wireframe CRUD and versioning, share links, the public gallery, account balance & subscription, pricing, and hosted reference content (grammar, guide, patterns, examples, UX rules). Calls that need a key fail with a clear message if one is not configured.
85
-
86
- Part of the [Wireweave monorepo](https://github.com/wireweave/wireweave).
87
-
88
- ## License
89
-
90
- MIT
29
+ License: MIT.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wireweave/mcp-server",
3
- "version": "1.8.2-beta.10",
3
+ "version": "1.8.2-beta.12",
4
4
  "description": "MCP server for Wireweave DSL - Thin client for API Server",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -16,7 +16,7 @@
16
16
  },
17
17
  "dependencies": {
18
18
  "@modelcontextprotocol/sdk": "^1.0.0",
19
- "@wireweave/sdk": "0.1.1-beta.10"
19
+ "@wireweave/sdk": "0.1.1-beta.12"
20
20
  },
21
21
  "devDependencies": {
22
22
  "@commitlint/cli": "^21.0.1",