Skip to content

Build on install via prepare, and fix install docs for the pre-npm GitHub path#1

Merged
ionut85 merged 2 commits into
mainfrom
chore/prepare-script
May 30, 2026
Merged

Build on install via prepare, and fix install docs for the pre-npm GitHub path#1
ionut85 merged 2 commits into
mainfrom
chore/prepare-script

Conversation

@ionut85

@ionut85 ionut85 commented May 30, 2026

Copy link
Copy Markdown
Member

What

  1. Replace prepublishOnly with a prepare script (npm run build) so the package builds its dist/ automatically on install.
  2. Update the README install section to lead with the GitHub spec github:HYPD-AI/openai-ads-mcp (Claude Desktop, Cursor, VS Code, other clients), since the npm package isn't published yet and npx -y openai-ads-mcp 404s today.

Why

A new user can now run the server from a single MCP config block — no clone, no npm install, no absolute path:

"command": "npx",
"args": ["-y", "github:HYPD-AI/openai-ads-mcp"]

prepare runs on git/local installs and before publish, so npx fetches + builds it on the fly. Once published to npm, the spec shortens back to openai-ads-mcp (the README says so).

Verified

  • Fresh clone (no committed dist/) → npm installprepare builds dist/index.js, and the bin then completes an MCP initialize + tools/list handshake. That's exactly the npx github: flow.
  • format:check, lint, typecheck, tests, and build all green.

Notes

  • No runtime behavior change.
  • The first npx github: launch builds from source (~a minute); the README documents a one-time terminal warm-up and points to "Running from source" for instant startup.

https://claude.ai/code/session_01EQTYKCNBFgqc9fTTeSc7qd

claude added 2 commits May 30, 2026 11:38
Replaces prepublishOnly with prepare, which runs on git/local installs and
before publish. This lets the server be run straight from GitHub without a
manual build, e.g. npx -y github:HYPD-AI/openai-ads-mcp, which is handy until
the npm package is published. No runtime behavior changes.
The npm package isn't published yet, so npx -y openai-ads-mcp 404s. Update the
client snippets (Claude Desktop, Cursor, VS Code, other) to use
github:HYPD-AI/openai-ads-mcp, which npx fetches and builds via the prepare
script — no clone or manual build needed. Add a first-launch warm-up note and
point to Running from source for instant startup. Once published, the spec
shortens back to openai-ads-mcp.
@ionut85 ionut85 changed the title Build on install via prepare (enables npx github:… before npm publish) Build on install via prepare, and fix install docs for the pre-npm GitHub path May 30, 2026
@ionut85
ionut85 merged commit 06ea60a into main May 30, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants