MCP.so
Sign In

Demo MCP

@josx

Repository

About Demo MCP

Demo: mcp protocol with simple client and server file

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.

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

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

josx

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

ICSS

chokcoco

不止于 CSS

20.7K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.