Weather Service MCP Server

Un sistema simple para guardar notas con un esquema URI personalizado, que proporciona herramientas para agregar y resumir notas.

GitHub
5

Documentación

🌦️ Servidor MCP de Weather Service

🧩 Componentes

📚 Recursos

Este servidor implementa un sistema simple de almacenamiento de notas:

  • Acceso a notas individuales mediante un esquema URI personalizado note://
  • Cada recurso de nota tiene un nombre, una descripción y un tipo MIME text/plain

💡 Prompts

El servidor proporciona un único prompt:

  • summarize-notes: crea un resumen de todas las notas almacenadas
    • El argumento opcional "style" controla el nivel de detalle (brief/detailed)
    • Genera un prompt combinando todas las notas actuales y la configuración de estilo

🛠️ Herramientas

El servidor implementa una herramienta:

  • add-note: añade una nueva nota al servidor
    • Acepta "name" y "content" como argumentos de cadena obligatorios
    • Actualiza el estado del servidor y notifica a los clientes sobre los cambios en los recursos

🚀 Inicio rápido

📥 Instalación

Claude Desktop

Para MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Para Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuración para servidores en desarrollo/no publicados ``` "mcpServers": { "weather_service": { "command": "uv", "args": [ "--directory", "C:\Prj\weather_service", "run", "weather_service" ] } } ```
Configuración para servidores publicados ``` "mcpServers": { "weather_service": { "command": "uvx", "args": [ "weather_service" ] } } ```

👨‍💻 Desarrollo

🏗️ Compilación y publicación

Para preparar el paquete para su distribución:

  1. Sincroniza las dependencias y actualiza el archivo de bloqueo:
uv sync
  1. Compila la distribución del paquete:
uv build

Esto creará distribuciones de código fuente y wheel en el directorio dist/.

  1. Publica en PyPI:
uv publish

Nota: Las credenciales de PyPI deben configurarse mediante variables de entorno o banderas de comando:

  • Token: --token o UV_PUBLISH_TOKEN
  • O nombre de usuario/contraseña: --username/UV_PUBLISH_USERNAME y --password/UV_PUBLISH_PASSWORD

🔍 Depuración

Dado que el servidor MCP se ejecuta a través de stdio, puede ser difícil de depurar. Para una mejor experiencia de depuración, se recomienda encarecidamente usar MCP Inspector.

Puedes iniciar MCP Inspector con npm usando el siguiente comando:

npx @modelcontextprotocol/inspector uv --directory C:\Prj\weather_service run weather-service

Al iniciarse, Inspector mostrará una URL accesible desde el navegador para comenzar a depurar.