modelcontextprotocol/typescript-sdk

在 GitHub 查看

The official TypeScript SDK for Model Context Protocol servers and clients

星标: 13.4k
派生: 2.2k
开放的新手 issue: 49
已索引 issue: 303
平均合并: 3 天 12 小时
30 天内合并 PR: 3

主要语言: TypeScript
许可证: 没有许可证数据
最近 GitHub push: 2026年9月16日
最近索引: 2026年9月20日
贡献指南: 贡献指南
行为准则: 行为准则
新手标签: good first issue help wanted

适合新手全部

未关闭全部

pnpm -r typecheck silently skips the three test packages, hiding 35 type errors and one registerPrompt typing defect 未关闭

难度 4/5 3-5 天新手友好度 42/100

modelcontextprotocol/typescript-sdk#2840 · 2026年9月21日创建
[v2] registerTool converts zod schemas eagerly per McpServer instance, so stateless servers re-convert every tool on every request 未关闭

v2

难度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/typescript-sdk#2838 · 1 条评论 · 1 个 reaction · 2026年9月21日创建
genesis playing 未关闭

难度 5/5 一周以上新手友好度 10/100

modelcontextprotocol/typescript-sdk#2835 · 2026年9月20日创建
Error: Browser navigation is locked during ChatGPT login 未关闭

难度 4/5 3-5 天新手友好度 35/100

modelcontextprotocol/typescript-sdk#2834 · 2026年9月19日创建
PKCE verification: 2025-11-25 requires refusing when `code_challenge_methods_supported` is absent, which conflicts with the #832 / #992 resolution 未关闭

难度 5/5 一周以上新手友好度 28/100

modelcontextprotocol/typescript-sdk#2831 · 2026年9月18日创建
[v2] Server-side hook for subscriptions/listen resource subscriptions (attach/detach per URI) 未关闭

难度 5/5 一周以上新手友好度 38/100

modelcontextprotocol/typescript-sdk#2827 · 1 条评论 · 2026年9月17日创建
[v2] _resetTimeout never updates startTime, so totalElapsed keeps accumulating from the original 未关闭

v2

难度 3/5 1-2 天新手友好度 72/100

modelcontextprotocol/typescript-sdk#2816 · 2026年9月14日创建
License metadata clarification for server/core 2.0.0 未关闭

难度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/typescript-sdk#2801 · 2026年9月13日创建
TS SDK Add first-class SEP-2640 Skills extension APIs 未关闭

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/typescript-sdk#2798 · 2026年9月12日创建
skills/list, skills/get, resources/directory/read always fail: codec strips resultType before re-validating it 未关闭

难度 3/5 1-2 天新手友好度 76/100

modelcontextprotocol/typescript-sdk#2789 · 1 条评论 · 2026年9月11日创建
A handler that throws McpError produces a double-prefixed message on the client 未关闭

难度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/typescript-sdk#2786 · 3 条评论 · 2026年9月10日创建
Auth metadata discovery: fallback URL built on resource host instead of authorization-server host 未关闭

难度 2/5 1-3 小时新手友好度 74/100

modelcontextprotocol/typescript-sdk#2784 · 2026年9月10日创建
Auth metadata discovery: fallback only triggers on 404, misses 401/403 未关闭

难度 2/5 1-3 小时新手友好度 82/100

modelcontextprotocol/typescript-sdk#2783 · 1 条评论 · 2026年9月10日创建
OAuth client_secret comparison in clientAuth.ts is not constant-time 未关闭

难度 2/5 1-3 小时新手友好度 35/100

modelcontextprotocol/typescript-sdk#2780 · 2026年9月10日创建
Where does validation of a peer's declarations belong? Four things the client accepts today 未关闭

难度 5/5 一周以上新手友好度 30/100

modelcontextprotocol/typescript-sdk#2777 · 1 条评论 · 1 个 reaction · 2026年9月9日创建
stderr: 'pipe' deadlocks the session if the consumer never reads transport.stderr 未关闭

难度 3/5 1-2 天新手友好度 72/100

modelcontextprotocol/typescript-sdk#2776 · 3 条评论 · 2026年9月9日创建
Transport errors are reported only on onerror; awaiting callers always get "MCP error -32000: Connection closed" 未关闭

难度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/typescript-sdk#2775 · 3 条评论 · 2026年9月9日创建
authorizationHandler drops the OAuth state parameter on error redirects 未关闭

