Local MCP Test Server

Name: Local MCP Test Server
Author: cserra16

Servidor MCP (Model Context Protocol) de pruebas locales que expone herramientas meteorológicas mediante transporte SSE, compatible con dispositivos móviles (iOS/Android).

Características

Transporte SSE para conexión desde apps móviles en red local
API Open-Meteo (gratuita, sin API key)
FastMCP para registro automático de herramientas
Compatible con Qwen 2.5 y otros LLMs

Stack Tecnológico

Componente	Tecnología
Lenguaje	Python 3.11+
Framework MCP	mcp[cli] + FastMCP
Cliente HTTP	httpx (async)
Servidor ASGI	uvicorn + starlette

Requisitos

Python 3.11+
pip o uv

Instalación

# Clonar repositorio git clone https://github.com/cserra16/local-mcp-test-server.git cd local-mcp-test-server # Crear entorno virtual python3 -m venv venv source venv/bin/activate # Instalar dependencias pip install -r requirements.txt

Ejecución

source venv/bin/activate python app.py

El servidor iniciará en http://0.0.0.0:8000 con transporte SSE.

Endpoints MCP

Método	Ruta	Descripción
GET	`/sse`	Handshake SSE (obtiene session_id)
POST	`/messages/?session_id=...`	Mensajes JSON-RPC

Herramientas Disponibles

`get_weather_lhospitalet`

Obtiene el clima actual de L'Hospitalet de Llobregat (Barcelona).

Triggers: El LLM invocará esta herramienta cuando el usuario pregunte por el clima en:

L'Hospitalet de Llobregat
Hospitalet
Hospi
L'Hospi
L'H

Retorna: Temperatura (°C), humedad relativa (%) y estado del cielo.

Ejemplo de respuesta:

Clima en L'Hospitalet de Llobregat: 18.5°C, Humedad: 65%, Estado del cielo: Parcialmente nublado. Datos provistos por Open-Meteo.

Pruebas

Con MCP Inspector (recomendado)

npx -y @modelcontextprotocol/inspector http://localhost:8000/sse

Test con Python

import asyncio from mcp import ClientSession from mcp.client.sse import sse_client async def test(): async with sse_client('http://localhost:8000/sse') as (read, write): async with ClientSession(read, write) as session: await session.initialize() result = await session.call_tool('get_weather_lhospitalet', {}) print(result.content[0].text) asyncio.run(test())

Desde el navegador

Acceder a http://localhost:8000/sse para verificar eventos SSE.

Conexión desde iOS

Asegúrate de que el iPhone esté en la misma red Wi-Fi
Obtén la IP local: ipconfig getifaddr en0
Conecta desde la app iOS a http://<IP-LOCAL>:8000/sse

Estructura del Proyecto

local-mcp-test-server/ ├── app.py # Servidor MCP principal ├── requirements.txt # Dependencias ├── pyproject.toml # Configuración del proyecto └── README.md