About python-pip-mcp
python-pip-mcp is a minimal Python reference implementation of an Anthropic MCP client and server. It is aimed at developers who want to debug both sides in VSCode on Windows.
Key features
- 01Python MCP client and server example
- 02Pip-based setup
- 03VSCode debugging support
- 04Windows-tested reference project
Use cases
- 01Learning a basic MCP client-server implementation
- 02Debugging MCP code in VSCode on Windows
MCP support
The project demonstrates both an Anthropic MCP client and server in Python; the README does not describe specific tools or resources exposed by the server.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEpython-pip-mcp
Minimal Example Implementation of an Anthropic MCP Client and Server in Python with Pip.
The goal of this repository is to provide a reference implementation of a mcp client and server that can be easily debugged in VSCode on Windows using the Python / Python Debugger extension.
Alternative IDEs and OS are not tested but should work with minimal adjustments, too.
Installation
# create venv
python -m venv myenv
myenv\Scripts\activate
# install requirements
pip install -r requirements.txt
# create a .env file and set your anthropic api key
cp .env.sample .env
# run mcp_client.py script
python mcp_client.py
# query for current time
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.