FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

TypeScript SDK — Tier 1 Assessment · Issue #2271 · modelcontextprotocol/modelcontextprotocol · GitHub

TypeScript SDK — Tier 1 Assessment #2271

Description

TypeScript SDK — Tier 1 Assessment

SDK: modelcontextprotocol/typescript-sdk
Version: 1.27.0 (branch: v1.x)
Assessed: 2026-02-18
Requested tier: Tier 1
Tool: @modelcontextprotocol/conformance tier-check

Result

All Tier 1 requirements are met.

# Requirement Tier 1 Standard Value Status
1 Server Conformance 100% pass rate 30/30 (100%)
2 Client Conformance 100% pass rate 20/20 (100%)
3 Issue Triage Within 2 business days 97.4% (187/192)
4 P0 Resolution Within 7 days 0 open
5 Stable Release Required + clear versioning 1.27.0
6 Spec Tracking Before spec release Same-day (evidence)
7 Documentation Comprehensive w/ examples 48/48 features
8 Dependency Policy Published update policy DEPENDENCY_POLICY.md
9 Roadmap Published roadmap ROADMAP.md
10 Versioning Policy Documented breaking changes VERSIONING.md

Requirements Detail

1. Server Conformance — ✅ 30/30 (100%)

Tested against spec versions 2025-06-18 and 2025-11-25 using the conformance test suite. CI runs continuously via the conformance workflow.

Evidence: Full assessment report · CLI output · How to run it yourself

All 30 server scenarios
Scenario Status Checks Spec Versions
server-tools-list PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-simple-text PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-image PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-audio PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-embedded-resource PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-mixed-content PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-error PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-with-logging PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-with-progress PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-sampling PASS 1/1 2025-06-18, 2025-11-25
server-tools-call-elicitation PASS 1/1 2025-06-18, 2025-11-25
server-server-initialize PASS 1/1 2025-06-18, 2025-11-25
server-server-sse-multiple-streams PASS 2/2 2025-11-25
server-resources-list PASS 1/1 2025-06-18, 2025-11-25
server-resources-read-text PASS 1/1 2025-06-18, 2025-11-25
server-resources-read-binary PASS 1/1 2025-06-18, 2025-11-25
server-resources-templates-read PASS 1/1 2025-06-18, 2025-11-25
server-resources-subscribe PASS 1/1 2025-06-18, 2025-11-25
server-resources-unsubscribe PASS 1/1 2025-06-18, 2025-11-25
server-prompts-list PASS 1/1 2025-06-18, 2025-11-25
server-prompts-get-simple PASS 1/1 2025-06-18, 2025-11-25
server-prompts-get-with-args PASS 1/1 2025-06-18, 2025-11-25
server-prompts-get-embedded-resource PASS 1/1 2025-06-18, 2025-11-25
server-prompts-get-with-image PASS 1/1 2025-06-18, 2025-11-25
server-ping PASS 1/1 2025-06-18, 2025-11-25
server-logging-set-level PASS 1/1 2025-06-18, 2025-11-25
server-completion-complete PASS 1/1 2025-06-18, 2025-11-25
server-elicitation-sep1034-defaults PASS 5/5 2025-11-25
server-elicitation-sep1330-enums PASS 5/5 2025-11-25
server-dns-rebinding-protection PASS 2/2 2025-11-25

2. Client Conformance — ✅ 20/20 (100%)

Core: 4/4, Auth: 16/16 scored. One informational extension scenario fails (auth/cross-app-access-complete-flow) — not scored for tier per conformance testing rules.

Evidence: Full assessment report · CLI output · How to run it yourself

All 24 client scenarios (20 scored + 4 informational)
Scenario Status Checks Spec Versions Notes
initialize PASS 1/1 2025-06-18, 2025-11-25
tools_call PASS 1/1 2025-06-18, 2025-11-25
sse-retry PASS 3/3 2025-11-25
elicitation-sep1034-client-defaults PASS 5/5 2025-11-25
auth/basic-cimd PASS 15/15 2025-11-25
auth/pre-registration PASS 15/15 2025-11-25
auth/metadata-default PASS 15/15 2025-11-25
auth/metadata-var1 PASS 15/15 2025-11-25
auth/metadata-var2 PASS 15/15 2025-11-25
auth/metadata-var3 PASS 15/15 2025-11-25
auth/token-endpoint-auth-post PASS 20/20 2025-06-18, 2025-11-25
auth/token-endpoint-auth-basic PASS 20/20 2025-06-18, 2025-11-25
auth/token-endpoint-auth-none PASS 20/20 2025-06-18, 2025-11-25
auth/scope-from-scopes-supported PASS 16/16 2025-11-25
auth/scope-from-www-authenticate PASS 16/16 2025-11-25
auth/scope-omitted-when-undefined PASS 16/16 2025-11-25
auth/scope-step-up PASS 26/26 2025-11-25
auth/scope-retry-limit PASS 12/12 2025-11-25
auth/2025-03-26-oauth-metadata-backcompat PASS 13/13 2025-03-26
auth/2025-03-26-oauth-endpoint-fallback PASS 7/7 2025-03-26
auth/resource-mismatch PASS 1/1 draft Informational
auth/client-credentials-basic PASS 7/7 extension Informational
auth/client-credentials-jwt PASS 7/7 extension Informational
auth/cross-app-access-complete-flow FAIL 0/2 extension Informational — not scored

3. Issue Triage — ✅ 97.4% (187/192)

187 of 192 issues triaged within 2 business days. All 12 required labels are present.

