MCP-сервер

Расширяемый сервер Model Context Protocol (MCP) с инструментами для получения погоды и времени. Создан для обучения — подключите его к Claude Desktop и начните общение.

Начало работы

1. Клонирование и установка

git clone <repo-url> && cd mcp-server
python3 -m venv .venv
source .venv/bin/activate   # macOS / Linux / WSL
pip install -e .

Или с помощью uv:

git clone <repo-url> && cd mcp-server
uv venv
source .venv/bin/activate
uv pip install -e .

2. Подключение к Claude Desktop

Запустите скрипт настройки, чтобы автоматически записать файл конфигурации Claude Desktop:

macOS:

python setup_claude_agent.py

Это запишет файл ~/Library/Application Support/Claude/claude_desktop_config.json, указывающий на .venv/bin/python вашего проекта.

Если ваш проект находится в нестандартном месте, укажите его явно:

python setup_claude_agent.py --project-path /path/to/mcp-server

Windows (через WSL):

python3 setup_claude_agent.py --windows --win-user <YourWindowsUser> --wsl-user <YourWSLUser>

Например:

python3 setup_claude_agent.py --windows --win-user Cam --wsl-user cam

Это запишет файл %APPDATA%\Claude\claude_desktop_config.json и настроит Claude Desktop на запуск сервера через WSL.

3. Перезапуск Claude Desktop

Закройте и снова откройте Claude Desktop. Чтобы убедиться, что сервер подключен, перейдите в Settings → Developer — вы должны увидеть mcp-server с зеленым значком running.

4. Попробуйте в действии

Спросите у Claude что-нибудь из следующего:

• "What time is it?" — использует инструмент get_current_time

• "Get weather alerts for California" — использует ресурс weather://alerts/CA

• "What's the forecast for latitude 40.7128, longitude -74.0060?" — использует ресурс прогноза

Вам не нужно запускать сервер вручную — Claude Desktop запускает его автоматически.

Related MCP server: mcp-weather

Доступные инструменты и ресурсы

Добавление собственных инструментов

Откройте src/mcp_server/server.py и добавьте функцию с декоратором @mcp.tool():

@mcp.tool()
async def my_tool(param: str) -> str:
    """Description of what this tool does."""
    return f"Result for {param}"

Перезапустите Claude Desktop, чтобы изменения вступили в силу.

Информацию о ресурсах и промптах см. в CONTRIBUTING.md.

Запуск тестов

pip install -e ".[dev]"   # or: uv pip install -e ".[dev]"
pytest

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

src/mcp_server/
├── server.py              # MCP server entry point — register tools here
└── tools/
    ├── weather/           # Weather alerts & forecasts (NWS API)
    ├── time/              # IP-based timezone & current time
    └── conversation/      # Conversation tools

Лицензия

MIT

Ресурсы

• Документация Model Context Protocol

• API Национальной метеорологической службы

• Создание MCP-сервера