@vscxml/mcp 0.1.1 → 0.1.3

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 (5) hide show
  1. package/README.md +15 -42
  2. package/dist/bin/scxml-mcp.js +8 -3
  3. package/dist/bin/scxml-mcp.js.map +1 -1
  4. package/package.json +4 -3
  5. package/server.json +3 -3
package/README.md CHANGED
@@ -10,7 +10,7 @@ LLM (Claude Code / Claude Desktop / Cursor)
10
10
  | MCP Protocol (stdio)
11
11
  v
12
12
  +-----------------------------------------------+
13
- | @vscxml/mcp |
13
+ | @vscxml/mcp |
14
14
  | |
15
15
  | SimulatorBridge ----WS:48621----> Simulator |
16
16
  | GeneratorBridge ---HTTP:48620---> Generator |
@@ -25,44 +25,28 @@ The MCP server is a **thin client** that bridges three VSCXML backends:
25
25
 
26
26
  ## Setup
27
27
 
28
- ### Claude Code
28
+ ### Claude Code (one-line)
29
29
 
30
- Add to your project's `.claude/settings.json` (or global `~/.claude/settings.json`):
30
+ ```bash
31
+ # Project-level (current project only):
32
+ claude mcp add vscxml -- npx -y @vscxml/mcp
31
33
 
32
- ```json
33
- {
34
- "mcpServers": {
35
- "scxml-gen": {
36
- "command": "node",
37
- "args": ["C:/dev/repos/scxml-gen/scxml-mcp/dist/bin/scxml-mcp.js"]
38
- }
39
- }
40
- }
34
+ # User-level (all projects):
35
+ claude mcp add -s user vscxml -- npx -y @vscxml/mcp
41
36
  ```
42
37
 
43
- Or after npm publish:
44
-
45
- ```json
46
- {
47
- "mcpServers": {
48
- "scxml-gen": {
49
- "command": "npx",
50
- "args": ["@vscxml/mcp"]
51
- }
52
- }
53
- }
54
- ```
38
+ Restart Claude Code after adding. The 37 tools will appear in the tool list.
55
39
 
56
40
  ### Claude Desktop
57
41
 
58
- Add to Claude Desktop settings (`Settings > Developer > MCP Servers`):
42
+ In `Settings > Developer > MCP Servers`:
59
43
 
60
44
  ```json
61
45
  {
62
46
  "mcpServers": {
63
- "scxml-gen": {
47
+ "vscxml": {
64
48
  "command": "npx",
65
- "args": ["@vscxml/mcp"]
49
+ "args": ["-y", "@vscxml/mcp"]
66
50
  }
67
51
  }
68
52
  }
@@ -70,24 +54,13 @@ Add to Claude Desktop settings (`Settings > Developer > MCP Servers`):
70
54
 
71
55
  ### Custom backend URLs
72
56
 
73
- ```json
74
- {
75
- "mcpServers": {
76
- "scxml-gen": {
77
- "command": "npx",
78
- "args": ["@vscxml/mcp", "--generator", "http://localhost:48620", "--simulator", "ws://localhost:48621", "--editor", "ws://localhost:48623"]
79
- }
80
- }
81
- }
57
+ ```bash
58
+ claude mcp add vscxml -- npx -y @vscxml/mcp --generator http://localhost:48620 --simulator ws://localhost:48621 --editor ws://localhost:48623
82
59
  ```
83
60
 
84
- Or via environment variables:
61
+ Or via environment variables: `VSCXML_GENERATOR_URL`, `VSCXML_SIMULATOR_URL`, `VSCXML_EDITOR_URL`.
85
62
 
86
- ```
87
- VSCXML_GENERATOR_URL=http://localhost:48620
88
- VSCXML_SIMULATOR_URL=ws://localhost:48621
89
- VSCXML_EDITOR_URL=ws://localhost:48623
90
- ```
63
+ > **Full setup guide with usage examples:** [vscxml.com/docs/mcp-setup.html](https://vscxml.com/docs/mcp-setup.html)
91
64
 
92
65
  ## Prerequisites
93
66
 
package/dist/bin/scxml-mcp.js CHANGED
@@ -31,15 +31,20 @@ Environment variables:
31
31
  VSCXML_SIMULATOR_URL Override simulator URL
32
32
  VSCXML_EDITOR_URL Override editor URL
33
33
 
34
- Example Claude Desktop config (settings.json):
34
+ Install:
35
+ claude mcp add vscxml -- npx -y @vscxml/mcp
36
+
37
+ Claude Desktop config (settings.json):
35
38
  {
36
39
  "mcpServers": {
37
- "scxml-gen": {
40
+ "vscxml": {
38
41
  "command": "npx",
39
- "args": ["@vscxml/mcp"]
42
+ "args": ["-y", "@vscxml/mcp"]
40
43
  }
41
44
  }
42
45
  }
46
+
47
+ Docs: https://vscxml.com/docs/mcp-setup.html
43
48
  `);
