MCP ExplorerExplorer

Mcp Proving Ground Client

@jlmelison 10 months ago
1 MIT
FreeCommunity
AI Systems
A Python client for testing MCP servers, avoiding message limits.

Overview

What is Mcp Proving Ground Client

The MCP Proving Ground Client is a Python-based client designed for interacting with the MCP API, primarily aimed at testing custom MCP servers while avoiding message limits encountered with other clients.

Use cases

Use cases include testing custom MCP server implementations, experimenting with server functionalities using the provided sample server, and developing new features for MCP servers.

How to use

To use the MCP Proving Ground Client, install the required dependencies, create a virtual environment, and run the client using the command ‘uv run main.py’. Ensure to configure the MCP Server in ‘config.yaml’ and add your Deepseek API key in a ‘.env’ file.

Key features

Key features include a simple interface for testing MCP servers, the ability to avoid message limits, and a sample server included for demonstration purposes.

Where to use

The MCP Proving Ground Client is suitable for developers and testers working with MCP servers, particularly in environments where custom server testing is required.

Content

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers