MCP Server Tempo

MCPAI代理

提供方 eltonmesquita87

AI代理 未标注 API Key 社区 / 第三方 Claude DesktopClaude

一个基于Clean Architecture的天气数据服务,为Claude AI提供实时天气查询功能,适用于需要实时天气数据的AI应用场景。

一句话选型结论

按资料字段整理

MCP Server Tempo 属于AI代理类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

天气服务TypeScript本地部署AI扩展实时数据CleanArchitectureMCP协议

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Server Tempo当前 4 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方eltonmesquita87上游标注的维护方 eltonmesquita87
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

14.7 KB
来自项目仓库与上游目录的原文,未做删改

🌤️ Weather MCP Server - Clean Architecture Edition [Docker + Redis]

Servidor MCP de Clima com Clean Architecture para Claude Desktop - Production Ready

Claude AI transformado em estação meteorológica profissional usando princípios SOLID

🎉 VERSÃO ATUAL: 2.0.0 - Clean Architecture Completa
✅ Refatoração concluída • ✅ Zero legacy code • ✅ Production ready

📊 Status do Projeto

Aspecto Status Descrição
Build TypeScript compilation + Docker build
Tests Unit tests + Integration tests
Security Trivy vulnerability scan + npm audit
Docker Multi-stage build otimizado
Deploy CI/CD pipeline automatizado

🔄 CI/CD Pipeline

Este projeto implementa um pipeline CI/CD completo com GitHub Actions:```yaml
🔍 Lint & Type Check → 🧪 Tests → 🏗️ Build → 🔒 Security → 🐳 Docker → 🚀 Deploy


**Pipeline Stages:**
- **🔍 Lint & Type Check**: ESLint + TypeScript compilation check
- **🧪 Tests**: Unit tests com mocks + Integration tests com PostgreSQL/Redis
- **🏗️ Build**: TypeScript compilation + artifact generation
- **🔒 Security**: Trivy vulnerability scanner + npm audit
- **🐳 Docker**: Multi-stage build + push to GitHub Container Registry
- **🚀 Deploy**: Automated deployment para staging/production

**Comandos de Teste Locais:**```bash
npm run test:unit        # Tests unitários (sem dependências)
npm run test:integration # Tests de integração (requer Docker)
npm run test:ci          # Tests para CI com coverage

🎯 O que é este projeto?

O Weather MCP Server é um servidor Model Context Protocol (MCP) que expande as capacidades do Claude Desktop, permitindo que ele consulte informações meteorológicas em tempo real de qualquer lugar do mundo usando uma arquitetura limpa e profissional.

🧠 Entendendo o MCP (Model Context Protocol)

O MCP é um protocolo desenvolvido pela Anthropic que permite ao Claude AI:
- 🔌 Conectar-se a APIs externas e bancos de dados
- 🛠️ Usar ferramentas personalizadas criadas pela comunidade
- 📊 Acessar dados em tempo real que não estão em seu conhecimento base
- 🎮 Executar ações específicas através de plugins

Em outras palavras: O MCP transforma o Claude de uma IA com conhecimento limitado em uma IA que pode acessar informações atualizadas do mundo real!

🌟 Funcionalidades Disponíveis

🎯 Funcionalidade 📋 Descrição 💡 Exemplo de Uso
🌡️ Clima Atual Consulta temperatura, umidade, pressão e condições meteorológicas atuais "Qual é a temperatura atual em São Paulo?"
🔮 Previsão do Tempo Fornece previsões detalhadas para os próximos 5 dias "Como estará o clima amanhã em Londres?"
📊 Histórico Meteorológico Mantém registro de todas as consultas realizadas "Mostre-me as últimas consultas de clima que fiz"
⚡ Cache Inteligente Sistema Redis para consultas ultrarrápidas 95% das consultas vêm do cache

🚀 Demonstração Prática

Antes (Claude Desktop sem MCP):```

🙋 Você: "Qual é a temperatura atual em Tóquio?"
🤖 Claude: "Desculpe, não tenho acesso a dados meteorológicos em tempo real..."


### **Depois** (Claude Desktop com Weather MCP Server):```
🙋 Você: "Qual é a temperatura atual em Tóquio?"
🤖 Claude: "🌤️ Em Tóquio agora:
🌡️ Temperatura: 23°C (sensação térmica: 25°C)
💧 Umidade: 68%
🌬️ Vento: 12 km/h
☁️ Condições: Parcialmente nublado
📊 Dados atualizados em tempo real via OpenWeatherMap"

