https://github.com/duaraghav8/mcp-client-server

Simplest example of MCP client-server architecture over HTTP using Python & Golang
https://github.com/duaraghav8/mcp-client-server

mcp python

Last synced: 24 days ago
JSON representation

Simplest example of MCP client-server architecture over HTTP using Python & Golang

• Host: GitHub
• URL: https://github.com/duaraghav8/mcp-client-server
• Owner: duaraghav8
• Created: 2025-05-16T13:26:23.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-09-16T14:35:55.000Z (about 2 months ago)
• Last Synced: 2025-09-30T21:51:40.404Z (about 1 month ago)
• Topics: mcp, python
• Language: Go
• Homepage:
• Size: 1.54 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-mcp-servers - **mcp-client-server** - Simplest example of MCP client-server architecture over HTTP using Python & Golang `go` `mcp` `python` `server` `http` `go install duaraghav8/mcp-client-server@latest` (AI/ML)
• awesome-mcp-servers - **mcp-client-server** - Simplest example of MCP client-server architecture over HTTP using Python & Golang `go` `mcp` `python` `server` `http` `go install duaraghav8/mcp-client-server@latest` (AI/ML)

README

          
# MCP 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:

1. Start mcp server in dev mode to test out tools

```

mcp dev server.py

```

2. Run the MCP server

```

python server.py

```

Accessible at http://0.0.0.0:8000/mcp by default

3. Run the MCP client that calls a tool on server

```

python client.py

```