Skip to content

Commit 300696f

Browse files
dadachiclaude
andauthored
fix(docs): correct MCP server npx invocation (-p package, not bare bin) (#101)
#99 documented the MCP server as `npx -y nativeapptemplate-agent-mcp`, but there is no npm package by that name — it's a *bin* of the `nativeapptemplate-agent` package, so the bare form 404s. Use the package-scoped form: `npx -y -p nativeapptemplate-agent nativeapptemplate-agent-mcp`. Verified against published 0.2.1 from a clean dir with a real MCP initialize handshake (returns serverInfo nativeapptemplate-agent 0.2.1). Fixes the runnable references in README, CLAUDE.md, and ROADMAP; SPEC's bin-name mention and the ROADMAP prose identifier are left as-is (not commands). Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 88a9868 commit 300696f

3 files changed

Lines changed: 3 additions & 3 deletions

File tree

CLAUDE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -112,7 +112,7 @@ Each is an independent, buildable git repo.
112112

113113
Ships as two surfaces today:
114114
- `npx nativeapptemplate-agent "your spec"` — standalone CLI (primary)
115-
- `npx -y nativeapptemplate-agent-mcp` — stdio MCP server wrapping `dispatch()` as a `generate_app` tool, for any MCP-capable assistant (Claude Code, Cursor, Cline, Goose). The distribution multiplier.
115+
- `npx -y -p nativeapptemplate-agent nativeapptemplate-agent-mcp` — stdio MCP server wrapping `dispatch()` as a `generate_app` tool, for any MCP-capable assistant (Claude Code, Cursor, Cline, Goose). The distribution multiplier. (The `-mcp` entry point is a *bin* of the `nativeapptemplate-agent` package, not its own package — hence `-p`; `npx -y nativeapptemplate-agent-mcp` 404s.)
116116

117117
A Claude Code plugin (slash command + orchestration skill) is **post-v0.1 backlog**, gated on streaming progress out of `dispatch()` and a skill that chains validation + a `mobile-mcp` walkthrough — against today's single-tool MCP a plugin would be a thin wrapper. See `ROADMAP.md` → Post-v0.1 backlog.
118118

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ tree ./out/clinic-queue/
126126
# └── validation-report.html ← self-contained visual report (open in a browser)
127127
```
128128

129-
The same generator also ships as an MCP server — `npx -y nativeapptemplate-agent-mcp` exposes a `generate_app` tool, so any MCP-capable assistant (Claude Code, Cursor, Cline, Goose) can invoke it without leaving the editor. A Claude Code plugin (a discoverable slash command plus an orchestration skill that chains validation and a `mobile-mcp` walkthrough) is planned post-v0.1 — see the [roadmap](./ROADMAP.md#post-v01-backlog).
129+
The same generator also ships as an MCP server — `npx -y -p nativeapptemplate-agent nativeapptemplate-agent-mcp` exposes a `generate_app` tool, so any MCP-capable assistant (Claude Code, Cursor, Cline, Goose) can invoke it without leaving the editor. A Claude Code plugin (a discoverable slash command plus an orchestration skill that chains validation and a `mobile-mcp` walkthrough) is planned post-v0.1 — see the [roadmap](./ROADMAP.md#post-v01-backlog).
130130

131131
## Requirements
132132

ROADMAP.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ The strategy is two-track.
3131

3232
### Track 1 — Open source (this repository)
3333

34-
`npx nativeapptemplate-agent "your spec"` — the CLI form of the agent, and the primary surface. A second surface ships alongside it: `npx -y nativeapptemplate-agent-mcp`, a stdio MCP server exposing a `generate_app` tool so any MCP-capable assistant (Claude Code, Cursor, Cline, Goose) can invoke the agent without a terminal — the distribution multiplier. Both target the free-edition substrate and require an Anthropic API key; every generation run reproduces end-to-end on the reviewer's machine. A Claude Code plugin is a planned third surface — see Post-v0.1 backlog.
34+
`npx nativeapptemplate-agent "your spec"` — the CLI form of the agent, and the primary surface. A second surface ships alongside it: `npx -y -p nativeapptemplate-agent nativeapptemplate-agent-mcp`, a stdio MCP server exposing a `generate_app` tool so any MCP-capable assistant (Claude Code, Cursor, Cline, Goose) can invoke the agent without a terminal — the distribution multiplier. Both target the free-edition substrate and require an Anthropic API key; every generation run reproduces end-to-end on the reviewer's machine. A Claude Code plugin is a planned third surface — see Post-v0.1 backlog.
3535

3636
This track is permanent. It is not a free trial of a commercial product — it is how we believe a generator like this should ship by default in 2026.
3737

0 commit comments

Comments
 (0)