MCP Weather

Um servidor para buscar informações meteorológicas usando a API OpenWeather.

Documentação

MCP Weather - Integração com Claude Desktop

Este projeto é um exemplo de servidor MCP (Model Context Protocol) projetado para uso com o aplicativo Claude Desktop. Ele foi construído para funcionar perfeitamente com o Claude Desktop.

Recursos

Servidor MCP baseado em TypeScript
Consulta de clima via API OpenWeather
Integração fácil com o Claude Desktop

Estrutura do Projeto

.
├── package.json
├── tsconfig.json
├── src/
│   └── index.ts
├── claude_desktop_config.json

Instalação

Requisitos

Node.js (v16 ou superior)
npm
Claude Desktop (https://desktop.anthropic.com/)

Configuração

Clone o repositório:

git clone <repository-url>
cd mcp-weather

Instale as dependências:
```
npm install
```

Crie um arquivo .env e preencha-o da seguinte forma:

WEATHER_API_URL=https://api.weatherapi.com/v1/current.json
WEATHER_API_KEY=<your_API_KEY>

Integração com Claude Desktop

No Claude Desktop, vá para File -> Settings -> Developer -> Edit Config.
Adicione um bloco semelhante ao exemplo abaixo ao arquivo de configuração (edite os caminhos dos arquivos para corresponder ao seu próprio sistema):
```
{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["tsx", "C:/your/path/mcp-weather/src/index.ts"],
      "cwd": "C:/your/path/mcp-weather"
    }
  }
}
```
Nota: Substitua C:/your/path/ pelo caminho real do seu projeto no seu computador.
Salve as configurações e reinicie o Claude Desktop.

Arquivo .env e Configuração de Caminho

Em src/index.ts, o caminho para o arquivo .env é definido como a raiz do projeto por padrão:

import dotenv from "dotenv";
dotenv.config({
  // Path to your .env file. Edit as needed, e.g.: path: "C:/your/path/.env"
  path: ".env", // By default, uses the .env file in the project root
});

Se o seu arquivo .env estiver em um diretório diferente, atualize o parâmetro path de acordo.

Uso

Para iniciar o projeto:

npm start

Ou para executar o arquivo principal diretamente:

npx ts-node src/index.ts

Build

Para compilar o código TypeScript:

npm run build

Contribuição

Contribuições são bem-vindas! Por favor, abra issues ou envie pull requests para melhorias ou correções de bugs.

Licença

Licença MIT