From 24528f9ea303c5676ba389bbc2c15cddff135c82 Mon Sep 17 00:00:00 2001 From: dadachi Date: Sun, 24 May 2026 15:38:25 +0900 Subject: [PATCH] fix(docs): correct MCP server npx invocation (-p package, not bare bin) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit #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) --- CLAUDE.md | 2 +- README.md | 2 +- ROADMAP.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index f9a88da..2423e6e 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -112,7 +112,7 @@ Each is an independent, buildable git repo. Ships as two surfaces today: - `npx nativeapptemplate-agent "your spec"` — standalone CLI (primary) -- `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. +- `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.) 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. diff --git a/README.md b/README.md index 9776ffc..006f64a 100644 --- a/README.md +++ b/README.md @@ -126,7 +126,7 @@ tree ./out/clinic-queue/ # └── validation-report.html ← self-contained visual report (open in a browser) ``` -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). +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). ## Requirements diff --git a/ROADMAP.md b/ROADMAP.md index 8325162..b5a8a08 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -31,7 +31,7 @@ The strategy is two-track. ### Track 1 — Open source (this repository) -`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. +`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. 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.