@neopress/mcp 0.1.0

package/integrations/README.md

@@ -0,0 +1,55 @@
+# Neopress MCP Integration Drafts
+
+These files prepare Neopress MCP for official client setup without submitting it
+to any external directory yet.
+
+## Surfaces
+
+| Client | Preferred transport | Draft artifact |
+| --- | --- | --- |
+| Codex CLI / IDE | Stdio locally, Streamable HTTP remotely | `codex/config.example.toml` |
+| Claude Code | Stdio locally, Streamable HTTP remotely | `claude-code/setup.md` |
+| Claude Desktop | MCPB local bundle | `claude-desktop/manifest.json` |
+| Claude.ai | Remote MCP connector | `claude-remote/connector-draft.md` |
+| ChatGPT | Remote MCP app in Developer Mode | `chatgpt/app-draft.md` |
+
+## Current Productization State
+
+- Local stdio MCP is ready for agents that can launch `neopress-mcp`.
+- Remote Streamable HTTP MCP is ready as a standalone server, pending deployment
+  to a stable public HTTPS origin such as `https://mcp.neopress.ai/mcp`.
+- Production remote MCP requires a stable `NEOPRESS_MCP_OAUTH_CLIENT_SECRET` so
+  dynamically registered OAuth clients survive restarts and revisions.
+- Tool descriptors include required read/write/destructive/open-world
+  annotations and short invocation status metadata for ChatGPT-compatible hosts.
+- Remote OAuth metadata advertises refresh-token continuity through
+  `offline_access` and supports dynamic public client registration.
+- Claude Desktop MCPB staging is prepared through
+  `pnpm --filter @neopress/mcp mcpb:stage`.
+
+## Not Ready For Submission Yet
+
+- Verify final public MCP origin, CORS origins, and Cloud Run/service health.
+- Verify final privacy policy, terms, support, and security contact URLs.
+- Add production icon and screenshots for directories that request them.
+- Prepare review/test credentials in a non-production Neopress workspace.
+- Run real client scans in ChatGPT Developer Mode and Claude remote connector
+  settings after deployment.
+- Decide whether remote active site selection should stay in-memory or move to
+  a durable store. Until then, clients should pass `siteId` explicitly or call
+  `neopress_site_select` at the beginning of a session.
+
+## Official References Checked
+
+- OpenAI Apps SDK reference:
+  `https://developers.openai.com/apps-sdk/reference`
+- OpenAI Developer Mode / MCP apps:
+  `https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt`
+- OpenAI Codex MCP:
+  `https://developers.openai.com/codex/mcp`
+- Claude MCPB:
+  `https://claude.com/docs/connectors/building/mcpb`
+- Claude Code MCP:
+  `https://docs.anthropic.com/en/docs/claude-code/mcp`
+- Claude remote custom integrations:
+  `https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-integrations-using-remote-mcp`

package/integrations/chatgpt/app-draft.md

