mcp-demo

jeatonsf/mcp-demo

3.2

If you are the rightful owner of mcp-demo and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is a specialized server designed to facilitate communication between clients and models, particularly in environments where quick product demonstrations are needed.

MCP Demo

A chat interface that connects to a custom MCP server via a custom MCP client. Use this custom MCP client and server for quick product demos (e.g. hackathons, sprint demos).

Setup

1. Create and activate virtual environment

python -m venv .venv
source .venv/bin/activate

2. Install dependencies

pip install -r requirements.txt

3. Set OpenAI API key

export OPENAI_API_KEY="your-api-key-here"

Running

Start the client (includes MCP server)

python client.py

Then open http://localhost:8080 in your browser.

Optional: Run MCP server separately

python server.py  # stdio mode
MCP_TRANSPORT=streamable-http python server.py  # http mode

Cleanup

deactivate  # Exit venv
rm -rf .venv  # Delete venv