mcp-streamable-http
Example implementation of MCP Streamable HTTP client/server in Python and TypeScript.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/invariantlabs-ai--mcp-streamable-http)HTML
<a href="/listings/invariantlabs-ai--mcp-streamable-http"><img src="/api/listings/invariantlabs-ai--mcp-streamable-http/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 116 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http).
- 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
- ```bash
- 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:
- ```env
- ANTHROPIC_API_KEY=your_api_key_here
- ```
- #### 2. Set Up the Server
- ```bash
- 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:
- ```bash
- python weather.py --port=9000
- ```
- #### 3. Set Up the Client
- ```bash
- cd ../client
- pip install .
- ```
- #### 4. Run the Client
- ```bash
- 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:
- ```bash
- 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:
- ```env
- ANTHROPIC_API_KEY=your_api_key_here
- ```
- #### 2. Set Up the Server
- ```bash
- 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:
- ```bash
- node build/index.js --port=9000
- ```
- #### 3. Set Up the Client
- ```bash
- cd ../client
- npm install && npm run build
- ```
- #### 4. Run the Client
- ```bash
- 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:
- ```bash
- 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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.