Demo MCP

Name: Demo MCP
Author: josx

@josx

Repository

About Demo MCP

Demo: mcp protocol with simple client and server file

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_demo": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K