@@ -0,0 +1,96 @@
+# ChatGPT MCP App Draft
+
+Submission state: draft only. This is prepared for Developer Mode testing and
+workspace review, not public submission.
+
+## App Metadata
+
+| Field | Draft value |
+| --- | --- |
+| App name | Neopress |
+| Developer / publisher | Neopress |
+| Category | Productivity / Websites / CMS |
+| MCP endpoint | `https://mcp.neopress.ai/mcp` |
+| Authentication | OAuth |
+| Website | `https://app.neopress.ai` |
+| Privacy policy | TODO |
+| Terms | TODO |
+| Support | TODO |
+
+## Short Description
+
+Create and publish Neopress websites from ChatGPT through OAuth-authenticated
+MCP tools.
+
+## Long Description
+
+Neopress lets teams create production websites with AI while keeping strict
+contracts for layout TSX, page TSX, collections, entries, references, forms,
+draft/prod state, edit history, cache invalidation, and publishing. The
+Neopress MCP app gives ChatGPT a safe first-party tool surface for managing
+that workflow without public API keys.
+
+Users authenticate with Neopress OAuth. ChatGPT can list and select sites, read
+the runtime contract, create and update pages, collections, entries, references,
+forms, and assets, then publish entries and sites after explicit confirmation.
+
+## OAuth Configuration
+
+- Authorization server: `https://mcp.neopress.ai`
+- Protected resource: `https://mcp.neopress.ai/mcp`
+- Authorization endpoint: `https://mcp.neopress.ai/oauth/authorize`
+- Token endpoint: `https://mcp.neopress.ai/oauth/token`
+- Dynamic registration endpoint: `https://mcp.neopress.ai/oauth/register`
+- Scopes: `neopress:read`, `neopress:write`, `offline_access`
+- PKCE: required, S256 only
+- Token endpoint auth method: `none`
+- Refresh grant: supported
+
+## Tool Categories
+
+- Sites: list, select, get, create, update.
+- Layout: get/update draft layout, global CSS, and 404.
+- Pages: list, get, create, update, compile, delete.
+- Collections: list, get, create, update schema, delete.
+- Entries: list, get, create, update, publish, unpublish, delete, versions.
+- References: list, create, delete entry reference edges.
+- Forms: list, get, create, update, publish, delete, responses.
+- Assets: list, get, register public URL, delete.
+- Publish: preview and publish site draft state.
+
+## Safety And Constraints
+
+- No public API keys. The API boundary is first-party OAuth only.
+- The remote MCP server cannot upload files from the user's local filesystem.
+- Generated pages cannot use visitor login, accounts, carts, checkout,
+  payments, subscriptions, or order management.
+- Generated TSX must stay within Neopress allowed packages and runtime props.
+- Dynamic pages must use numeric `collectionId` and `draftMeta.queryConfig`.
+- Entry data keys must match collection schema field IDs.
+- References must be stored through `entry_references`, then the source entry
+  must be republished.
+- Forms must use `NeopressForm` and `formClient`; no manual `fetch`/`FormData`
+  submissions from generated pages.
+- Publishing and destructive tools are annotated so ChatGPT can request user
+  confirmation.
+
+## Developer Mode Test Plan
+
+1. Add the MCP endpoint and choose OAuth.
+2. Scan tools and complete OAuth.
+3. Confirm read tools scan with read-only annotations.
+4. Confirm write tools show confirmation prompts where expected.
+5. Run the runtime contract prompt before generating any TSX.
+6. Create a test site, layout, collection, entry, dynamic page, form page, and
+   asset registration.
+7. Publish entry, form, and site.
+8. Fetch the live page URLs outside ChatGPT and confirm 200 responses.
+9. Reopen the app after token expiry and confirm refresh-token continuity.
+
+## Submission Blockers
+
+- Deploy and verify `https://mcp.neopress.ai/mcp`.
+- Fill legal/support URLs.
+- Add a production icon and screenshots if requested by the review flow.
+- Prepare review credentials and a throwaway Neopress workspace.
+- Run the full Developer Mode scan once against the production endpoint.

package/integrations/claude-code/setup.md

@@ -0,0 +1,32 @@
+# Claude Code Setup Draft
+
+Use local stdio for development or private workstations:
+
+```bash
+claude mcp add neopress --transport stdio -- neopress-mcp
+```
+
+The local server reuses the CLI OAuth session from `neopress login`, or an
+injected `NEOPRESS_ACCESS_TOKEN`.
+
+Use remote Streamable HTTP after `https://mcp.neopress.ai/mcp` is deployed:
+
+```bash
+claude mcp add neopress --transport http https://mcp.neopress.ai/mcp
+```
+
+Then run `/mcp` inside Claude Code and complete the OAuth flow.
+
+## Smoke Prompts
+
+- "List my Neopress sites and select site 725."
+- "Read the Neopress runtime contract before making any page changes."
+- "Preview pending publish changes for the active site."
+- "Create a draft test page, compile it, publish the site, and give me the live URL."
+
+## Notes
+
+- Do not expose public API keys. Neopress MCP uses first-party OAuth sessions.
+- For remote MCP, local file upload is intentionally disabled. Use
+  `neopress_asset_register` with a public URL, or local stdio MCP for file
+  uploads from the workstation.

package/integrations/claude-desktop/manifest.json

