MCP.so
Sign In

Demo MCP

@josx

Repository

About Demo MCP

Demo: mcp protocol with simple client and server file

Basic information

Category

Other

License

Apache-2.0

Runtime

python

Transports

stdio

Publisher

josx

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

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Awesome Mcp Servers

punkpeye

A collection of MCP servers.

90.5K

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

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K