Skip to content

SDK V2 #809

Closed
#1326
#1279
Closed
SDK V2#809
#1326
#1279
Labels
v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
Milestone
v2

Description

@ihrpr
ihrpr
opened on Jul 24, 2025

This issue is to track changes we need to have

@KKonstantinov EDITs:

Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.

  • Decouple from Zod, allow for any validator ("bring your own").
  • Type-first as opposed to zod schema-first approach
  • Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
  • Tests - All tests under /test directory
  • Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
  • Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
  • non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
  • Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
  • clear abstracted way to define experimental features in the SDK
  • DX quality of life improvements, such as inject your own logger
  • DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
  • Ability to pass in JSON schema on the higher-order abstraction (McpServer)
  • DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
  • Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
  • ctx object inside the tool extra for transport/server controls.
  • Using Headers as opposed to a custom object in request context

Metadata

Metadata

Assignees

No one assigned

    Labels

    v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      , 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
       blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
      Skip to content
      SDK V2 #809
      Closed
      #1326
      #1279
      Closed
      SDK V2#809
      #1326
      #1279
      Labels
      v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
      Milestone
      v2
      Description
      @ihrpr
      ihrpr
      opened on Jul 24, 2025
      This issue is to track changes we need to have
      @KKonstantinov EDITs:
      Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
      •  Decouple from Zod, allow for any validator ("bring your own").
      •  Type-first as opposed to zod schema-first approach
      •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
      •  Tests - All tests under /test directory
      •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
      •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
      •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
      •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
      •  clear abstracted way to define experimental features in the SDK
      •  DX quality of life improvements, such as inject your own logger
      •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
      •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
      •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
      •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
      •  ctx object inside the tool extra for transport/server controls.
      •  Using Headers as opposed to a custom object in request context
      Metadata
      Metadata
      Assignees
      No one assigned
        Labels
        v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
        Type
        No type
        Projects
        No projects
          Milestone
          Relationships
          None yet
          Development
          No branches or pull requests
          Issue actions
          
, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
          Skip to content
          SDK V2 #809
          Closed
          #1326
          #1279
          Closed
          SDK V2#809
          #1326
          #1279
          Labels
          v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
          Milestone
          v2
          Description
          @ihrpr
          ihrpr
          opened on Jul 24, 2025
          This issue is to track changes we need to have
          @KKonstantinov EDITs:
          Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
          •  Decouple from Zod, allow for any validator ("bring your own").
          •  Type-first as opposed to zod schema-first approach
          •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
          •  Tests - All tests under /test directory
          •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
          •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
          •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
          •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
          •  clear abstracted way to define experimental features in the SDK
          •  DX quality of life improvements, such as inject your own logger
          •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
          •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
          •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
          •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
          •  ctx object inside the tool extra for transport/server controls.
          •  Using Headers as opposed to a custom object in request context
          Metadata
          Metadata
          Assignees
          No one assigned
            Labels
            v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
            Type
            No type
            Projects
            No projects
              Milestone
              Relationships
              None yet
              Development
              No branches or pull requests
              Issue actions
              
, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
              Skip to content
              SDK V2 #809
              Closed
              #1326
              #1279
              Closed
              SDK V2#809
              #1326
              #1279
              Labels
              v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
              Milestone
              v2
              Description
              @ihrpr
              ihrpr
              opened on Jul 24, 2025
              This issue is to track changes we need to have
              @KKonstantinov EDITs:
              Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
              •  Decouple from Zod, allow for any validator ("bring your own").
              •  Type-first as opposed to zod schema-first approach
              •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
              •  Tests - All tests under /test directory
              •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
              •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
              •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
              •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
              •  clear abstracted way to define experimental features in the SDK
              •  DX quality of life improvements, such as inject your own logger
              •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
              •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
              •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
              •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
              •  ctx object inside the tool extra for transport/server controls.
              •  Using Headers as opposed to a custom object in request context
              Metadata
              Metadata
              Assignees
              No one assigned
                Labels
                v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                Type
                No type
                Projects
                No projects
                  Milestone
                  Relationships
                  None yet
                  Development
                  No branches or pull requests
                  Issue actions
                  
, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
                  Skip to content
                  SDK V2 #809
                  Closed
                  #1326
                  #1279
                  Closed
                  SDK V2#809
                  #1326
                  #1279
                  Labels
                  v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                  Milestone
                  v2
                  Description
                  @ihrpr
                  ihrpr
                  opened on Jul 24, 2025
                  This issue is to track changes we need to have
                  @KKonstantinov EDITs:
                  Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
                  •  Decouple from Zod, allow for any validator ("bring your own").
                  •  Type-first as opposed to zod schema-first approach
                  •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
                  •  Tests - All tests under /test directory
                  •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
                  •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
                  •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
                  •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
                  •  clear abstracted way to define experimental features in the SDK
                  •  DX quality of life improvements, such as inject your own logger
                  •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
                  •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
                  •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
                  •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
                  •  ctx object inside the tool extra for transport/server controls.
                  •  Using Headers as opposed to a custom object in request context
                  Metadata
                  Metadata
                  Assignees
                  No one assigned
                    Labels
                    v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                    Type
                    No type
                    Projects
                    No projects
                      Milestone
                      Relationships
                      None yet
                      Development
                      No branches or pull requests
                      Issue actions
                      
, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
                      Skip to content
                      SDK V2 #809
                      Closed
                      #1326
                      #1279
                      Closed
                      SDK V2#809
                      #1326
                      #1279
                      Labels
                      v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                      Milestone
                      v2
                      Description
                      @ihrpr
                      ihrpr
                      opened on Jul 24, 2025
                      This issue is to track changes we need to have
                      @KKonstantinov EDITs:
                      Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
                      •  Decouple from Zod, allow for any validator ("bring your own").
                      •  Type-first as opposed to zod schema-first approach
                      •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
                      •  Tests - All tests under /test directory
                      •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
                      •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
                      •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
                      •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
                      •  clear abstracted way to define experimental features in the SDK
                      •  DX quality of life improvements, such as inject your own logger
                      •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
                      •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
                      •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
                      •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
                      •  ctx object inside the tool extra for transport/server controls.
                      •  Using Headers as opposed to a custom object in request context
                      Metadata
                      Metadata
                      Assignees
                      No one assigned
                        Labels
                        v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                        Type
                        No type
                        Projects
                        No projects
                          Milestone
                          Relationships
                          None yet
                          Development
                          No branches or pull requests
                          Issue actions
                          
, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
                          Skip to content
                          SDK V2 #809
                          Closed
                          #1326
                          #1279
                          Closed
                          SDK V2#809
                          #1326
                          #1279
                          Labels
                          v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                          Milestone
                          v2
                          Description
                          @ihrpr
                          ihrpr
                          opened on Jul 24, 2025
                          This issue is to track changes we need to have
                          @KKonstantinov EDITs:
                          Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
                          •  Decouple from Zod, allow for any validator ("bring your own").
                          •  Type-first as opposed to zod schema-first approach
                          •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
                          •  Tests - All tests under /test directory
                          •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
                          •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
                          •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
                          •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
                          •  clear abstracted way to define experimental features in the SDK
                          •  DX quality of life improvements, such as inject your own logger
                          •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
                          •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
                          •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
                          •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
                          •  ctx object inside the tool extra for transport/server controls.
                          •  Using Headers as opposed to a custom object in request context
                          Metadata
                          Metadata
                          Assignees
                          No one assigned
                            Labels
                            v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                            Type
                            No type
                            Projects
                            No projects
                              Milestone
                              Relationships
                              None yet
                              Development
                              No branches or pull requests
                              Issue actions
                              
, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();
SDK V2 · Issue #809 · modelcontextprotocol/typescript-sdk · GitHub
                              Skip to content
                              SDK V2 #809
                              Closed
                              #1326
                              #1279
                              Closed
                              SDK V2#809
                              #1326
                              #1279
                              Labels
                              v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                              Milestone
                              v2
                              Description
                              @ihrpr
                              ihrpr
                              opened on Jul 24, 2025
                              This issue is to track changes we need to have
                              @KKonstantinov EDITs:
                              Please note the below is a wishlist, and will be introduced in v2 depending on demand and timeline considerations; Some of it would be opened up for contributors for a PR after the v2 refactor.
                              •  Decouple from Zod, allow for any validator ("bring your own").
                              •  Type-first as opposed to zod schema-first approach
                              •  Protocol.ts - although the goal is to have symmetric client and server, protocol.ts contains nasty conditionals which can be executed only by client or server, but not both, defeating the purpose of an abstract class. File hard to read & extend.
                              •  Tests - All tests under /test directory
                              •  Tests - Reusable helpers under /test/helper directory - e.g. creating mock server, mock client, connecting them together, etc. etc. (we already have a significant amount we could move there).
                              •  Decouple from express to allow for lighter SDK, and easier compatibility with other HTTP frameworks (e.g. Hono, fastify, others)
                              •  non-node environment considerations (e.g. Bun, Deno on the backend, react-native on frontend, etc.)
                              •  Publish @modelcontextprotocol/typescript-sdk-client and @modelcontextprotocol/typescript-sdk-server to reduce package size on users with a single consideration (e.g. either server or client)
                              •  clear abstracted way to define experimental features in the SDK
                              •  DX quality of life improvements, such as inject your own logger
                              •  DX - ability to listen on onError and hook in custom behavior on McpErrors thrown
                              •  Ability to pass in JSON schema on the higher-order abstraction (McpServer)
                              •  DX - provide OpenTelemetry (@opentelemetry/api) capabilities out of the box - inject your own telemetry Tracer/Metrics Provider
                              •  Examples - move out in another package or out of src/ - examples should import from @modelcontextprotocol/sdk to be readily copy-able as opposed to having relative imports in them
                              •  ctx object inside the tool extra for transport/server controls.
                              •  Using Headers as opposed to a custom object in request context
                              Metadata
                              Metadata
                              Assignees
                              No one assigned
                                Labels
                                v2Ideas, requests and plans for v2 of the SDK which will incorporate major changes and fixes
                                Type
                                No type
                                Projects
                                No projects
                                  Milestone
                                  Relationships
                                  None yet
                                  Development
                                  No branches or pull requests
                                  Issue actions