@@ -0,0 +1,100 @@
+{
+  "manifest_version": "0.3",
+  "name": "neopress",
+  "display_name": "Neopress",
+  "version": "0.1.0",
+  "description": "Manage Neopress sites through a local MCP bridge that uses your Neopress OAuth session.",
+  "long_description": "Create and update Neopress sites, layout drafts, pages, collections, entries, forms, assets, and publish flows from Claude Desktop. This local MCPB bundle reuses the OAuth session created by the Neopress CLI and does not use API keys. Run `neopress login` before installing, or provide a short-lived OAuth access token for testing.",
+  "author": {
+    "name": "Neopress",
+    "url": "https://app.neopress.ai"
+  },
+  "homepage": "https://app.neopress.ai",
+  "documentation": "https://app.neopress.ai",
+  "server": {
+    "type": "node",
+    "entry_point": "server/bin.cjs",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/server/bin.cjs"],
+      "env": {
+        "NEOPRESS_BASE_URL": "${user_config.base_url}",
+        "NEOPRESS_SITE_ID": "${user_config.site_id}",
+        "NEOPRESS_ACCESS_TOKEN": "${user_config.oauth_access_token}"
+      }
+    }
+  },
+  "tools": [
+    {
+      "name": "neopress_get_runtime_contract",
+      "description": "Read the required Neopress runtime contract before generating TSX, schemas, dynamic pages, references, forms, or publish flows."
+    },
+    {
+      "name": "neopress_sites_list",
+      "description": "List sites accessible to the current OAuth user."
+    },
+    {
+      "name": "neopress_site_select",
+      "description": "Verify access to a site and store it as the active site."
+    },
+    {
+      "name": "neopress_layout_update",
+      "description": "Update draft layout TSX, global CSS, or 404 TSX."
+    },
+    {
+      "name": "neopress_page_create",
+      "description": "Create a static or dynamic page draft."
+    },
+    {
+      "name": "neopress_collection_create",
+      "description": "Create a collection with a draft schema."
+    },
+    {
+      "name": "neopress_entry_create",
+      "description": "Create a draft entry whose data matches the collection schema."
+    },
+    {
+      "name": "neopress_form_create",
+      "description": "Create a dashboard-managed form."
+    },
+    {
+      "name": "neopress_asset_upload_file",
+      "description": "Upload a local file through a presigned Neopress asset URL."
+    },
+    {
+      "name": "neopress_publish_site",
+      "description": "Publish layout, pages, collections, and forms from draft to production."
+    }
+  ],
+  "tools_generated": true,
+  "keywords": ["neopress", "website", "cms", "publishing", "mcp"],
+  "compatibility": {
+    "claude_desktop": ">=1.0.0",
+    "platforms": ["darwin", "win32"],
+    "runtimes": {
+      "node": ">=18.0.0"
+    }
+  },
+  "user_config": {
+    "base_url": {
+      "type": "string",
+      "title": "Neopress base URL",
+      "description": "Neopress app/API origin.",
+      "default": "https://app.neopress.ai",
+      "required": true
+    },
+    "site_id": {
+      "type": "string",
+      "title": "Default site ID",
+      "description": "Optional numeric site ID. Leave blank and select a site with the MCP tool if unsure.",
+      "required": false
+    },
+    "oauth_access_token": {
+      "type": "string",
+      "title": "OAuth access token",
+      "description": "Optional short-lived OAuth access token for testing. Prefer `neopress login` so the MCP server can refresh the session.",
+      "sensitive": true,
+      "required": false
+    }
+  }
+}

package/integrations/claude-remote/connector-draft.md

