MCP.so
Sign In

mcd-demo

@jspoelstra

Repository

About mcd-demo

Testing creation of simple MCP servers and integrating with LangChain agent

Basic information

Category

AI & Agents

License

MIT license

Runtime

python

Transports

stdio

Publisher

jspoelstra

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.

Comments

More AI & Agents MCP servers

LinkedIn MCP Server

stickerdaniel

Open-source MCP server for LinkedIn. Give Claude and any MCP-compatible AI agent access to profiles, companies, jobs, and messages.

2.7K

Perplexity MCP Server

DaInfernalCoder

A Model Context Protocol (MCP) server for research and documentation assistance using Perplexity AI. Won 1st @ Cline Hackathon

295

MCP Server - Remote MacOs Use

baryhuang

The only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App

487

Solon Ai

opensolon

Java AI application development framework (supports LLM-tool,skill; RAG; MCP; Agent-ReAct,Team-Agent). Compatible with java8 ~ java25. It can also be embedded in SpringBoot, jFinal, Vert.x, Quarkus, and other frameworks.

416

1MCP - One MCP Server for All

1mcp-app

A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.

468