Weather Service MCP Server

🧩 Componentes

📚 Recursos

Este servidor implementa um sistema simples de armazenamento de notas:

• Acesse notas individuais por meio do esquema de URI personalizado note://
• Cada recurso de nota possui nome, descrição e tipo MIME text/plain

💡 Prompts

O servidor fornece um único prompt:

• summarize-notes: cria um resumo de todas as notas armazenadas
  • O argumento opcional "style" controla o nível de detalhe (brief/detailed)
  • Gera o prompt combinando todas as notas atuais com a configuração de estilo

🛠️ Ferramentas

O servidor implementa uma ferramenta:

• add-note: adiciona uma nova nota ao servidor
  • Recebe "name" e "content" como argumentos de string obrigatórios
  • Atualiza o estado do servidor e notifica os clientes sobre alterações nos recursos

🚀 Início Rápido

📥 Instalação

Claude Desktop

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

Configuração para servidores em desenvolvimento/não publicados

``` "mcpServers": { "weather_service": { "command": "uv", "args": [ "--directory", "C:\Prj\weather_service", "run", "weather_service" ] } } ```

Configuração para servidores publicados

``` "mcpServers": { "weather_service": { "command": "uvx", "args": [ "weather_service" ] } } ```

👨‍💻 Desenvolvimento

🏗️ Build e Publicação

Para preparar o pacote para distribuição:

1. Sincronize as dependências e atualize o arquivo de bloqueio:

uv sync

2. Compile a distribuição do pacote:

uv build

Isso criará distribuições de origem e wheel no diretório dist/.

3. Publique no PyPI:

uv publish

Observação: as credenciais do PyPI devem ser definidas por meio de variáveis de ambiente ou flags de comando:

• Token: --token ou UV_PUBLISH_TOKEN
• Ou nome de usuário/senha: --username/UV_PUBLISH_USERNAME e --password/UV_PUBLISH_PASSWORD

🔍 Depuração

Como o servidor MCP é executado via stdio, a depuração pode ser desafiadora. Para a melhor experiência de depuração, é altamente recomendável usar o MCP Inspector.

Você pode iniciar o MCP Inspector com o seguinte comando usando npm:

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

Ao iniciar, o Inspector exibirá uma URL acessível no navegador para você começar a depurar.