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

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K

欢迎来到智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797