Tokyo WBGT MCP Server

Tokyo WBGT MCP Server

Servidor Model Context Protocol (MCP) para obter dados de previsão de WBGT (índice de calor) de Tóquio. Utiliza dados oficiais do Ministério do Meio Ambiente do Japão para fornecer valores previstos e medidos de WBGT em vários pontos de observação em Tóquio.

🌡️ Funcionalidades

Ferramentas disponíveis

1. get_tokyo_wbgt_forecast

   • Obtém valores previstos de WBGT para um ponto de observação especificado em Tóquio
   • Pontos suportados: tokyo, hachioji, fuchu, nerima, ome, ogochi, edogawa

2. get_all_tokyo_locations

   • Obtém de uma só vez os valores previstos de todos os pontos de observação de WBGT em Tóquio

3. get_tokyo_realtime_data

   • Obtém valores de WBGT medidos em Tóquio (somente pontos de medição)
   • Permite obter dados de um mês/ano especificado

📍 Pontos de observação

Nome do ponto	Número do ponto	Dados medidos
東京（小石川植物園）	44132	✅
八王子	44112	❌
府中	44116	❌
練馬	44071	❌
青梅	44056	❌
小河内	44046	❌
江戸川臨海	44136	❌

🚀 Instalação

# 依存関係をインストール
npm install

# TypeScriptをビルド
npm run build

💻 Como usar

Configuração no cliente MCP

Adicione o seguinte ao arquivo de configuração do cliente MCP, como o Claude Desktop:

{
  "mcpServers": {
    "tokyo-wbgt": {
      "command": "node",
      "args": ["path/to/tokyo-wbgt-mcp-server/build/index.js"]
    }
  }
}

Execução autônoma

# プロダクション実行
npm start

# 開発モード
npm run dev

📊 Fontes de dados

• Dados previstos: Site de informações de prevenção de insolação do Ministério do Meio Ambiente
  • URL: https://www.wbgt.env.go.jp/prev15WG/dl/
• Dados medidos: Dados de pontos de medição do Ministério do Meio Ambiente
  • URL: https://www.wbgt.env.go.jp/mntr/dl/

🌡️ Sobre o WBGT (índice de calor)

O WBGT é um indicador para prevenção de insolação que considera temperatura, umidade e calor radiante.

🚦 Níveis de risco

Nível	Faixa de temperatura	Condição	Ação
🟢 Seguro	< 21°C	Atividade normal possível	-
🟡 Atenção	21-25°C	Hidratação ativa	Hidratação frequente
🟠 Alerta	25-28°C	Descanso e hidratação ativos	Pausas regulares e reposição de sal
🔴 Alerta severo	28-31°C	Suspender exercícios intensos	Considerar interromper exercícios
🟣 Perigo	≥ 31°C	Exercícios suspensos em princípio	Suspender todos os exercícios

📋 Exemplos de resposta

Dados previstos

{
  "locationId": "44132",
  "locationName": "東京（小石川植物園）",
  "prefecture": "東京都",
  "updateTime": "2025/06/23 19:25",
  "forecasts": [
    {
      "datetime": "2025/06/23 21:00",
      "wbgt": 24.0,
      "status": "注意"
    },
    {
      "datetime": "2025/06/24 00:00",
      "wbgt": 25.0,
      "status": "警戒"
    }
  ]
}

Dados medidos

{
  "location": "東京（実測地点）",
  "prefecture": "東京都",
  "data": [
    {
      "datetime": "2025/6/23 17:00",
      "wbgt": 24.5,
      "status": "注意"
    }
  ]
}

🔧 Desenvolvimento

Estrutura do projeto

src/
├── index.ts          # メインサーバークラス
├── types.ts          # TypeScript型定義
├── constants.ts      # 定数・設定値
├── utils.ts          # ユーティリティ関数
└── wbgt-service.ts   # WBGTデータ取得サービス

Dependências necessárias

• Node.js 18+
• TypeScript 5+
• @modelcontextprotocol/sdk

Comandos de desenvolvimento

# 開発環境での実行
npm run dev

# ビルド
npm run build

# プロダクション実行
npm start

⚠️ Avisos

• Os dados são obtidos do sistema oficial do Ministério do Meio Ambiente e podem não estar disponíveis durante a manutenção do servidor
• Os dados medidos são fornecidos somente para o ponto de Tóquio (小石川植物園)
• Os dados previstos são atualizados a cada hora
• Os dados medidos são atualizados a cada hora em ponto

📜 Licença

MIT License

📚 Sobre o uso dos dados

Os dados de WBGT usados por este servidor são obtidos do site de informações de prevenção de insolação do Ministério do Meio Ambiente. Para o uso dos dados, siga os termos de uso do Ministério do Meio Ambiente.

• Site de informações de prevenção de insolação do Ministério do Meio Ambiente
• Sobre o uso deste site

🤝 Contribuição

Pull requests e relatos de issues são bem-vindos. Se tiver relatos de bugs ou solicitações de recursos, fique à vontade para nos informar.