What is Mcp Server Experiments

mcp-server-experiments is a demonstration repository that showcases a modular client-server computation setup using Python. It simulates basic calculator functionalities and integrates with a lightweight SQLite backend for operation tracking and stateful processing.

Use cases

Use cases include demonstrating basic client-server interactions, simulating arithmetic operations in a controlled environment, and providing a framework for testing database-driven applications.

How to use

To use mcp-server-experiments, clone the repository, install the required dependencies, create a virtual environment, and run the demo using the provided Python scripts. You can also install specific modules using the MCP command.

Key features

Key features include modular Python components for client-server interaction, an SQLite-based server logic, an arithmetic calculator module, a simple interface for local testing, and a sample database for demonstration purposes.

Where to use

mcp-server-experiments can be used in educational settings for teaching client-server architecture, in software development for prototyping modular applications, and in data processing scenarios where lightweight database interactions are needed.

MCP Server Experiments

This is a demonstration repository showcasing a modular client-server computation setup using Python. It simulates basic calculator functionalities and integrates with a lightweight SQLite backend to track operations or simulate stateful processing.

🚀 Features

• Modular Python components for client-server interaction
• SQLite-based server logic (sqlite_server.py)
• Arithmetic calculator module with a client (calculator.py, calculator_client.py)
• Simple interface for local testing (main.py)
• Sample database (community.db) for demonstration
• Built with Python and configured via pyproject.toml

📁 Project Structure

mcp\_demo/
├── calculator.py             # Core arithmetic operations
├── calculator\_client.py      # Client code to interact with calculator
├── sqlite\_server.py          # Lightweight SQLite server module
├── main.py                   # Entry point for running the demo
├── community.db              # Prebuilt SQLite DB for demo use
├── greetings.txt             # Sample data file
├── pyproject.toml            # Python project configuration
├── .gitignore
└── .python-version

🛠️ Installation

1. Clone the repository:

   git clone https://github.com/codemaker2015/mcp-server-experiments.git
   cd mcp-server-experiments
   

2. Install uv

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   set Path=C:\Users\Codem\.local\bin;%Path%
   

3. Create a virtual environment.

   uv venv
   source .venv/bin/activate # for linux
   .venv\Scripts\activate    # for windows
   

4. Install dependencies (if specified in pyproject.toml or requirements file):

   uv add -r requirements.txt
   

🧪 Usage

• Install MCP server to Claude Desktop:

  mcp install calculator.py
  mcp install sqlite_server.py
  

• Directly test client-server simulations using MCP Inspector:

  mcp dev sqlite_server.py
  mcp dev calculator_client.py
  

📦 Demos

• MCP First Server

• MCP SQLite Server

• MCP Stock Price Server

• MCP Stock Analysis Server

• MCP Client