@@ -0,0 +1,73 @@
+# Claude Remote Connector Draft
+
+Submission state: draft only. Do not submit until the production MCP URL,
+privacy/support URLs, and test workspace are finalized.
+
+## Listing Metadata
+
+| Field | Draft value |
+| --- | --- |
+| Connector name | Neopress |
+| Publisher | Neopress |
+| Category | Productivity / Websites / CMS |
+| Remote MCP URL | `https://mcp.neopress.ai/mcp` |
+| Website | `https://app.neopress.ai` |
+| Support URL | TODO |
+| Privacy policy URL | TODO |
+| Terms URL | TODO |
+
+## Short Description
+
+Build and operate Neopress websites from Claude using OAuth-authenticated MCP
+tools for sites, layouts, pages, collections, entries, forms, assets, and
+publishing.
+
+## Long Description
+
+Neopress is an AI-native website builder. The Neopress connector lets Claude
+manage a user's Neopress workspace through the same first-party API used by the
+CLI and dashboard. Claude can create and update layouts, page TSX, collection
+schemas, entries, references, dashboard-managed forms, assets, and publish
+flows while following the Neopress runtime contract.
+
+The connector does not expose public API keys. Users authenticate with
+Neopress OAuth. Authorization and tenant membership are enforced by the
+Neopress API on every request.
+
+## Authentication
+
+- Type: OAuth 2.1 compatible authorization code with PKCE.
+- Registration: dynamic public client registration at `/oauth/register`.
+- Authorization metadata: `/.well-known/oauth-authorization-server`.
+- Resource metadata: `/.well-known/oauth-protected-resource/mcp`.
+- Scopes: `neopress:read`, `neopress:write`, `offline_access`.
+- Refresh: supported by `/oauth/token` with `grant_type=refresh_token`.
+
+## Tool Safety Summary
+
+- Read-only tools list and inspect sites, layout, pages, collections, entries,
+  references, forms, assets, and publish previews.
+- Write tools mutate draft site state, schemas, entries, forms, or assets.
+- Publishing tools move content to production and should require explicit user
+  confirmation.
+- Delete and unpublish tools are marked destructive.
+- Remote MCP cannot read the user's local filesystem; local file upload is
+  disabled in the remote server.
+
+## Review Test Prompts
+
+1. "List my Neopress sites and select the test site."
+2. "Read the Neopress runtime contract."
+3. "Create a collection named Connector Articles with title, slug, summary, and body fields."
+4. "Create and publish one entry in that collection."
+5. "Create a dynamic page for the entry, compile it, publish the site, and show the live URL."
+6. "Create a simple dashboard-managed contact form, publish it, add it to a page, and publish the site."
+
+## Submission Blockers
+
+- Deploy remote MCP to a stable HTTPS origin.
+- Verify OAuth refresh behavior in Claude after a token expiry window.
+- Replace TODO legal/support URLs.
+- Prepare a non-production test site and test credentials for review.
+- Capture any required screenshots or screen recordings.
+- Decide whether to persist active site selection outside process memory.

package/integrations/codex/config.example.toml

@@ -0,0 +1,13 @@
+# Copy the relevant block into ~/.codex/config.toml or a project .codex/config.toml.
+
+# Local stdio MCP. Requires either `neopress login` or an injected
+# NEOPRESS_ACCESS_TOKEN OAuth access token.
+[mcp_servers.neopress]
+command = "neopress-mcp"
+env = { NEOPRESS_BASE_URL = "https://app.neopress.ai" }
+
+# Remote Streamable HTTP MCP. Use this after the hosted server is deployed.
+# Then authenticate with: codex mcp login neopress-remote
+#
+# [mcp_servers.neopress-remote]
+# url = "https://mcp.neopress.ai/mcp"

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@neopress/mcp",
+  "version": "0.1.0",
+  "description": "Neopress MCP server for first-party AI agents",
+  "type": "module",
+  "bin": {
+    "neopress-mcp": "./dist/bin.cjs",
+    "neopress-mcp-http": "./dist/http-bin.cjs"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "integrations",
+    "scripts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "zod": "^4.1.12"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.5",
+    "@neopress/sdk": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "mcpb:stage": "node ./scripts/prepare-mcpb-package.mjs",
+    "start:http": "node ./dist/http-bin.cjs",
+    "lint": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}

package/scripts/deploy-cloud-run.sh

