Skip to content

docs: restore SECURITY.md, lost in the v2 tree swap - #1843

Merged
cliffhall merged 1 commit into
mainfrom
docs/restore-security-md
Jul 28, 2026
Merged

docs: restore SECURITY.md, lost in the v2 tree swap#1843
cliffhall merged 1 commit into
mainfrom
docs/restore-security-md

Conversation

@cliffhall

Copy link
Copy Markdown
Member

Part of #1820.

The regression

SECURITY.md exists on the pre-swap main (ac3c1a12) and on v1/main — but the v2 tree never had one, so #1817 silently removed the security policy from the default branch.

I found this while checking #1820's prerequisites, not from any alert. Nothing flagged it.

Why it matters right now

It is where private vulnerability reporting is advertised, and it vanished in the same window as 2.0.0 shipping and external pull requests being switched off.

Losing the PR path and the security-report path together would leave an outside reporter with no documented route at all — exactly the wrong gap for a tool that connects to arbitrary MCP servers.

What's restored, plus what #1820 asked for

Base content restored from v1/main, with three additions:

Supported-versions table covering all four package names:

Version Package Support
2.x @modelcontextprotocol/inspector ✅ Actively supported
1.x @modelcontextprotocol/inspector ⚠️ Security fixes only, under v1-latest
1.x -client / -server / -cli ⚠️ Security fixes only
< 1.0.0 any ❌ Unsupported

The three sub-packages are named explicitly because they exist only on the v1 line and are deprecated — v2 ships a single package, so someone reading "is my version supported?" needs them listed.

A carve-out for security reports. The doc now states that the repo does not accept outside pull requests, and that this does not apply to security reports. Without it, the new issues-only policy reads as "no way to reach us".

"Whether it affects v2, v1, or both" added to the report checklist, now that two lines are live.

Verified

Private vulnerability reporting is enabled on the repo (GET /repos/.../private-vulnerability-reporting{"enabled": true}), so the advisory link is a working route rather than an aspiration.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Txmv2qqv3yeKgRzoqXytzD

`SECURITY.md` existed on the pre-swap `main` (ac3c1a1) and still exists on
`v1/main`, but the v2 tree never had one — so #1817 silently removed the
security policy from the default branch.

That is the wrong file to be missing right now: it is where private
vulnerability reporting is advertised, and it disappeared in the same window as
2.0.0 shipping and external pull requests being turned off (#1820). Losing the
PR path and the security-report path together would leave an outside reporter
with no documented route at all.

Restored from `v1/main` with the additions #1820 asks for:

- A supported-versions table covering all four package names — v2 supported, the
  v1 line security-fixes-only under the `v1-latest` dist-tag, anything below
  1.0.0 unsupported. The three sub-packages are named explicitly since they
  exist only on v1 and are deprecated.
- A note that the repository does not accept outside pull requests, but that
  this explicitly does NOT apply to security reports, which must go through the
  advisory process rather than any public channel. Without that, the new
  issues-only policy reads as "no way to reach us".
- "Whether it affects v2, v1, or both" added to the report checklist, now that
  two lines are live.

Verified private vulnerability reporting is enabled on the repo, so the advisory
link is a working route rather than an aspiration.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Txmv2qqv3yeKgRzoqXytzD
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

v2 Issues and PRs for v2

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant