modelcontextprotocol/typescript-sdk

Vedi su GitHub

The official TypeScript SDK for Model Context Protocol servers and clients

Stelle: 13.4k
Fork: 2.2k
Issue aperte per principianti: 25
Issue indicizzate: 300
Merge medio: 3g 15h
PR unite (30g): 4

Lingua principale: TypeScript
Licenza: Nessun dato sulla licenza
Ultimo push su GitHub: 16/9/2026
Ultima indicizzazione: 20/9/2026
Guida per i contributori: Guida per i contributori
Codice di condotta: Codice di condotta
Label per principianti: good first issue help wanted

Adatte ai principianti Tutto

Aperta Tutte

49 issue adatte ai principianti aperte

Auth metadata discovery: fallback URL built on resource host instead of authorization-server host Aperta

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#2784 · Aperta il 10/9/2026
Auth metadata discovery: fallback only triggers on 404, misses 401/403 Aperta

Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100

modelcontextprotocol/typescript-sdk#2783 · 1 commento · Aperta il 10/9/2026
authorizationHandler drops the OAuth state parameter on error redirects Aperta

Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100

modelcontextprotocol/typescript-sdk#2773 · Aperta il 9/9/2026
Doc comments misattribute the token-endpoint TLS check to SEP-2207 (which is OIDC refresh / `offline_access`) Aperta

Difficoltà 1/5 Meno di un'ora Idoneità per principianti 92/100

modelcontextprotocol/typescript-sdk#2766 · 1 commento · Aperta il 7/9/2026
Server auth defaults silently produce RFC 9728-noncompliant discovery when the MCP endpoint has a path Aperta

Difficoltà 2/5 1-2 giorni Idoneità per principianti 72/100

modelcontextprotocol/typescript-sdk#2751 · Aperta il 3/9/2026
experimental.tasks.getTaskResult() throws TypeError: Cannot read properties of undefined (reading '_zod') when the optional result schema is omitted Aperta

Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100

modelcontextprotocol/typescript-sdk#2742 · 2 commenti · Aperta il 31/8/2026
UriTemplate.match() does not percent-decode extracted values Aperta

Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100

modelcontextprotocol/typescript-sdk#2728 · 4 commenti · Aperta il 27/8/2026
outputSchema always emitted as JSON Schema draft-07, breaking clients that only accept 2020-12 Aperta

Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100

modelcontextprotocol/typescript-sdk#2721 · 4 commenti · 2 reazioni · Aperta il 26/8/2026
Docs: registerClient's @deprecated notice cites SEP-2577; DCR deprecation is PR #2858 (SEP-2577 is Roots/Sampling/Logging) Aperta

Difficoltà 1/5 Meno di un'ora Idoneità per principianti 85/100

modelcontextprotocol/typescript-sdk#2719 · Aperta il 26/8/2026
Deno: TS2307 on all .js subpath imports — './*' exports map types to '*.js.d.ts' Aperta

v1

Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100

modelcontextprotocol/typescript-sdk#2701 · 2 commenti · Aperta il 22/8/2026
Streamable HTTP SSE tests assume multiple events share one fetch chunk Aperta

bug good first issue P3 v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2661 · 2 commenti · Aperta il 14/8/2026
[v2] subscriptions/listen holds a stream open even when it has honoured nothing Aperta

bug P1 ready for work spec-2026-07-28 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2650 · 2 commenti · Aperta il 12/8/2026
[v2] Legacy-era cancel of a resumed request: notifications/cancelled inherits the request's resumptionToken, so the transport swallows the cancellation and opens a rogue resumed GET Aperta

v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100

modelcontextprotocol/typescript-sdk#2646 · 1 commento · Aperta il 11/8/2026
Docs: passing z.object() as inputSchema on v1 fails silently (empty schema) or cryptically (tools/list crash) — not covered in troubleshooting or migration guide Aperta

documentation enhancement good first issue P3 v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 85/100

