# streamable-mcp-server

This is a starting place for a new streamable-http MCP Server built with typescript.

Streamable HTTP Transport was introduced on 2025-03-26. [See MCP Spec Changelog](https://modelcontextprotocol.io/specification/2025-03-26/changelog).

Starts with the [Model Context Protocol Typescript SDK Streamable HTTP with Session Management Example](https://github.com/modelcontextprotocol/typescript-sdk?tab=readme-ov-file#with-session-management) and contains some sensible dependencies and tsconfig to get rolling.

Clone or fork this repo, make updates and start building your Streamable HTTP MCP Server.

# Install and Run Locally

To install the dependencies, run:

```bash
npm install
```

Then build:

```bash
npm run build
```

## Running the Server

### Production Mode

To run the server in production mode:

```bash
npm start
# or directly with
node build/index.js
```


It runs on port 3000 by default. If you need another port, you can specify with the PORT env var.

```bash
PORT=3002 npm start
# or
PORT=3002 node build/index.js
```

### Development Mode

For development, you can use the dev mode which automatically watches for changes in your source files, rebuilds, and restarts the server:

```bash
npm run dev
```

With a custom port:

```bash
PORT=3002 npm run dev
```

# Connect a Client

You can connect a client to your Streamable HTTP MCP Server once it's running. Configure per the client's configuration. There is the [mcp-config.json](/mcp-config.json) that has an example configuration that looks like this:
```json
{
  "mcpServers": {
    "streamable-mcp-server": {
      "type": "streamable-http",
      "url": "http://localhost:3000"
    }
  }
}
```


Future enhancements:
- handle oauth authentication
- more tool examples