MCP Proving Ground Client
- other
About
What is MCP Proving Ground Client?
It is a Python-based client for interacting with the MCP API, designed primarily to test custom MCP servers and avoid message limits encountered with other clients like Claude Desktop.
How to use MCP Proving Ground Client?
Install uv, clone the repository, create and activate a virtual environment, run uv pip install ., create a .env file with your Deepseek API key, then run uv run main.py. Edit config.yaml to configure the MCP server.
Key features of MCP Proving Ground Client
- Python-based for cross-platform compatibility
- Tests custom MCP servers without message limits
- Configurable via a YAML configuration file
- Includes a sample weather server for experimentation
- Open-source with contributions welcome
Use cases of MCP Proving Ground Client
- Testing custom MCP servers during development
- Prototyping MCP-based tools and integrations
- Experimenting with MCP server implementations
FAQ from MCP Proving Ground Client
What does this client do that alternatives (like Claude Desktop) don’t?
It is specifically built to test custom MCP servers without hitting the message limits that can occur in Claude Desktop.
What platforms or models are supported?
The client requires a Python environment and a Deepseek API key; it uses the Deepseek model.
Can I use my own MCP servers with it?
Yes, edit the config.yaml file to point to your own MCP server.
Is this project free or licensed?
—
Are there any known limitations?
The project is in early active development; there may be bugs, missing features, and breaking changes.
Details
- Author
- jlmelis
- GitHub stars
- 1
- Category
- other
- Repository
- jlmelis/mcp-proving-ground-client
MCP Proving Ground Client
Overview
The MCP Proving Ground Client is a Python-based client for interacting with the MCP API. This project is primarily being developed to provide a simple MCP Client that can be used to test custom MCP servers, helping to avoid message limits encountered with other clients like Claude Desktop.
Installation
1. Install uv
2. Clone this repository
3. Run uv venv to create a virtual environment
4. Activate the virtual environment
5. Run uv pip install .
6. Create a .env file and add your Deepseek API key:
DEEPSEEK_API_KEY=your_api_key_here
Usage
Run the client with:
uv run main.py
Configuration
Edit config.yaml to configure the MCP Server.
Sample Server
A sample server weather.py is included in this repository, based on the quickstart example from the Model Context Protocol documentation. This server demonstrates basic MCP server functionality and can be used for testing and experimentation.
Development Status
This project is currently in early active development. There may be bugs, missing features, and breaking changes. Please report any issues you encounter.
Contributing
1. Fork the repository
2. Create a new branch
3. Make your changes
4. Submit a pull request