modelcontextprotocol/typescript-sdk#2627 · 4 commenti · Aperta il 9/8/2026
Client.listTools() corrupts its cached tool metadata when an output schema fails to compile Aperta

bug P3 ready for work v1

Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100

modelcontextprotocol/typescript-sdk#2614 · 1 commento · Aperta il 4/8/2026
Client.callTool() throws -32602 after tools/list_changed replaces an in-flight call's output schema Aperta

bug P2 ready for work v1

Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100

modelcontextprotocol/typescript-sdk#2612 · 1 commento · Aperta il 4/8/2026
OAuth: isLoopbackHost rejects *.localhost subdomains, breaking host-based local dev (InsecureTokenEndpointError) Aperta

spec-2026-07-28 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2591 · 4 commenti · 4 reazioni · Aperta il 31/7/2026
`_onprogress` raises a protocol error for a race servers cannot avoid (progress notification arriving with the response) Aperta

bug P2 ready for work v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100

modelcontextprotocol/typescript-sdk#2580 · 4 commenti · Aperta il 30/7/2026
normalizeHeaders references the bare global `HeadersInit`, breaking Node-only consumers with skipLibCheck: false Aperta

bug P2 ready for work v1

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2568 · 1 commento · Aperta il 28/7/2026
InMemoryEventStore: standalone-stream resume broken by getStreamIdFromEventId split Aperta

bug P2 ready for work v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#2560 · 1 commento · Aperta il 27/7/2026
Widen @hono/node-server range to ^1.19.9 || ^2 so GHSA-frvp-7c67-39w9 is reachable (npm suggests a breaking downgrade) Aperta

bug P2 ready for work v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#2548 · 3 commenti · Aperta il 24/7/2026
[v2] MRTR wipe-cache example reads unvalidated elicitation content and defaults malformed scope to all Aperta

spec-2026-07-28 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2542 · 3 commenti · Aperta il 24/7/2026
stdio.ts/ReadBuffer retains consumed input and copies the next stdio chunk Aperta

bug P3 ready for work v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2536 · 1 commento · Aperta il 23/7/2026
Bug: Resumption token dropped when a resumed SSE stream disconnects before any id-bearing event Aperta

bug P2 ready for work v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100

modelcontextprotocol/typescript-sdk#2499 · 1 commento · Aperta il 14/7/2026
[v2] Origin and Host validators accept userinfo before allowlisted hostnames Aperta

v1 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100

modelcontextprotocol/typescript-sdk#2489 · 1 commento · Aperta il 14/7/2026
Tool inputSchema generation emits $ref for reused Zod instances · breaks strict MCP clients (kimi) Aperta

bug

Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100

modelcontextprotocol/typescript-sdk#2100 · 3 commenti · Aperta il 15/5/2026
[SEP-1613 regression] tools/list still emits draft-07 in 1.29.0 — `target` option missing from mcp.js `toJsonSchemaCompat` calls Aperta

bug fix proposed P1 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100

modelcontextprotocol/typescript-sdk#2084 · 6 commenti · 1 reazione · Aperta il 14/5/2026
Type inconsistency: StreamableHTTPServerTransport.onclose widens Transport interface contract under exactOptionalPropertyTypes Aperta

potentially close

Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100

modelcontextprotocol/typescript-sdk#2083 · 2 commenti · Aperta il 13/5/2026
`registerPrompt()` silently drops `icons` from PromptDefinition config Aperta

potentially close

Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100

modelcontextprotocol/typescript-sdk#2054 · 1 commento · Aperta il 12/5/2026
Security: Transitive dependencies with known vulnerabilities in @modelcontextprotocol/sdk@1.29.0 Aperta

potentially close

Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100

modelcontextprotocol/typescript-sdk#2042 · 1 commento · 1 reazione · Aperta il 10/5/2026
DEFAULT_INHERITED_ENV_VARS Aperta

bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100

modelcontextprotocol/typescript-sdk#2037 · 3 commenti · 1 reazione · Aperta il 9/5/2026
handleAutomaticTaskPolling ignores AbortSignal; cancelled requests poll indefinitely Aperta

