AgentIndex icon
AgentIndex
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Submit Tool
ToolsMCP ServersHOTCategoriesTrendingNewBest ListsCompareGuides
Home/
MCP Servers/
typescript-sdk
typescript-sdk logo

typescript-sdk

Active·★ 13.8k·Apache-2.0 / MIT·Updated 2026-11-10
★ Most Popular

The official MCP TypeScript SDK supplies a protocol foundation for teams exposing tools and resources to agents or connecting their own host to MCP services. Current v2 uses separate server and client packages, while the older @modelcontextprotocol/sdk package remains the v1 maintenance line. Identify the version before combining examples, transports and error-handling code; similar names do not establish that objects from the two generations are interchangeable.

We ran client and server 2.4.0 with Zod 4.1.12 on Node.js 26.6.0 using a synthetic stdio service. Initialization and discovery succeeded, adding 2 and 3 returned 5, and a string supplied for a numeric field was rejected before the addition handler ran again. A controlled handler failure returned isError true, while an unknown tool produced a protocol exception with code -32602. Resource reads exposed the invocation count, and a fresh server process started at zero.

This checks local protocol contracts without calling a model or real business service. It does not verify HTTP deployment, OAuth, shared multi-user state, Bun or Deno. Schema validation checks argument structure, not whether the current user may perform a business action. Hosts still need completion criteria, authorization, cleanup and handling for the application-specific content returned by the services they use.

Read the full review, verification scope and sources →

Hands-on tested · Tested on 2026-11-04 with @modelcontextprotocol/client and server 2.4.0; Zod 4.1.12.

Setup: macOS arm64, Node.js 26.6.0; synthetic stdio tools and one resource, no model or external business API

Commands run

node doc/review-fixtures/mcp-typescript-sdk/verify.mjs

What we saw

  • Initialization and discovery, valid addition, invalid numeric input, a throwing handler, an unknown tool, resource reads and fresh-process state all passed.
  • Invalid input did not invoke the handler again; a handler failure returned isError true, while an unknown tool threw protocol code -32602.
  • Local stdio only. HTTP, OAuth, multi-user state, Bun and Deno were not tested.

Data as of 2026-11-12.

License
Not detected by GitHub
Latest release
v2.4.0 · 2026-10-23
Last commit
2026-11-10
Contributors
196
Forks
2,380
Open issues and PRs
665
First published
2024-09-24
npm package
@modelcontextprotocol/server 2.4.0 · 27,535,812 downloads last week

Source: GitHub, npm and PyPI public APIs.

#mcp#mcp-client#mcp-server#mcp-servers#typescript
$ Install
$ npm install @modelcontextprotocol/[email protected] @modelcontextprotocol/[email protected]
↗ Visit site★ GitHub
01

Features

01Server library for tools, resources and prompts
02Client library with transports and OAuth helpers
03Streamable HTTP and stdio transports
04Standard Schema support: Zod v4, Valibot, ArkType
05Middleware for Express, Fastify, Hono and Node.js HTTP
02

Why choose it

+The tested client/server pair supported discovery, invocation and resource reads without requiring a model call.
+The numeric schema rejected invalid input before the business handler, with a resource counter confirming the behavior.
+Separating server, client and HTTP adapter packages lets an application declare dependencies for the role it actually implements.
03

Trade-offs

!V1 to v2 migration involves package names, adapters and error contracts, rather than only updating a version number.
!The SDK does not supply your business authorization or decide whether a model completed the user's task.
!Our stdio check establishes no production HTTP, OAuth or multi-user isolation result.
05

Maintenance check

ActiveChecked: 2026-11-10
Last commit
2026-11-10
Commits, last 90 days
85
Releases, last 90 days
30
Latest release
v2.4.0 (2026-10-23)
Open issues
661
Recent issues with at least one comment
19/20
Commits per week, last 12 weeks
Commits per week, last 12 weeks: 2, 3, 2, 1, 5, 37, 6, 3, 14, 3, 0, 1

Oldest week on the left; the latest four weeks are orange. Source: GitHub commit activity.

Status rule: archived on GitHub = Archived; last commit within 90 days = Active; 91 to 365 days = Slowing; older = Stale. All figures come from the GitHub API on the date shown.

