mcd-demo

@jspoelstra

About mcd-demo

Testing creation of simple MCP servers and integrating with LangChain agent

Config

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

{
  "mcpServers": {
    "mcd-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 mcd-demo?

mcd-demo is a project for testing the creation of simple MCP (Model Context Protocol) servers and integrating them with a LangChain agent. It is aimed at developers experimenting with MCP server implementations and LangChain agent integration.

How to use mcd-demo?

Set up a Python virtual environment, install dependencies from requirements.txt, and configure environment variables for Azure OpenAI API key and endpoint. Then start the three MCP servers (weather_server.py, math_server.py, telemetry_server.py) in the background, optionally running the math server via Docker, and finally launch the agent with python agent.py.

Key features of mcd-demo

Demonstrates creation of simple MCP servers
Integrates MCP servers with a LangChain agent
Includes weather, math, and telemetry server examples
Supports running math server in a Docker container
Uses SSE transport for MCP server communication

Use cases of mcd-demo

Learning how to build and run MCP servers
Testing LangChain agent integration with multiple MCP services
Experimenting with MCP server deployment (native or Docker)
Prototyping multi-server MCP architectures

FAQ from mcd-demo

What MCP servers are included?

Three servers: weather_server.py, math_server.py, and telemetry_server.py.

Can the math server be run in Docker?

Yes, you can build a Docker image with make build and run it with make run-local.

What environment variables are required?

AZURE_OPENAI_API_KEY and AZURE_OPENAI_ENDPOINT are required. Optionally, MCP_MATH_URI can be set to configure the math server URI.

How do I stop the MCP servers?

Use pkill -9 -f <server_script.py> on each server, e.g., pkill -9 -f weather_server.py.

Is there a .env file supported?

Yes, variables can be set in a .env file in the project root directory.

Frequently asked questions

What MCP servers are included?

Three servers: weather_server.py, math_server.py, and telemetry_server.py.

Can the math server be run in Docker?

Yes, you can build a Docker image with `make build` and run it with `make run-local`.

What environment variables are required?

`AZURE_OPENAI_API_KEY` and `AZURE_OPENAI_ENDPOINT` are required. Optionally, `MCP_MATH_URI` can be set to configure the math server URI.

How do I stop the MCP servers?

Use `pkill -9 -f <server_script.py>` on each server, e.g., `pkill -9 -f weather_server.py`.

Is there a .env file supported?

Yes, variables can be set in a `.env` file in the project root directory.

Comments

Basic information

More AI & Agents MCP servers

BlazingCDN MCP - Content Delivery for Video, Software & Static Files

BlazingCDN

Official MCP server for BlazingCDN - AI agents (Claude, Cursor, Windsurf) manage CDN resources, purge cache, query metrics, domains, Anycast CDN, Video CDN and Media CDN

PDI Bridge for Claude

jxrlabs

Connect Claude Desktop to your ServiceNow PDI. Query records, inspect Business Rules, review ACLs, and troubleshoot against your live instance.

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

CrawlForge MCP Server

mysleekdesigns

28-tool MCP server for web scraping, crawling, deep research & autonomous extraction — clean Markdown & structured JSON for Claude, Cursor & any MCP client. 1,000 free one-time credits, local-Ollama LLM support.

Mcp Agent

lastmile-ai

Build effective agents using Model Context Protocol and simple workflow patterns

8.4K