streamable-mcp-server

What is streamable-mcp-server?

A TypeScript starter template for building a Streamable HTTP MCP (Model Context Protocol) server. It is based on the official MCP TypeScript SDK example with session management and includes sensible dependencies and tsconfig. Designed for developers who want to quickly create a custom MCP server using the Streamable HTTP Transport introduced on 2025-03-26.

How to use streamable-mcp-server?

Clone or fork the repo, install dependencies with npm install, build with npm run build. Run in production mode with npm start (or node build/index.js) or in development mode with npm run dev (which watches for changes and restarts). The server runs on port 3000 by default; set the PORT environment variable to change it. Connect a client by configuring it with type "streamable-http" and the server's URL (e.g., http://localhost:3000).

Key features of streamable-mcp-server

• Built on the MCP TypeScript SDK with session management.
• Sensible default dependencies and TypeScript configuration.
• Runs on port 3000, configurable via the PORT environment variable.
• Provides both production and development (auto‑reload) modes.
• Supports the Streamable HTTP Transport for MCP.

Use cases of streamable-mcp-server

• Quickly prototyping a new Streamable HTTP MCP server.
• Learning how to build an MCP server with the TypeScript SDK.
• Forking and customizing to create a production‑ready MCP server.

FAQ from streamable-mcp-server

What is Streamable HTTP Transport?

Streamable HTTP Transport is a method for communicating between MCP clients and servers, introduced on 2025-03-26. See the MCP Spec Changelog for details.

How do I change the port the server runs on?

Set the PORT environment variable when starting the server. For example: PORT=3002 npm start.

How do I run the server in development mode?

Use the npm run dev command. It automatically watches for source file changes, rebuilds, and restarts the server.

How do I connect a client to the server?

Configure your client with the type "streamable-http" and the server's URL. An example configuration is shown in the mcp-config.json file:

{
  "mcpServers": {
    "streamable-mcp-server": {
      "type": "streamable-http",
      "url": ""
    }
  }
}

What future enhancements are planned?

The README mentions handling OAuth authentication as a future enhancement.