mcp-abfall

English · Deutsch

MCP-сервер для календарей вывоза мусора немецких городов и районов. По заданному адресу ищет даты вывоза — остаточные отходы, органические отходы, бумагу, упаковку, крупногабаритный мусор, пункты сбора опасных отходов.

address ──▶ Nominatim ──▶ municipality + district ──▶ provider search (995)
                                                              │
                       collection dates ◀── portal ◀── resolve arguments

Почему это нетривиально

Управление отходами в Германии организовано на муниципальном уровне. Общенационального API не существует — около 400 муниципальных служб по обращению с отходами ведут собственные порталы, работающие на нескольких программных платформах (Abfall.IO/AbfallPlus, AbfallNavi, Jumomind, AWIDO, C-Trace, Müllmax, плюс множество простых ICS-экспортов).

Этот сервер использует mampfes/hacs_waste_collection_schedule (MIT) в качестве источника данных — активно поддерживаемый проект с более чем 950 модулями источников. Его внутренний пакет не зависит от Home Assistant и подключён здесь как Git-подмодуль.

Главная задача этого проекта — превратить адрес в ответственную службу по обращению с отходами и её внутренние параметры. В Home Assistant человек один раз связывает всё это вручную; MCP-сервер должен делать это самостоятельно.

Related MCP server: vnbdigital-mcp

Установка

Сервер запускается из рабочей копии репозитория, а не как установленный пакет: ему нужны источник данных в vendor/ и реестр в data/, оба пути разрешаются относительно корня проекта. Именно поэтому его нет на PyPI — wheel-пакет установился бы без ошибок, но всё равно не работал.

git clone --recurse-submodules https://github.com/AlpayC/mcp-abfall.git
cd mcp-abfall
uv sync
uv run pytest

data/providers.json включён в репозиторий, поэтому сервер запускается сразу. После обновления подмодуля пересоберите его:

uv run python scripts/build_registry.py

Подключение

Локально через stdio — в claude_desktop_config.json или .mcp.json:

{
  "mcpServers": {
    "abfall": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-abfall", "run", "mcp-abfall"]
    }
  }
}

Как HTTP-сервис:

uv run mcp-abfall --http --host 127.0.0.1 --port 8000

Имейте в виду, что каждый HTTP-запрос создаёт нагрузку на порталы служб и на Nominatim. Для любого использования