44
49
  process.exit(0);
45
50
  }
package/dist/bin/scxml-mcp.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"scxml-mcp.js","sourceRoot":"","sources":["../../src/bin/scxml-mcp.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,sBAAsB;AACtB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,MAAM,GAAc,EAAE,CAAC;AAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;IACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,KAAK,aAAa;YAChB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM;QACR,KAAK,aAAa;YAChB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM;QACR,KAAK,UAAU;YACb,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,MAAM;QACR,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAyBnB,CAAC,CAAC;YACG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"scxml-mcp.js","sourceRoot":"","sources":["../../src/bin/scxml-mcp.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,sBAAsB;AACtB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,MAAM,GAAc,EAAE,CAAC;AAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;IACrC,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,KAAK,aAAa;YAChB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM;QACR,KAAK,aAAa;YAChB,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM;QACR,KAAK,UAAU;YACb,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7B,MAAM;QACR,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BnB,CAAC,CAAC;YACG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "@vscxml/mcp",
3
- "version": "0.1.1",
3
+ "version": "0.1.3",
4
4
  "description": "MCP server for the VSCXML suite — 37 tools for designing, simulating, generating, and visually editing W3C SCXML state machines via LLMs (Claude Code, Claude Desktop, Cursor)",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "bin": {
8
- "vscxml-mcp": "dist/bin/scxml-mcp.js"
8
+ "vscxml-mcp": "dist/bin/scxml-mcp.js",
9
+ "mcp": "dist/bin/scxml-mcp.js"
9
10
  },
10
11
  "scripts": {
11
12
  "build": "tsc",
@@ -55,7 +56,7 @@
55
56
  ],
56
57
  "repository": {
57
58
  "type": "git",
58
- "url": "https://github.com/mhoffer-hamilton/scxml-gen",
59
+ "url": "https://github.com/miho/vscxml",
59
60
  "directory": "scxml-mcp"
60
61
  }
61
62
  }
package/server.json CHANGED
@@ -1,18 +1,18 @@
1
1
  {
2
2
  "$schema": "https://registry.modelcontextprotocol.io/schemas/server.json",
3
- "name": "io.github.mhoffer-hamilton/scxml-gen",
3
+ "name": "io.github.miho/vscxml",
4
4
  "title": "VSCXML — State Machine Design, Simulation & Code Generation",
5
5
  "description": "37 MCP tools for VSCXML — design, simulate, generate, and visually edit W3C SCXML state machines. Create state machines from natural language, simulate behavior with traces, generate production code for 7 targets (Java, JavaScript, C#, C, Python, Go, Structured Text), export SVG/PNG/interactive HTML, and collaborate visually with the VSCXML-Editor. Works with VSCXML-Generator-CLI, VSCXML-Simulator, and VSCXML-Editor.",
6
6
  "homepage": "https://vscxml.com/docs/mcp-setup.html",
7
7
  "repository": {
8
- "url": "https://github.com/mhoffer-hamilton/scxml-gen",
8
+ "url": "https://github.com/miho/vscxml",
9
9
  "source": "github"
10
10
  },
11
11
  "packages": [
12
12
  {
13
13
  "registry_name": "npm",
14
14
  "name": "@vscxml/mcp",
15
- "version": "0.1.0",
15
+ "version": "0.1.3",
16
16
  "runtime": "node",
17
17
  "environment_variables": [
18
18
  {