MCP.so
Sign In

Understanding MCP Architecture: Single-Server vs Multi-Server Clients

@commitbyrajat

Repository

About Understanding MCP Architecture: Single-Server vs Multi-Server Clients

MCP architecture demo with single-server & multi-server clients using LangGraph, AI-driven tool calls, and async communication.

#mathgpt#math-solver#math-assistant

Basic information

Category

Reasoning

Runtime

python

Transports

stdio

Publisher

commitbyrajat

Config

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

{
  "mcpServers": {
    "langgraph-mcp-integration": {
      "command": "python",
      "args": [
        "server/weather_server.py"
      ]
    }
  }
}

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 Understanding MCP Architecture: Single-Server vs Multi-Server Clients?

This blog post explains the Multi-Client Protocol (MCP) architecture by comparing single-server and multi-server clients. It provides example MCP servers for math operations and weather information, along with client scripts that use LangGraph’s ReAct agent and GPT‑4o to invoke tools. It is intended for developers building AI‑driven applications that need to interact with multiple external services.

How to use Understanding MCP Architecture: Single-Server vs Multi-Server Clients?

Clone the repository, sync dependencies with rye sync, start the weather server (rye run python server/weather_server.py), then run either rye run python client/single_server_client.py or rye run python client/multi_server_client.py. The blog shows how to define MCP servers using FastMCP and clients using MultiServerMCPClient with stdio and SSE transports.

Key features of Understanding MCP Architecture: Single-Server vs Multi-Server Clients

  • Example Math server with add and multiply tools
  • Example Weather server with a get_weather tool
  • Single‑server client using stdio transport
  • Multi‑server client supporting both stdio and SSE transports
  • Integration with LangGraph ReAct agent and GPT‑4o model
  • Sequence diagram illustrating the full MCP communication flow

Use cases of Understanding MCP Architecture: Single-Server vs Multi-Server Clients

  • Solving a mathematical expression by invoking a remote math server
  • Querying current weather from a dedicated weather server
  • Running both math and weather queries concurrently through a multi‑server client

FAQ from Understanding MCP Architecture: Single-Server vs Multi-Server Clients

What transports do the example servers use?

The Math server runs with stdio transport; the Weather server runs with SSE (Server‑Sent Events) transport.

How do I start the servers?

Run python server/math_server.py (uses stdio) and python server/weather_server.py (uses SSE). The blog shows starting the weather server in the background with &.

What tools are available on the example servers?

The Math server exposes add(a, b) and multiply(a, b). The Weather server exposes get_weather(location) which returns a hardcoded sunny string.

What dependencies are required?

The repository uses rye for dependency management. You must run rye sync before executing the scripts. The code also relies on mcp, langgraph, and other Python packages.

Can I use the multi‑server client with other MCP servers?

Yes. The MultiServerMCPClient dictionary accepts any number of server configurations with command/args (for stdio) or url (for SSE) and transport. This allows connecting to arbitrary MCP servers.

Comments

More Reasoning MCP servers

Unified MCP Suite

Godzilla675

A suite of Model Context Protocol (MCP) servers designed to enhance AI agent capabilities. Provides tools for media search/understanding (images, video), web information retrieval, PDF generation, and PowerPoint presentation creation, enabling agents to interact with diverse data

19

Task Planner MCP Server

CaptainCrouton89

An MCP (Model Context Protocol) server that helps AI assistants (like Claude) break down complex tasks into manageable steps, track progress, and manage a hierarchical task list.

13

MCP Sandbox

danstarns

Turn any JavaScript module into a sandboxed MCP (Model Context Protocol) server with automatic reflection and type inference.

5

n8n - Secure Workflow Automation for Technical Teams

n8n-io

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

195.5K

MCP Servers

junfanz1

This project demonstrates a decoupled real-time agent architecture that connects LangGraph agents to remote tools served by custom MCP (Modular Command Protocol) servers. The architecture enables a flexible and scalable multi-agent system where each tool can be hosted independent

27