Evidence: Open issues without any triage label

4. P0 Resolution — ✅ 0 open

No open P0 issues. Previously mislabeled P0s (v2 roadmap items) have been re-triaged.

Evidence: Open P0 issues (should show 0 results)

5. Stable Release — ✅ 1.27.0

Published on npm and GitHub Releases. Breaking change policy documented in VERSIONING.md — SemVer 2.0.0 with 7 explicit breaking change categories.

6. Spec Tracking — ✅ Same-day

SDK v1.23.0 released 2025-11-25 21:14 UTC, same day as the spec 2025-11-25 tag (21:14 UTC). Automated spec type tracking via the update-spec-types workflow (runs nightly).

7. Documentation — ✅ 48/48 features

All 48 non-experimental MCP features documented with code examples across docs/:

Full feature coverage table (48/48)
# Feature Location Examples
1 Tools - listing docs/server.md 2
2 Tools - calling docs/server.md 2
3 Tools - text results docs/server.md 1
4 Tools - image results docs/server.md 1
5 Tools - audio results docs/server.md 1
6 Tools - embedded resources docs/server.md 1
7 Tools - error handling docs/server.md 1
8 Tools - change notifications docs/server.md 1
9 Resources - listing docs/server.md 1
10 Resources - reading text docs/server.md 1
11 Resources - reading binary docs/server.md 1
12 Resources - templates docs/server.md 1
13 Resources - template reading docs/server.md 1
14 Resources - subscribing docs/server.md 1
15 Resources - unsubscribing docs/server.md 1
16 Resources - change notifications docs/server.md 1
17 Prompts - listing docs/server.md 1
18 Prompts - getting simple docs/server.md 1
19 Prompts - getting with arguments docs/server.md 1
20 Prompts - embedded resources docs/server.md 1
21 Prompts - image content docs/server.md 1
22 Prompts - change notifications docs/server.md 1
23 Sampling - creating messages docs/capabilities.md 1
24 Elicitation - form mode docs/capabilities.md 2
25 Elicitation - URL mode docs/capabilities.md 2
26 Elicitation - schema validation docs/capabilities.md 1
27 Elicitation - default values docs/capabilities.md 1
28 Elicitation - enum values docs/capabilities.md 1
29 Elicitation - complete notification docs/capabilities.md 1
30 Roots - listing docs/client.md 1
31 Roots - change notifications docs/client.md 1
32 Logging - sending log messages docs/server.md 1
33 Logging - setting level docs/server.md 1
34 Completions - resource argument docs/server.md 1
35 Completions - prompt argument docs/server.md 2
36 Ping docs/protocol.md 1
37 Streamable HTTP transport (client) docs/client.md 2
38 Streamable HTTP transport (server) docs/server.md 3
39 SSE transport - legacy (client) docs/client.md 1
40 SSE transport - legacy (server) docs/server.md 2
41 stdio transport (client) docs/client.md 1
42 stdio transport (server) docs/server.md 1
43 Progress notifications docs/protocol.md 2
44 Cancellation docs/protocol.md 2
45 Pagination docs/protocol.md 1
46 Capability negotiation docs/protocol.md 2
47 Protocol version negotiation docs/protocol.md 1
48 JSON Schema 2020-12 support docs/protocol.md 2

8. Dependency Policy — ✅

DEPENDENCY_POLICY.md — Conservative update philosophy: dependencies updated only for security vulnerabilities, bugs, or needed features. GitHub security alerts enabled. Dependabot configured for monthly GitHub Actions updates.

9. Roadmap — ✅

ROADMAP.md — Spec implementation tracked via per-revision GitHub Project boards. v2 SDK milestones: Alpha ~mid-March 2026, Beta ~May 2026, aligned with next spec release.

10. Versioning Policy — ✅

VERSIONING.md — SemVer 2.0.0 adherence. Enumerates 7 breaking change categories and 7 non-breaking categories. Four communication mechanisms: release notes, @deprecated annotations, migration guides, PR labels.


Raw Assessment Output


Reproduce This Assessment

Step-by-step instructions

Prerequisites

  • Node.js >= 20
  • GitHub CLI (gh) authenticated (gh auth login)
  • Git

Quick check (repository health only, ~30 seconds)

git clone https://github.com/modelcontextprotocol/conformance.git
cd conformance
npm install
npm run build
npm run --silent tier-check -- --repo modelcontextprotocol/typescript-sdk --branch v1.x --skip-conformance

Full check (with conformance tests, ~5 minutes)

# Terminal 1: Clone and start the SDK's conformance server
git clone https://github.com/modelcontextprotocol/typescript-sdk.git
cd typescript-sdk
git checkout v1.x
npm install
npm run build
npm run test:conformance:server:run
# Server starts on http://localhost:3000/mcp

# Terminal 2: Run the full tier-check
cd conformance
npm run --silent tier-check -- \
  --repo modelcontextprotocol/typescript-sdk \
  --branch v1.x \
  --conformance-server-url http://localhost:3000/mcp \
  --client-cmd 'npx tsx ../typescript-sdk/test/conformance/src/everythingClient.ts'

Output formats

# Terminal output (default)
npm run --silent tier-check -- --repo modelcontextprotocol/typescript-sdk --skip-conformance

# Markdown report
npm run --silent tier-check -- --repo modelcontextprotocol/typescript-sdk --skip-conformance --output markdown

# Machine-readable JSON
npm run --silent tier-check -- --repo modelcontextprotocol/typescript-sdk --skip-conformance --output json

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions


    Back | FazBrowse Home | New Git URL