Local MCP Test Server

You run a local MCP Test Server that exposes weather tools over SSE so mobile apps can connect in your local network. It integrates Open-Meteo data and auto-registers tools, enabling you to test conversations with an MCP-enabled model and verify real-time tool invocations on devices like iOS and Android.

How to use

Connect with an MCP client to the local server to invoke tools and receive responses via SSE. You will handshake with the server to obtain a session, then send tool calls and receive streaming responses. Use this setup to test weather-related queries and validate end-to-end tool execution in a local network.

How to install

Prerequisites you need before installing and running the server:

• Python 3.11+
• pip or uv (virtual environment tool)

Step-by-step commands to set up and run the server locally:

# Clone the repository
git clone https://github.com/cserra16/local-mcp-test-server.git
cd local-mcp-test-server

# Create a virtual environment
python3 -m venv venv

# Activate the virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Endpoints you will use

The server exposes two MCP endpoints for client interaction. Use these to establish a session and send tool calls from your MCP client.

GET /sse
POST /messages/?session_id=...

Where to access the server during development

Start the server to listen on all interfaces so it can be reached by devices on the same local network. The server will run with Server-Sent Events (SSE) transport.

Available tools

get_weather_lhospitalet

Obtains the current weather for L'Hospitalet de Llobregat, returning temperature in °C, relative humidity, and sky condition. Triggered when users ask about the weather in L'Hospitalet de Llobregat, Hospitalet, Hospi, L'Hospi, or L'H.