Servidor MCP

Un servidor extensible del Protocolo de Contexto de Modelo (MCP) con herramientas de clima y hora. Creado para aprender: conéctalo a Claude Desktop y empieza a chatear.

Primeros pasos

1. Clonar e instalar

git clone <repo-url> && cd mcp-server
python3 -m venv .venv
source .venv/bin/activate   # macOS / Linux / WSL
pip install -e .

O con uv:

git clone <repo-url> && cd mcp-server
uv venv
source .venv/bin/activate
uv pip install -e .

2. Conectar a Claude Desktop

Ejecuta el script de configuración para escribir automáticamente el archivo de configuración de Claude Desktop:

macOS:

python setup_claude_agent.py

Esto escribe ~/Library/Application Support/Claude/claude_desktop_config.json apuntando al .venv/bin/python de tu proyecto.

Si tu proyecto se encuentra en una ubicación no estándar, pásala explícitamente:

python setup_claude_agent.py --project-path /path/to/mcp-server

Windows (vía WSL):

python3 setup_claude_agent.py --windows --win-user <YourWindowsUser> --wsl-user <YourWSLUser>

Por ejemplo:

python3 setup_claude_agent.py --windows --win-user Cam --wsl-user cam

Esto escribe %APPDATA%\Claude\claude_desktop_config.json y configura Claude Desktop para iniciar el servidor a través de WSL.

3. Reiniciar Claude Desktop

Cierra y vuelve a abrir Claude Desktop. Para verificar que el servidor está conectado, ve a Settings → Developer (Ajustes → Desarrollador); deberías ver mcp-server con una insignia verde de running (en ejecución).

4. Pruébalo

Pregúntale a Claude cualquiera de las siguientes cosas:

• "What time is it?" (¿Qué hora es?) — utiliza la herramienta get_current_time

• "Get weather alerts for California" (Obtén alertas meteorológicas para California) — utiliza el recurso weather://alerts/CA

• "What's the forecast for latitude 40.7128, longitude -74.0060?" (¿Cuál es el pronóstico para la latitud 40.7128, longitud -74.0060?) — utiliza el recurso de pronóstico

No necesitas iniciar el servidor manualmente: Claude Desktop lo inicia automáticamente.

Related MCP server: mcp-weather

Herramientas y recursos disponibles

Añadir tus propias herramientas

Abre src/mcp_server/server.py y añade una función con el decorador @mcp.tool():

@mcp.tool()
async def my_tool(param: str) -> str:
    """Description of what this tool does."""
    return f"Result for {param}"

Reinicia Claude Desktop para aplicar el cambio.

Para recursos y prompts, consulta CONTRIBUTING.md.

Ejecutar pruebas

pip install -e ".[dev]"   # or: uv pip install -e ".[dev]"
pytest

Estructura del proyecto

src/mcp_server/
├── server.py              # MCP server entry point — register tools here
└── tools/
    ├── weather/           # Weather alerts & forecasts (NWS API)
    ├── time/              # IP-based timezone & current time
    └── conversation/      # Conversation tools

Licencia

MIT

Recursos

• Documentación del Protocolo de Contexto de Modelo

• API del Servicio Meteorológico Nacional

• Creación de un servidor MCP