🏗️ Arquitetura Clean + SOLID```mermaid

graph TB
subgraph "🎮 Presentation Layer"
A[👤 Claude Desktop] --> B[🤖 MCP Server]
B --> C[🎮 Weather Controller]
B --> D[🎮 History Controller]
end

subgraph "🔧 Application Layer (Use Cases)"
C --> E[🌤️ Get Weather Use Case]
C --> F[🔮 Get Forecast Use Case]
C --> G[📊 Get Cache Stats Use Case]
D --> H[📚 Get History Use Case]
end

subgraph "🏛️ Domain Layer"
E --> I[⚡ Weather Entity]
F --> I
H --> J[📊 History Entity]
K[🔗 Repository Interfaces]
end

subgraph "🏗️ Infrastructure Layer (Adapters)"
E --> L[🌍 OpenWeather API Repository]
E --> M[🗄️ PostgreSQL Repository]
E --> N[⚡ Redis Cache Repository]
F --> L
F --> N
H --> M
L --> O[🌤️ OpenWeatherMap API]
M --> P[🗄️ PostgreSQL Database]
N --> Q[⚡ Redis Cache]
end


### **✅ Princípios SOLID Aplicados:**

| 🔤 **Princípio** | ✅ **Como foi aplicado** | 💡 **Benefício** |
|:----------------:|:------------------------:|:----------------:|
| **S** - Single Responsibility | Cada classe tem apenas uma responsabilidade | Código mais limpo e focado |
| **O** - Open/Closed | Extensível via interfaces, fechado para modificação | Fácil adicionar novas APIs |
| **L** - Liskov Substitution | Implementações intercambiáveis via contratos | Flexibilidade total |
| **I** - Interface Segregation | Interfaces pequenas e específicas | Sem dependências desnecessárias |
| **D** - Dependency Inversion | Dependências injetadas via abstrações | Testabilidade e desacoplamento |

---

## 📋 **Pré-requisitos**

### **🔧 Software Necessário:**

| 📦 **Software** | 📏 **Versão Mínima** | 🔗 **Download** | ✅ **Verificar** |
|:---------------:|:--------------------:|:---------------:|:----------------:|
| **Node.js** | 18.0+ | nodejs.org | `node --version` |
| **Docker Desktop** | Mais recente | docker.com | `docker --version` |
| **Claude Desktop** | Mais recente | claude.ai/download | Abrir aplicativo |
| **Git** | Qualquer | git-scm.com | `git --version` |

### **🔑 Chaves de API:**

1. **🌍 OpenWeatherMap API Key (GRATUITA)**
- 🔗 Acesse: openweathermap.org/api
- 📝 Crie uma conta gratuita
- 🗝️ Obtenha sua API key (sem custo)
- 💡 Permite 1.000 consultas por dia grátis

---

## 📥 **Instalação Completa**

### **🗂️ Passo 1: Baixar o Projeto**```bash
# Clonar repositório
git clone https://github.com/glaucia86/weather-mcp-server.git

# Entrar na pasta
cd weather-mcp-server

# Verificar estrutura
ls -la

📦 Passo 2: Instalar Dependências```bash

Instalar pacotes Node.js

npm install

Verificar instalação

npm list --depth=0


### **⚙️ Passo 3: Configurar Ambiente**

#### **Criar arquivo `.env`:**```bash
# Copiar exemplo
cp .env.example .env

Configuração do .env:```env

🌍 API do OpenWeatherMap (OBRIGATÓRIO)

WEATHER_API_KEY=sua_api_key_aqui

🗄️ Banco de Dados (PostgreSQL)

DATABASE_URL=postgresql://mcp_user:mcp_pass@localhost:5432/weather_mcp

⚡ Cache (Redis)

REDIS_URL=redis://localhost:6379

🖥️ Configurações do Servidor

PORT=3000
NODE_ENV=production
LOG_LEVEL=info


### **🔨 Passo 4: Compilar e Iniciar**```bash
# Compilar TypeScript
npm run build

