Advertise
MCP.so
Sign In

Demo MCP Server

@josx

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

josx

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

1

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.

2

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.

3

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.

4

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.

5

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

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Advertise