@@ -0,0 +1,183 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(cd "${SCRIPT_DIR}/../../.." && pwd)"
+
+PROJECT_ID="${PROJECT_ID:-inblog-ver-2}"
+REGION="${REGION:-us-west1}"
+REPOSITORY="${REPOSITORY:-neopress}"
+SERVICE="${SERVICE:-neopress-mcp-server}"
+IMAGE="${IMAGE:-${REGION}-docker.pkg.dev/${PROJECT_ID}/${REPOSITORY}/${SERVICE}:latest}"
+BUILD_STRATEGY="${BUILD_STRATEGY:-cloud-build}"
+CLOUD_BUILD_TIMEOUT="${CLOUD_BUILD_TIMEOUT:-30m}"
+PUBLIC_URL="${NEOPRESS_MCP_PUBLIC_URL:-}"
+BASE_URL="${NEOPRESS_BASE_URL:-https://app.neopress.ai}"
+AUTH_MODE="${NEOPRESS_MCP_AUTH_MODE:-oauth}"
+CORS_ORIGINS="${NEOPRESS_MCP_CORS_ORIGINS:-}"
+OAUTH_PROVIDER="${NEOPRESS_MCP_OAUTH_PROVIDER:-google}"
+
+require_command() {
+  if ! command -v "$1" >/dev/null 2>&1; then
+    echo "Missing required command: $1" >&2
+    exit 1
+  fi
+}
+
+ensure_gcp_services_enabled() {
+  require_command gcloud
+
+  local services=(
+    artifactregistry.googleapis.com
+    cloudbuild.googleapis.com
+    run.googleapis.com
+  )
+
+  echo "Ensuring required GCP APIs are enabled"
+  gcloud services enable "${services[@]}" --project "${PROJECT_ID}"
+
+  for service in "${services[@]}"; do
+    until gcloud services list \
+      --enabled \
+      --project "${PROJECT_ID}" \
+      --filter="config.name:${service}" \
+      --format="value(config.name)" | grep -qx "${service}"; do
+      echo "Waiting for ${service} to become available..."
+      sleep 2
+    done
+  done
+}
+
+build_with_cloud_build() {
+  require_command gcloud
+  ensure_gcp_services_enabled
+
+  local config_file
+  config_file="$(mktemp "${TMPDIR:-/tmp}/neopress-mcp-cloudbuild.XXXXXX.yaml")"
+  trap "rm -f '${config_file}'" EXIT
+
+  cat >"${config_file}" <<EOF
+steps:
+  - name: gcr.io/cloud-builders/docker
+    env:
+      - DOCKER_BUILDKIT=1
+    args:
+      - build
+      - --platform
+      - linux/amd64
+      - -f
+      - packages/mcp/Dockerfile
+      - -t
+      - ${IMAGE}
+      - .
+
+images:
+  - ${IMAGE}
+EOF
+
+  echo "Building and pushing ${IMAGE} with Cloud Build"
+  gcloud builds submit . \
+    --project "${PROJECT_ID}" \
+    --config "${config_file}" \
+    --timeout "${CLOUD_BUILD_TIMEOUT}"
+}
+
+build_with_local_docker() {
+  require_command docker
+
+  echo "Building and pushing ${IMAGE} with local Docker"
+  docker buildx build \
+    --platform linux/amd64 \
+    --provenance=false \
+    --sbom=false \
+    -f packages/mcp/Dockerfile \
+    -t "${IMAGE}" \
+    --push \
+    .
+}
+
+cd "${ROOT_DIR}"
+
+case "${BUILD_STRATEGY}" in
+  cloud-build | cloudbuild)
+    build_with_cloud_build
+    ;;
+  docker | local-docker)
+    build_with_local_docker
+    ;;
+  *)
+    echo "Unknown BUILD_STRATEGY: ${BUILD_STRATEGY}" >&2
+    echo "Use BUILD_STRATEGY=cloud-build or BUILD_STRATEGY=docker." >&2
+    exit 1
+    ;;
+esac
+
+echo "Deploying ${SERVICE} to Cloud Run (${PROJECT_ID}/${REGION})"
+require_command gcloud
+service_exists=false
+if gcloud run services describe "${SERVICE}" \
+  --project "${PROJECT_ID}" \
+  --region "${REGION}" >/dev/null 2>&1; then
+  service_exists=true
+fi
+
+env_vars=(
+  "NODE_ENV=production"
+  "NEOPRESS_BASE_URL=${BASE_URL}"
+  "NEOPRESS_MCP_AUTH_MODE=${AUTH_MODE}"
+  "NEOPRESS_MCP_OAUTH_PROVIDER=${OAUTH_PROVIDER}"
+)
+
+if [[ -n "${NEOPRESS_MCP_OAUTH_CLIENT_SECRET:-}" ]]; then
+  env_vars+=("NEOPRESS_MCP_OAUTH_CLIENT_SECRET=${NEOPRESS_MCP_OAUTH_CLIENT_SECRET}")
+elif [[ "${service_exists}" == false ]]; then
+  echo "NEOPRESS_MCP_OAUTH_CLIENT_SECRET is required for first production remote MCP deploy." >&2
+  echo "Use a stable random value, for example: openssl rand -base64 32" >&2
+  exit 1
+fi
+
+if [[ -n "${PUBLIC_URL}" ]]; then
+  env_vars+=("NEOPRESS_MCP_PUBLIC_URL=${PUBLIC_URL}")
+fi
+
+if [[ -n "${CORS_ORIGINS}" ]]; then
+  env_vars+=("NEOPRESS_MCP_CORS_ORIGINS=${CORS_ORIGINS}")
+fi
+
+if [[ -n "${NEOPRESS_SUPABASE_URL:-}" ]]; then
+  env_vars+=("NEOPRESS_SUPABASE_URL=${NEOPRESS_SUPABASE_URL}")
+fi
+
+if [[ -n "${NEOPRESS_SUPABASE_ANON_KEY:-}" ]]; then
+  env_vars+=("NEOPRESS_SUPABASE_ANON_KEY=${NEOPRESS_SUPABASE_ANON_KEY}")
+fi
+
+env_arg="^~^$(IFS=~; echo "${env_vars[*]}")"
+
+if [[ "${service_exists}" == true ]]; then
+  gcloud run services update "${SERVICE}" \
+    --project "${PROJECT_ID}" \
+    --region "${REGION}" \
+    --image "${IMAGE}" \
+    --update-env-vars "${env_arg}"
+else
+  gcloud run deploy "${SERVICE}" \
+    --project "${PROJECT_ID}" \
+    --region "${REGION}" \
+    --image "${IMAGE}" \
+    --allow-unauthenticated \
+    --port 8080 \
+    --memory 512Mi \
+    --cpu 1 \
+    --min-instances 0 \
+    --max-instances 10 \
+    --set-env-vars "${env_arg}"
+fi
+
+echo "Latest ready revision:"
+gcloud run services describe "${SERVICE}" \
+  --project "${PROJECT_ID}" \
+  --region "${REGION}" \
+  --format="value(status.latestReadyRevisionName,status.url)"
+
+echo "Deployment complete"

package/scripts/prepare-mcpb-package.mjs

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import {
+  copyFileSync,
+  existsSync,
+  mkdirSync,
+  rmSync,
+  writeFileSync,
+} from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const distBin = resolve(packageRoot, 'dist/bin.cjs');
+const manifest = resolve(packageRoot, 'integrations/claude-desktop/manifest.json');
+const outDir = resolve(packageRoot, 'dist/mcpb/neopress');
+const outServerDir = resolve(outDir, 'server');
+
+if (!existsSync(distBin)) {
+  console.error('Missing dist/bin.cjs. Run `pnpm --filter @neopress/mcp build` first.');
+  process.exit(1);
+}
+
+if (!existsSync(manifest)) {
+  console.error('Missing Claude Desktop MCPB manifest.');
+  process.exit(1);
+}
+
+rmSync(outDir, { recursive: true, force: true });
+mkdirSync(outServerDir, { recursive: true });
+
+copyFileSync(manifest, resolve(outDir, 'manifest.json'));
+copyFileSync(distBin, resolve(outServerDir, 'bin.cjs'));
+writeFileSync(
+  resolve(outDir, 'README.md'),
+  [
+    '# Neopress MCPB Draft',
+    '',
+    'This bundle stages the local Neopress stdio MCP server for Claude Desktop.',
+    '',
+    'Before installing, run `neopress login` so the MCP server can reuse and refresh',
+    'the first-party OAuth session. Alternatively, configure a short-lived OAuth',
+    'access token in the extension settings for testing only.',
+    '',
+    'To pack this directory:',
+    '',
+    '```bash',
+    'pnpm dlx @anthropic-ai/mcpb pack packages/mcp/dist/mcpb/neopress',
+    '```',
+    '',
+  ].join('\n'),
+  'utf-8'
+);
+
+console.log(`Staged MCPB directory: ${outDir}`);
+console.log(`Pack with: pnpm dlx @anthropic-ai/mcpb pack ${outDir}`);