Most discussed open issues

  • #1238 Feature Request: Middleware support for McpServer15 comments · 2025-12-05
  • #2695 `maxTotalTimeout` is never enforced unless a progress notification arrives12 comments · 2026-08-21
  • #3053 Streamable HTTP: the POST for a cancelled request never settles11 comments · 2026-10-19
  • #2677 tools/list emits draft-07 $schema for Zod v4 schemas: toJsonSchemaCompat is called without a target, and mapMiniTarget defaults to 'draft-7'8 comments · 2026-08-17

Issue titles are quoted from GitHub. Open the link to check whether a problem still applies to the version you use.

04

Who it fits

Pick it if
  • You are implementing a TypeScript MCP service or host and want direct control of protocol integration.
  • You can maintain contract tests for valid input, failures, lifecycle and the versions of connected peers.
Look elsewhere if
  • You only need an already configured agent rather than a protocol library.
  • You cannot yet allocate work for business authorization and deployment beyond a local demo.
06

Compatibility

Node.js
20+; tested on 26.6.0
Verified via docs
Bun
Documented; not tested here
Verified via docs
Deno
Documented; not tested here
Verified via docs
07

Quick start

1
$ npm install @modelcontextprotocol/[email protected] @modelcontextprotocol/[email protected]
08

Use cases

↳Building an MCP server in TypeScript
↳Adding MCP client support to an app or agent
09

Alternatives

⚡Top VS:
VSmcphub★2.7k→VSTREK★15.7k→VSNavidrome-MCP★98→VSwhoop-mcp★144→
pinky logo
pinky★ 2.4k
Let AI use your iPhone or Android phone, with you in the loop: any MCP agent from macOS, Windows or Linux, or Pinky itself, right on the phone.
mcphub logo
mcphub★ 2.7k
A unified hub for centrally managing and dynamically orchestrating multiple MCP servers/APIs into separate endpoints with flexible routing strategies
VSCompare→
Godot-MCP logo
Godot-MCP★ 355
Godot-MCP — Model Context Protocol (MCP) integration for the Godot Engine. AI tools for the Godot Editor in C#, with cloud connection to ai-game.dev. Apache-2.0.
TREK logo
TREK★ 15.7k
The most complete open-source travel planner: real-time collaboration, bookings, budgets, packing lists, journals, offline PWA, SSO and an AI-ready MCP server, with planet-wide place search and routing built in.
VSCompare→
Navidrome-MCP logo
Navidrome-MCP★ 98
Analyze listening patterns, build playlists, find missing albums, discover similar artists via Last.fm, fetch synced lyrics, and explore global radio. Play it all through your speakers via mpv, with a built-in web UI that makes any device with a brower act as a remote. Gives full control of your Navidrome library using natural language.
VSCompare→
whoop-mcp logo
whoop-mcp★ 144
Model Context Protocol server giving Claude (or any MCP client) full read + write access to your Whoop fitness data via the private reverse-engineered iOS API. 47 tools: recovery, sleep, strain, HRV trends, Strength Trainer, journal, Whoop Coach, and smart alarm. TypeScript + zod, auto-refresh Cognito auth.
VSCompare→
copilot-money-mcp logo
copilot-money-mcp★ 89
MCP server for Copilot Money App - AI powered personal finance queries using local data
VSCompare→
mcp-music-studio logo
mcp-music-studio★ 80
Two-mode MCP music studio: scored composition (ABC notation) and live performance (Strudel). Interactive ext-apps UI with sheet music rendering, 30+ instruments, style presets, and live coding REPL.
VSCompare→
See all alternatives →

Comments

Log in to leave a comment

No comments yet. Be the first!

On this page
01Features02Why choose it03Trade-offs05Maintenance check04Who it fits06Compatibility07Quick start08Use cases09Alternatives
modelcontextprotocol /
typescript-sdk
↗

Official protocol libraries for building MCP servers and clients

13.8k2.4kApache-2.0 / MIT
Last commit1w ago
StatusActive
CategoryMCP Servers
Contributors196
Latest releasev2.4.0
Links
Documentation↗Discussion↗Issues↗Releases↗
Cloud Infrastructure
Ad

Deploy on DigitalOcean

Host your MCP servers, Docker containers, and AI agents with $200 free credit over 60 days.

Claim $200 Free Credit
© 2026 AgentIndex.app|Built by a 10-year iOS Developer.
Best by use caseAboutContactAdvertisePrivacy PolicyTerms of UseQYSGitHubBuy me a coffee ☕

Browse by Category

MCP ServersCode AssistantWorkflow AutomationRAG / Knowledge BaseMulti-AgentBrowser AutomationLLM InfraDev ToolingObservability

Not affiliated with Anthropic, OpenAI or Microsoft.