# Iniciar infraestrutura (PostgreSQL + Redis)
npm run docker:up

# Aguardar inicialização
sleep 30

# Testar sistema
npm run test:manual

🎮 Configuração do Claude Desktop

📍 Localizar Arquivo de Configuração:

🖥️ Sistema 📂 Caminho do Arquivo
Windows %APPDATA%\Claude\claude_desktop_config.json
macOS ~/Library/Application Support/Claude/claude_desktop_config.json
Linux ~/.config/Claude/claude_desktop_config.json

⚙️ Configuração:```json

{
"mcpServers": {
"weather-mcp": {
"command": "node",
"args": ["/caminho/completo/para/weather-mcp-server/dist/mcp-entry.js"],
"env": {
"WEATHER_API_KEY": "SUA_API_KEY_OPENWEATHERMAP",
"DATABASE_URL": "postgresql://mcp_user:mcp_pass@localhost:5432/weather_mcp",
"REDIS_URL": "redis://localhost:6379",
"NODE_ENV": "production",
"LOG_LEVEL": "error",
"MCP_MODE": "true"
}
}
}
}


### **⚠️ IMPORTANTE:**
- **Substitua** `/caminho/completo/para/` pelo seu caminho real
- **Substitua** `SUA_API_KEY_OPENWEATHERMAP` pela sua chave OpenWeatherMap
- **Feche COMPLETAMENTE** o Claude Desktop e reabra após salvar

---

## 🎪 **Como Usar**

### **1️⃣ Consultas de Clima Atual**```
💬 "Qual é o clima atual em São Paulo?"
💬 "Como está o tempo em Londres agora?"
💬 "Temperatura atual no Rio de Janeiro"

2️⃣ Previsões do Tempo```

💬 "Qual será a previsão do tempo para amanhã em Paris?"
💬 "Como estará o clima nos próximos 3 dias em Tokyo?"
💬 "Previsão de 5 dias para London"


### **3️⃣ Histórico e Análises**```
💬 "Me mostre o histórico de consultas meteorológicas"
💬 "Quais foram as últimas cidades que consultei?"
💬 "Histórico de clima de São Paulo dos últimos 10 registros"

4️⃣ Estatísticas do Sistema```

💬 "Mostre as estatísticas do cache Redis"
💬 "Qual é a performance do sistema?"


---

## 🛠️ **Scripts Disponíveis**

| 🎯 **Finalidade** | 💻 **Comando** | 📋 **Descrição** |
|:-----------------:|:--------------:|:----------------:|
| **Start Server** | `npm start` | Servidor principal |
| **MCP Server** | `npm run start:mcp` | Servidor MCP para Claude Desktop |
| **Build** | `npm run build` | Compila TypeScript |
| **Test MCP** | `npm run test:manual` | Testa servidor MCP |
| **Dev Mode** | `npm run dev` | Desenvolvimento com hot-reload |
| **Clean** | `npm run clean` | Remove builds anteriores |
| **Docker Up** | `npm run docker:up` | Inicia PostgreSQL + Redis |
| **Docker Down** | `npm run docker:down` | Para containers |
| **Migrate** | `npm run migrate` | Executa migrações de banco |

---

## 🏗️ **Estrutura do Projeto**```
src/
├── 🏛️ domain/                    # Camada de Domínio (Business Rules)
│   ├── entities/                # Entidades do domínio
│   │   └── Weather.ts          # Modelos meteorológicos
│   └── repositories/           # Contratos/Interfaces
│       └── IRepositories.ts    # Interfaces dos repositórios
│
├── 🔧 application/              # Camada de Aplicação (Use Cases)
│   └── usecases/               # Casos de uso específicos
│       ├── GetCurrentWeatherUseCase.ts
│       ├── GetWeatherForecastUseCase.ts
│       ├── GetWeatherHistoryUseCase.ts
│       └── GetCacheStatisticsUseCase.ts
│
├── 🏗️ infrastructure/          # Camada de Infraestrutura (Adapters)
│   ├── logger/                 # Sistema de logging
│   │   └── Logger.ts
│   ├── repositories/           # Implementações dos repositórios
│   │   ├── PostgreSQLWeatherRepository.ts
│   │   ├── RedisCacheRepository.ts
│   │   └── OpenWeatherMapApiRepository.ts
│   └── di/                     # Dependency Injection
│       └── DIContainer.ts
│
├── 🎮 presentation/             # Camada de Apresentação
│   ├── controllers/            # Controllers
│   │   ├── WeatherController.ts
│   │   └── HistoryController.ts
│   └── servers/               # Servidores
│       └── WeatherMCPServer.ts
│
├── 🛡️ middleware/              # Middleware de Segurança
│   └── security.ts
│
├── 📊 monitoring/              # Monitoramento
│   └── health.ts
│
├── 🧪 scripts/                 # Scripts Utilitários (3 essenciais)
│   ├── benchmark-cache.ts     # Benchmark de performance
│   ├── migrate.ts            # Migração de banco
│   └── test-mcp-server.ts    # Teste do servidor MCP
│
├── index.ts                   # Entry point principal
└── mcp-entry.ts              # Entry point MCP

