What is Mcp Streamable Http

mcp-streamable-http is a working example of a Streamable HTTP transport-based MCP server and client, implemented in Python and TypeScript, allowing for cross-language communication.

Use cases

Use cases include building chat applications, real-time data visualization tools, and any application that benefits from a streamable HTTP protocol for efficient data transfer.

How to use

To use mcp-streamable-http, clone the repository, set up your environment by adding your API key, and run the server and client using either Python or TypeScript as per the provided instructions.

Key features

Key features include cross-language compatibility, easy setup with examples in both Python and TypeScript, and the ability to specify custom ports for server communication.

Where to use

mcp-streamable-http can be used in various fields such as web development, real-time data processing, and applications that require interactive communication between clients and servers.

MCP Streamable HTTP – Python and Typescript Examples

This repository provides example implementations of MCP (Model Context Protocol) Streamable HTTP client and server in Python and Typescript, based on the specification: 📄 MCP Streamable HTTP Spec.

You can set up a client + server stack entirely using either Python or TypeScript. This example also demonstrates cross-language compatibility, allowing a Python client to communicate with a TypeScript server, and vice-versa.

🚀 Getting Started

1. Clone the Repository

git clone https://github.com/invariantlabs-ai/mcp-streamable-http.git
cd python-example

2. Python Example

1. Add Your Anthropic API Key

Update the .env file inside the python-example/client directory with the following content:

ANTHROPIC_API_KEY=your_api_key_here

2. Set Up the Server

cd python-example/server
pip install .
python weather.py

By default, the server will start at http://localhost:8123.
If you’d like to specify a different port, use the --port flag:

python weather.py --port=9000

3. Set Up the Client

cd ../client
pip install .

4. Run the Client

python client.py

This will start an interactive chat loop using the MCP Streamable HTTP protocol.
If you started the MCP server on a different port, specify it using the --mcp-localhost-port flag:

python client.py --mcp-localhost-port=9000

3. Typescript Example

1. Add Your Anthropic API Key

Update the .env file inside the typescript-example/client directory with the following content:

ANTHROPIC_API_KEY=your_api_key_here

2. Set Up the Server

cd typescript-example/server
npm install && npm run build
node build/index.js

By default, the server will start at http://localhost:8123.
If you’d like to specify a different port, use the --port flag:

node build/index.js --port=9000

3. Set Up the Client

cd ../client
npm install && npm run build

4. Run the Client

node build/index.js

This will start an interactive chat loop using the MCP Streamable HTTP protocol.
If you started the MCP server on a different port, specify it using the --mcp-localhost-port flag:

node build/index.js --mcp-localhost-port=9000

💬 Example Queries

In the client chat interface, you can ask questions like:

• “Are there any weather alerts in Sacramento?”
• “What’s the weather like in New York City?”
• “Tell me the forecast for Boston tomorrow.”

The client will forward requests to the local MCP weather server and return the results using Anthropic’s Claude language model. The MCP transport layer used will be Streamable HTTP.