Demo MCP Server

@josx

Basic information

About Demo MCP Server

Demo: mcp protocol with simple client and server file

Demo MCP Server config

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

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

Demo MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

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

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

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

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one