potentially close

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#2018 · 1 commento · Aperta il 5/5/2026
zod listed in both dependencies and peerDependencies causes duplicate installs and TS type-incompatibility Aperta

bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100

modelcontextprotocol/typescript-sdk#2011 · 1 commento · 2 reazioni · Aperta il 2/5/2026
Bug: StdioServerTransport doesn't handle stdin close/end — causes zombie process accumulation Aperta

bug fix proposed P1 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100

modelcontextprotocol/typescript-sdk#2002 · 8 commenti · 2 reazioni · Aperta il 1/5/2026
RegisteredTool.update() crashes with ZodObject inputSchema (passthrough schemas) Aperta

bug fix proposed good first issue P2

Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100

modelcontextprotocol/typescript-sdk#1960 · 2 commenti · Aperta il 25/4/2026
Bug: `_handleSseStream` retains reader lock on stream close, leaking ~50MB per reconnection Aperta

potentially close

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#1959 · 2 commenti · Aperta il 25/4/2026
adaptOAuthProvider returns expired tokens without checking expiry, breaking long-running StreamableHTTP connections Aperta

auth bug P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#1954 · 2 commenti · Aperta il 24/4/2026
OAuth discovery does not fall back to well-known URI when 401 carries a non-Bearer WWW-Authenticate (e.g. Negotiate) Aperta

auth bug needs repro

Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100

modelcontextprotocol/typescript-sdk#1946 · 3 commenti · Aperta il 22/4/2026
authExtensions docs say custom claims override reserved JWT claims, but implementation keeps reserved claims authoritative Aperta

bug documentation fix proposed P3 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#1914 · 4 commenti · Aperta il 16/4/2026
`createMcpHonoApp` should support generics for Env (Bindings and Variables) Aperta

enhancement needs decision P3 v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100

modelcontextprotocol/typescript-sdk#1877 · 1 commento · 1 reazione · Aperta il 11/4/2026
StreamableHTTPClientTransport cannot be restarted after close() — breaks OAuth re-authentication Aperta

auth bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100

modelcontextprotocol/typescript-sdk#1641 · 2 commenti · Aperta il 7/3/2026
Hono Package is not under @modelcontextprotocol Aperta

bug potentially close

Difficoltà 1/5 1-3 ore Idoneità per principianti 70/100

modelcontextprotocol/typescript-sdk#1639 · 4 commenti · Aperta il 6/3/2026
StreamableHTTPClientTransport should handle 404 and 406 gracefully for GET SSE stream Aperta

bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100

modelcontextprotocol/typescript-sdk#1635 · 3 commenti · Aperta il 5/3/2026
registerToolTask handlers receive wrong arguments when inputSchema is omitted Aperta

bug fix proposed P2 ready for work v2

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#1471 · 3 commenti · Aperta il 3/2/2026
Simplify public access to McpServer registered tools Aperta

enhancement needs decision P3

Difficoltà 2/5 1-3 ore Idoneità per principianti 67/100

modelcontextprotocol/typescript-sdk#1036 · 1 commento · Aperta il 21/10/2025
The bug in InMemoryEventStore break SSE stream resumability Aperta

bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100

modelcontextprotocol/typescript-sdk#943 · 4 commenti · Aperta il 15/9/2025
OAuth token exchange fails with URL-encoded responses - assumes JSON format only Aperta

auth bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#759 · 4 commenti · 2 reazioni · Aperta il 11/7/2025
MCP SDK Can not handle the MCP Servers with subpath Aperta

bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100

modelcontextprotocol/typescript-sdk#471 · 9 commenti · 1 reazione · Aperta il 9/5/2025
MCP SDK Path Handling Bug for Subpath Servers Aperta

bug fix proposed P2 ready for work

Difficoltà 2/5 1-3 ore Idoneità per principianti 74/100

modelcontextprotocol/typescript-sdk#470 · 5 commenti · Aperta il 9/5/2025

modelcontextprotocol/typescript-sdk

Ricevi le nuove issue nella tua casella