概览
What is Demo MCP?
Demo MCP is a demonstration server built with the Model Context Protocol (MCP) Python SDK. It provides example server implementations and a demo client to showcase MCP interactions over SSE transport, intended for developers learning or testing MCP.
How to use Demo MCP?
Clone the repository, create a Python virtual environment, install dependencies with pip install -r requirements.txt, then run either python server.py for a plain server or python server_asgi.py for a server with JWT authentication. Use python client.py http://localhost:8000/sse to run the demo client, or python host_langchain.py <model> <ollama-url> to run a LangChain/LangGraph host.
Key features of Demo MCP
- Drop-in setup with Python virtual environment and requirements
- Two server modes: plain and JWT‑authenticated
- Integrated demo client over SSE transport
- LangChain/LangGraph host integration with Ollama models
- Debug using the official MCP Inspector tool
Use cases of Demo MCP
- Learning how to set up and run an MCP server
- Testing client–server communication over SSE
- Experimenting with JWT authentication in MCP
- Prototyping MCP integrations with LangChain and local LLMs
FAQ from Demo MCP
What does this server do beyond being a demo?
The README does not describe specific tools or resources; it only provides runnable example code from the MCP Python SDK.
What dependencies are required?
Python 3, a virtual environment, and the packages listed in requirements.txt. For the LangChain host, Ollama must be installed and a model downloaded.
How do I debug the server?
Run npx @modelcontextprotocol/inspector, point a browser to http://127.0.0.1:6274, set Transport Type to SSE and URL to http://localhost:8000/sse, then click Connect.
What transport and authentication are supported?
Transport is SSE (Server‑Sent Events). The server_asgi.py script adds JWT authentication; the plain server.py does not.
Is this intended for production use?
No – the README explicitly frames it as a demo, referencing example code and an Inspector debug tool.
