MCP Streamable Http Typescript Server

🚀 Streamable MCP Server

A fresh starting point for a streamable HTTP MCP server built with TypeScript.

Streamable HTTP transport was introduced on March 26, 2025. View the MCP specification changelog.

Begin with the Streamable HTTP example with session management from the Model Context Protocol TypeScript SDK, which includes some reasonable dependencies and tsconfig configurations to kick off your project.

Clone or fork this repository, make updates, and start building your streamable HTTP MCP server.

🚀 Quick Start

📦 Installation and Local Run

To install the dependencies, run:

npm install

Then build the project:

npm run build

💻 Running the Server

Production Mode

To run the server in production mode:

npm start
# Or run directly
node build/index.js

By default, it runs on port 3000. If you need a different port, you can specify it using the PORT environment variable.

PORT=3002 npm start
# Or
PORT=3002 node build/index.js

Development Mode

In development mode, you can use the dev mode which automatically monitors changes in the source files, rebuilds, and restarts the server:

npm run dev

To specify a custom port:

PORT=3002 npm run dev

Connecting to a Client

Once your streamable HTTP MCP server is up and running, you can connect a client. Configure it according to the client's settings. There is an example configuration /mcp-config.json as follows:

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

Future Enhancements

• Handle OAuth authentication
• More tool examples