MCP Lab

Name: MCP Lab
Author: LPFerreira33

@LPFerreira33

About MCP Lab

This repository contains a modular setup for experimenting with MCP in Python. It includes both a server and a client, as well as reusable tool modules.

#mcp-lab #modular-setup #python-experimentation

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-lab-lpferreira33": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Lab?

MCP Lab is a modular Python project for experimenting with the Model Context Protocol (MCP). It provides both an MCP server and client, along with reusable tool modules that are automatically registered by the server. It is intended for developers who want to explore or build MCP-based applications.

How to use MCP Lab?

Clone the repository, then set up and run the server by navigating to mcp_server, creating a virtual environment, installing dependencies with uv pip install -r requirements.txt, and running uv run server.py. For the client, navigate to mcp_client, similarly install dependencies, edit the .env file to match the server’s IP and port, then run python client.py.

Key features of MCP Lab

Modular Python setup for MCP experimentation
Includes both server and client implementations
Reusable tool modules are auto-registered
Easy to add custom tools as Python functions
Uses uv for fast dependency management
MIT licensed

Use cases of MCP Lab

Testing and prototyping MCP server-tool interactions
Learning how to build MCP servers with Python
Developing and debugging MCP clients
Experimenting with custom tool integrations

FAQ from MCP Lab

What does MCP Lab do?

MCP Lab provides a complete modular environment for experimenting with the Model Context Protocol in Python, including a server, client, and pluggable tool modules.

What runtime requirements does MCP Lab have?

It requires Python 3 with venv and uv installed. Dependencies are listed in requirements.txt files for both server and client.

How can I add my own tools to the server?

Create new Python functions inside the mcp_server/tools/ directory; they are automatically registered by the server.

Is a client included?

Yes, a client implementation is provided in the mcp_client/ directory, with its own setup and configuration.

How does the client connect to the server?

You must edit the .env file in the client directory to specify the server's IP address and port. The default values may need to be changed to match your setup.