难度 2/5 1-3 小时新手友好度 88/100

modelcontextprotocol/typescript-sdk#2773 · 2026年9月9日创建
[v2] Streamable HTTP client does not clear stale resumption token after an empty SSE id 未关闭

难度 3/5 1-2 天新手友好度 76/100

modelcontextprotocol/typescript-sdk#2769 · 3 条评论 · 2026年9月8日创建
Doc comments misattribute the token-endpoint TLS check to SEP-2207 (which is OIDC refresh / `offline_access`) 未关闭

难度 1/5 1 小时以内新手友好度 92/100

modelcontextprotocol/typescript-sdk#2766 · 1 条评论 · 2026年9月7日创建
[v2] Typescript: optional content when structuredContent is present 未关闭

v2

难度 3/5 1-2 天新手友好度 62/100

modelcontextprotocol/typescript-sdk#2755 · 2026年9月3日创建
[v2] Should raise error at build time if zod outputSchema is not consistent with the structuredContent type 未关闭

v2

难度 4/5 3-5 天新手友好度 50/100

modelcontextprotocol/typescript-sdk#2754 · 2 条评论 · 2026年9月3日创建
Server auth defaults silently produce RFC 9728-noncompliant discovery when the MCP endpoint has a path 未关闭

难度 2/5 1-2 天新手友好度 72/100

modelcontextprotocol/typescript-sdk#2751 · 2026年9月3日创建
v1.x and v2 disagree on validating an error result's structuredContent — and the v1.x comment describes the v2 behaviour 未关闭

难度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/typescript-sdk#2748 · 4 条评论 · 2026年9月2日创建
experimental.tasks.getTaskResult() throws TypeError: Cannot read properties of undefined (reading '_zod') when the optional result schema is omitted 未关闭

难度 2/5 1-3 小时新手友好度 84/100

modelcontextprotocol/typescript-sdk#2742 · 2 条评论 · 2026年8月31日创建
StreamableHTTPClientTransport leaves POST requests pending when their SSE response ends or errors 未关闭

难度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/typescript-sdk#2739 · 5 条评论 · 2026年8月30日创建
Client.listTools() silently drops pages when a server repeats a cursor 未关闭

难度 3/5 1-2 天新手友好度 74/100

modelcontextprotocol/typescript-sdk#2735 · 2 条评论 · 2026年8月28日创建
[v2] OAuth discovery validates any /.well-known/openid-configuration document as OIDC, rejecting conforming RFC 8414 metadata 未关闭

难度 4/5 3-5 天新手友好度 58/100

modelcontextprotocol/typescript-sdk#2733 · 1 条评论 · 2026年8月28日创建
StreamableHTTP server transport returns bare 400 for a notification when the request has Connection: close 未关闭

难度 3/5 1-2 天新手友好度 58/100

modelcontextprotocol/typescript-sdk#2730 · 1 条评论 · 1 个 reaction · 2026年8月27日创建
UriTemplate.match() does not percent-decode extracted values 未关闭

难度 2/5 1-3 小时新手友好度 84/100

modelcontextprotocol/typescript-sdk#2728 · 4 条评论 · 2026年8月27日创建
remove() is a no-op after a handle is renamed, and the entry stays callable 未关闭

难度 3/5 1-2 天新手友好度 78/100

modelcontextprotocol/typescript-sdk#2723 · 1 条评论 · 2026年8月26日创建
[v2] Era-negotiation probe drops spec-conformant server/discover responses (top-level resultType/_meta) and misclassifies modern servers as legacy 未关闭

难度 4/5 3-5 天新手友好度 62/100

modelcontextprotocol/typescript-sdk#2722 · 3 条评论 · 2026年8月26日创建
outputSchema always emitted as JSON Schema draft-07, breaking clients that only accept 2020-12 未关闭

难度 2/5 1-3 小时新手友好度 82/100

modelcontextprotocol/typescript-sdk#2721 · 4 条评论 · 2 个 reaction · 2026年8月26日创建
Docs: registerClient's @deprecated notice cites SEP-2577; DCR deprecation is PR #2858 (SEP-2577 is Roots/Sampling/Logging) 未关闭

难度 1/5 1 小时以内新手友好度 85/100

modelcontextprotocol/typescript-sdk#2719 · 2026年8月26日创建
[v2] Incompatibility with refresh_tokens from Azure when client_id=resource_id 未关闭

v2

