About MCP Client-Server
MCP Client-Server is a Python and Golang example of MCP client-server architecture over HTTP. It is aimed at developers learning the pattern and includes a remote server and a client that calls a tool.
Key features
- 01Demonstrates MCP client-server architecture
- 02Serves remotely over HTTP
- 03Includes a client tool-call example
Use cases
- 01Learn MCP communication over HTTP
- 02Test tool calls to a remote server
MCP support
The project demonstrates an MCP server and client communicating over HTTP. The server is available at http://0.0.0.0:8000/mcp by default, and the client calls its tool.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
http://0.0.0.0:8000/mcpclaude mcp add --transport http client-server-duaraghav8 http://0.0.0.0:8000/mcp{"mcpServers":{"client-server-duaraghav8":{"type":"http","url":"http://0.0.0.0:8000/mcp"}}}Open in Cursor{"servers":{"client-server-duaraghav8":{"type":"http","url":"http://0.0.0.0:8000/mcp"}}}Open in VS Code{"mcpServers":{"client-server-duaraghav8":{"type":"http","url":"http://0.0.0.0:8000/mcp"}}}{"mcpServers":{"client-server-duaraghav8":{"serverUrl":"http://0.0.0.0:8000/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEMCP Client-Server
The simplest example of MCP client-server architecture.
The server can be run as a remote MCP server serving HTTP requests.
Client consumes the remote server over HTTP.
Commands
One-time setup
# Setup virtualenv
python3 -m venv venv
source venv/bin/activate
# Download all dependencies using uv
uv install
First, activate the virtual environment:
source venv/bin/activate
Then proceed with the following:
- Start mcp server in dev mode to test out tools
mcp dev server.py
- Run the MCP server
python server.py
Accessible at http://0.0.0.0:8000/mcp by default
- Run the MCP client that calls a tool on server
python client.py
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.