adf-mcp-server

Сервер MCP (Model Context Protocol) только для чтения для мониторинга Azure Data Factory и анализа первопричин, созданный для использования из VS Code / Claude Code.

Статус: шаг 1 (скелет + проверка работоспособности). Подключения к Azure пока нет — оно будет добавлено на шаге 2 (аутентификация) и на шаге 3 (инструменты ADF).

##Требования

• Python 3.11+

##локальная настройка

cd adf-mcp-server
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -e ".[dev]"
cp .env.example .env

Сейчас в .env нужен только блок настроек сервера (ADF_MCP_*). Строки AZURE_* — заготтовки для шага 2: оставьте их пока закомментированными.

##Запуск сервера

python -m adf_mcp.server
# or, after `pip install -e .`:
adf-mcp-server

Сервер общается через стандартный ввод/вывод — запуск в терминале никеть как зависший; это нормально, ведь он ждёт подключения MCP-клиента (расширение VS Code, Claude Code, mcp dev и т. д.) через stdin/stdout.

###Настройка в VS Code

Укажите конфигурацию сервера в вашем расширении, совместимом с MCP:

{
  "command": "python",
  "args": ["-m", "adf_mcp.server"],
  "cwd": "/absolute/path/to/adf-mcp-server"
}

Подключившись, вызовите инструмент health_check — он должен вернуть {"status": "ok", ...} без обращения к Azure.

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

pip install -e ".[dev]" pytest-asyncio
pytest -v

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

Смотрите папку src/adf_mcp/ — в ней: server.py (транспорт MCP), config.py (настройки), logging_config.py (структурированное логирование). Доменная граница и подключение к Azure добавляются в src/adf_mcp/domain/ начиная с шага 3.

Related MCP server: azure-adf-mcp

Устранение неполадок

• Клиент сразу показывает «сервер отключен»: сначала проверьте, что python -m adf_mcp.server запускается без ошибок сам по себе — исключение при запуске убьёт процесс до того, как клиент вообще подключится.

• Клиент не может распарсить ответы / видит искажённый вывод: в stdout попало что-то помимо самого протокола MCP (например, случайный print()). Всё логирование в работаем проекте направлено в stderr именно для этого.