ezh0v/weather-mcp-server

Weather API MCP сервер

Пожаловаться на ошибку | Функция запроса

Лёгкий сервер Model Context Protocol (MCP), который позволяет ассистентам ИИ, таким как Claude, получать и интерпретировать погодные данные в реальном времени.

Установка на Claude Desktop

Чтобы использовать ваш MCP-сервер с Claude Desktop, добавьте его в конфигурацию Claude:

1. Локальный режим

Вы можете получить API-ключ из своего личного аккаунта в WeatherAPI.

2. Удалённый режим

Строим из источника

Вы можете использовать go для построения бинарного файла в каталоге cmd/github-mcp-server.

Использование MCP с Docker Containers

1. Постройте имидж Docker:

2. Запустить контейнер Docker:

Замените your-api-key на ваш настоящий ключ WeatherAPI API.

Инструменты

• current_weather - Получает текущую погоду для города

• city: Название города (обязательная строка)

Структура проекта

Проект организован в несколько ключевых каталогов:

Тестирование

Если вы добавляете новые функции, обязательно включите тесты на них.

1. Установите инструмент мокгена:

Смотрите руководство по установке на go.uber.org/mock.

2. Используйте следующую команду для генерации мок-файлов:

3. Для запуска модульных тестов:

Вклад

A lightweight Model Context Protocol (MCP) server that enables AI assistants like Claude to retrieve and interpret real-time weather data.

Installing on Claude Desktop

To use your MCP server with Claude Desktop, add it to your Claude configuration:

1. Local mode

{
  "mcpServers": {
    "weather-mcp-server": {
      "command": "/path/to/weather-mcp-server",
      "env": {
        "WEATHER_API_KEY": "your-api-key"
      }
    }
  }
}

You can get an API key from your personal account on WeatherAPI.

2. Remote mode

{
  "mcpServers": {
    "weather-mcp-server": {
      "url": "http://host:port/sse"
    }
  }
}

Build from source

You can use go to build the binary in the cmd/github-mcp-server directory.

go build -o weather-mcp-server ./cmd/weather-mcp-server

Using MCP with Docker Containers

1. Build the Docker Image:

docker build -t weather-mcp-server .

2. Run the Docker Container:

docker run -e WEATHER_API_KEY=your-api-key -d --name weather-mcp-server -p 8000:8000 weather-mcp-server

Replace your-api-key with your actual WeatherAPI API key.

Tools

• current_weather - Gets the current weather for a city

  • city: The name of the city (string, required)

Project Structure

The project is organized into several key directories:

├── cmd
│   └── weather-mcp-server
├── internal
│   └── server
│       ├── handlers # MCP handlers
│       ├── services # Business logic layer
│       │   ├── core # Core application logic
│       │   └── mock # Mock services for testing
│       ├── tools # MCP tools
│       └── view # Templates for displaying messages
└── pkg

Testing