Skip to content

docs(mcp-server): pin npm version, remove -y flag — SAFE-MCP NEW-003 - #18

Merged
HongmingWang-Rabbit merged 1 commit into
mainfrom
docs/mcp-server-security-808
Apr 19, 2026
Merged

docs(mcp-server): pin npm version, remove -y flag — SAFE-MCP NEW-003#18
HongmingWang-Rabbit merged 1 commit into
mainfrom
docs/mcp-server-security-808

Conversation

@molecule-ai

@molecule-ai molecule-ai Bot commented Apr 17, 2026

Copy link
Copy Markdown
Contributor

Summary

Fixes the MCP server quickstart docs to reflect the pinned-version security recommendation from the SAFE-MCP audit (PR #808, finding NEW-003 HIGH).

Changes to content/docs/mcp-server.mdx

  • Quick start install: npx @molecule-ai/mcp-servernpx @molecule-ai/mcp-server@1.0.0
  • .mcp.json configure example: ["-y", "@molecule-ai/mcp-server"]["@molecule-ai/mcp-server@1.0.0"] — removes the -y auto-accept flag and pins to the current stable release
  • <Callout type="warn"> added immediately after the configure example explaining:
    • Unpinned + -y = silent arbitrary code execution risk on package compromise
    • Always specify an exact version
    • Link to npm page to check for latest stable before upgrading
  • Troubleshooting: standalone run example also updated to @1.0.0

Security context

SAFE-MCP finding NEW-003 (HIGH severity): both @molecule-ai/mcp-server and related packages ran via npx -y with no version pin. If either package were compromised on npm, the next MCP client restart would silently execute the attacker's code with full MCP permissions.

This is a low-effort, high-value fix: just pin the version and drop -y.

Pairs with

Monorepo PR #808 — docs(security): SAFE-MCP audit report 2026-04-17 (closes #747). The full audit report is internal; this PR captures the single actionable change for public MCP users.

Test plan

  • .mcp.json example no longer contains -y
  • Version @1.0.0 appears in all three code blocks (install, configure, troubleshooting)
  • <Callout type="warn"> renders correctly
  • Link to npmjs.com is correct (https://www.npmjs.com/package/@molecule-ai/mcp-server)

🤖 Generated with Claude Code

…EW-003)

- Quick start install example: add @1.0.0 version pin
- .mcp.json Configure example: pin to @1.0.0, remove -y auto-accept flag
- Add Callout warning explaining why pinning is required (unpinned + -y =
  arbitrary code execution on package compromise) with link to npm page
- Troubleshooting: update standalone run example to use pinned version

Addresses SAFE-MCP finding NEW-003 (HIGH) from SAFE-MCP audit (PR #808).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vercel

vercel Bot commented Apr 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 17, 2026 7:02pm

Request Review

@HongmingWang-Rabbit
HongmingWang-Rabbit merged commit 28783fe into main Apr 19, 2026
2 checks passed
@HongmingWang-Rabbit
HongmingWang-Rabbit deleted the docs/mcp-server-security-808 branch April 19, 2026 07:52
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.

1 participant