⚡ Performance e Cache

📈 Métricas de Performance Reais:

📊 Métrica ⚡ Com Cache 🐌 Sem Cache 🎯 Melhoria
Resposta API 23ms 315ms 13.6x mais rápido
Taxa de Acerto 95% 0% Economia massiva
Chamadas API 5 (em 50 requests) 50 90% menos

🔍 Verificar Cache:```bash

Ver todas as chaves do cache

docker exec weather-cache redis-cli keys "*"

Estatísticas do Redis

docker exec weather-cache redis-cli info stats

Ver TTL de uma chave

docker exec weather-cache redis-cli ttl "weather:sao paulo"


---

## 🚨 **Solução de Problemas**

### **❌ "Cannot find module"**```bash
# Limpeza completa
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
npm run build

❌ "Connection refused" (PostgreSQL)```bash

Verificar containers

docker ps

Reiniciar infrastructure

npm run docker:down
npm run docker:up

Aguardar inicialização

sleep 30
```

❌ MCP não conecta no Claude Desktop

  1. ✅ Verifique se o caminho no claude_desktop_config.json está correto
  2. 📂 Confirme se dist/mcp-entry.js existe (npm run build)
  3. 🔄 Feche completamente o Claude Desktop e reabra
  4. 🧪 Teste manual: node dist/mcp-entry.js

📊 Status Atual - Agosto 2025

✅ Clean Architecture 100% Implementada:

  • Arquitetura Completa: domain/, application/, infrastructure/, presentation/
  • Dependency Injection: Container DI funcionando perfeitamente
  • Princípios SOLID: Aplicados rigorosamente
  • 4 MCP Tools: Registradas e funcionando no Claude Desktop
  • Database + Cache: PostgreSQL + Redis operacionais
  • Zero Legacy Code: Arquivos desnecessários removidos

🎯 MCP Tools Funcionais:

🔧 Tool 📋 Função ✅ Status
get_current_weather Clima atual de qualquer cidade ✅ Funcionando
get_weather_forecast Previsão 5 dias ✅ Funcionando
get_weather_history Histórico de consultas ✅ Funcionando
get_cache_statistics Estatísticas do sistema ✅ Funcionando

🤝 Contribuindo

  1. 🍴 Fork este repositório
  2. 🌿 Crie uma branch (git checkout -b feature/MinhaFeature)
  3. 💻 Desenvolva sua funcionalidade
  4. ✅ Teste completamente
  5. 📝 Commit (git commit -m 'Adiciona MinhaFeature')
  6. 📤 Push (git push origin feature/MinhaFeature)
  7. 🔄 Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.


👩‍💻 Autora

Glaucia Lemos

Software AI Engineer | ex-Microsoft


⭐ Gostou do projeto? Deixe uma estrela! ⭐

Feito com ❤️ e ☕ por Glaucia Lemos

Transformando dados meteorológicos em conversas inteligentes 🌤️🤖

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Server Tempo 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Server Tempo 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Server Tempo 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Server Tempo 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

MCP Server Tempo 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Server Tempo 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 位置天气、AI扩展、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。