难度 3/5 1-2 天新手友好度 72/100

modelcontextprotocol/typescript-sdk#2718 · 2026年8月26日创建
Semantics question: how should tool-call telemetry count cancelled or retried `tools/call` requests? 未关闭

难度 4/5 3-5 天新手友好度 48/100

modelcontextprotocol/typescript-sdk#2715 · 1 条评论 · 1 个 reaction · 2026年8月25日创建
registerTool with zod raw shape: refine/superRefine/transform are silently dropped from validation 未关闭

v1 v2

难度 3/5 1-2 天新手友好度 55/100

modelcontextprotocol/typescript-sdk#2705 · 1 条评论 · 2026年8月23日创建
Stateless StreamableHTTPServerTransport: per-request requirement is invisible through the Node wrapper (500 with empty body) 未关闭

v1 v2

难度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/typescript-sdk#2704 · 1 条评论 · 2026年8月23日创建
Deno: TS2307 on all .js subpath imports — './*' exports map types to '*.js.d.ts' 未关闭

v1

难度 2/5 1-3 小时新手友好度 84/100

modelcontextprotocol/typescript-sdk#2701 · 2 条评论 · 2026年8月22日创建
Client follows server 3xx into internal/loopback services: redirect SSRF / protocol confusion (bare fetch, no host validation) — same class as python-sdk #3358 未关闭

v1 v2

难度 4/5 3-5 天新手友好度 52/100

modelcontextprotocol/typescript-sdk#2700 · 1 条评论 · 2026年8月22日创建
`maxTotalTimeout` is never enforced unless a progress notification arrives 未关闭

v1 v2

难度 3/5 1-2 天新手友好度 82/100

modelcontextprotocol/typescript-sdk#2695 · 10 条评论 · 2026年8月21日创建
Resource templates ignore `enabled`: disable() leaves them listed, readable and completable 未关闭

v1 v2

难度 3/5 1-2 天新手友好度 78/100

modelcontextprotocol/typescript-sdk#2693 · 1 条评论 · 2026年8月21日创建
Streamable HTTP server accepts unsafe integer in x-mcp-header field when mirrored header is absent 未关闭

v2

难度 3/5 1-2 天新手友好度 48/100

modelcontextprotocol/typescript-sdk#2689 · 2026年8月19日创建
Proposal: warn when a network-facing MCP server starts without authentication 未关闭

auth enhancement needs design v1 v2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/typescript-sdk#2685 · 2026年8月18日创建
[v2] StreamableHTTPClientTransport standby GET/SSE stream reconnects forever when the server gracefully idle-closes it ( maxRetries never trips) 未关闭

v1 v2

难度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/typescript-sdk#2682 · 2026年8月17日创建
tools/list emits draft-07 $schema for Zod v4 schemas: toJsonSchemaCompat is called without a target, and mapMiniTarget defaults to 'draft-7' 未关闭

bug v1

难度 3/5 1-2 天新手友好度 68/100

modelcontextprotocol/typescript-sdk#2677 · 8 条评论 · 1 个 reaction · 2026年8月17日创建
Streamable HTTP SSE tests assume multiple events share one fetch chunk 未关闭

bug good first issue P3 v1 v2

难度 2/5 1-3 小时新手友好度 78/100

modelcontextprotocol/typescript-sdk#2661 · 2 条评论 · 2026年8月14日创建
[v2] StreamableHTTPClientTransport drops SSE stream provenance, so a server-initiated request cannot be attributed to the client request that provoked it 未关闭

enhancement needs design v1 v2

难度 3/5 1-2 天新手友好度 72/100

modelcontextprotocol/typescript-sdk#2659 · 2026年8月13日创建
tools/call has no path to a protocol-level "Server errors" response, even for unhandled exceptions 未关闭

enhancement needs design v1 v2

难度 5/5 一周以上新手友好度 35/100

modelcontextprotocol/typescript-sdk#2656 · 1 条评论 · 2026年8月13日创建
[v2] subscriptions/listen holds a stream open even when it has honoured nothing 未关闭

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

难度 2/5 1-3 小时新手友好度 78/100

modelcontextprotocol/typescript-sdk#2650 · 2 条评论 · 2026年8月12日创建

只显示最新的 100 条

这个页面只列出最近收录的部分。完整清单在高级筛选里，可以按语言、难度和预计耗时筛选。

前往高级筛选

精选适合新手参与的 GitHub issue 摘要。