MCP Demo logo

MCP Demo

by sunithvs

This repository contains the MCP (Model Control Protocol) demonstration project. It provides a basic structure and setup for running and testing an MCP application.

View on GitHub

Last updated: N/A

MCP Demo

This repository contains the MCP (Model Control Protocol) demonstration project.

Project Structure

mcp-demo/
├── main.py         # Main application entry point
├── tools/          # Utility tools and helper functions
├── tests/          # Test suite
├── .env           # Environment variables (not tracked in git)
└── pyproject.toml  # Project dependencies and configuration

Setup

  1. Clone the repository:

    git clone <repository-url>
    cd mcp-demo
    
  2. Install uv (if not already installed):

    curl -LsSf https://astral.sh/uv/install.sh | sh
    
  3. Create and activate virtual environment using uv:

    uv venv
    source .venv/bin/activate  # On Unix/macOS
    # OR
    .venv\Scripts\activate     # On Windows
    
  4. Install dependencies using uv:

    uv pip install -e .
    
  5. Configure environment variables:

    cp .env.example .env
    # Edit .env with your configuration
    

Running the Application

  1. Activate the virtual environment (if not already activated):

    source .venv/bin/activate  # On Unix/macOS
    # OR
    .venv\Scripts\activate     # On Windows
    
  2. Run the main application:

    python main.py
    

Running Tests

To run the test suite:

pytest

Development

This project uses:

  • Python for the core implementation
  • uv for dependency management and virtual environments
  • pytest for testing
  • pyproject.toml for project configuration

License

[Add your license information here]