README.md

March 28, 2025 ยท View on GitHub

System Requirements

  • Python 3.10 or higher
  • MCP SDK 1.2.0 or higher
  • uv package manager

Getting Started

Installing uv Package Manager

On MacOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Make sure to restart your terminal afterwards to ensure that the uv command gets picked up.

Project Setup

  1. Clone the project
  2. Install the dependencies
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
# Install dependencies
uv add "mcp[cli]"

Setting up the Reciever

  1. Run reciever.py in another terminal

Running the Server

  1. Start the MCP server:
uv run sender.py
  1. The server will start and be ready to accept connections

Connecting to Claude Desktop

  1. Install Claude Desktop from the official website
  2. Configure Claude Desktop to use your MCP server:

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-server": {
            "command": "uv",  # ALWAYS USE THE ABSOLUTE PATH
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/YOUR/server",
                "run",
                "server.py"
            ]
        }
    }
}
  1. Restart Claude Desktop

Now, ask Claude to send the time.

BOOM!!!