mcp-netdisco

Докеризованный сервер Model Context Protocol (MCP), который предоставляет MCP-клиентам доступ к Netdisco только для чтения.

Возможности

• Использует конечную точку /login Netdisco с учетными данными HTTP Basic

• Кэширует возвращаемый API-ключ и обновляет его каждые 30 дней

• Автоматически выполняет повторную аутентификацию, если Netdisco возвращает HTTP 401

• Ограничивает запросы относительными путями на настроенном сервере Netdisco

• Работает через MCP stdio для клиентов, которые запускают контейнеры Docker

Related MCP server: kismet-wireless-mcp

Конфигурация

Создайте файл .env. URL по умолчанию — производственный сервер Netdisco:

NETDISCO_URL=http://your-url-site.com:5000
NETDISCO_USERNAME=your-netdisco-username
NETDISCO_PASSWORD=your-netdisco-password
NETDISCO_TIMEOUT=20

Имя пользователя и пароль используются только для получения API-ключа через POST /login. Не коммитьте .env.

Docker

Соберите и запустите напрямую:

docker build -t mcp-netdisco .
docker run --rm -i --env-file .env mcp-netdisco

Или используйте Compose:

docker compose build
docker compose run --rm -T mcp-netdisco

Инструмент MCP

Сервер предоставляет:

netdisco_api(path, query)

• path: относительный путь API Netdisco, например /api/v1/search/device

• query: необязательные параметры строки запроса

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

Время жизни токена Netdisco

Сервер обновляет кэшированный API-ключ каждые 30 дней и выполняет одну повторную попытку после ответа 401. Параметр api_token_lifetime в Netdisco должен быть больше интервала обновления (в противном случае повторная попытка после 401 получит свежий ключ, когда это потребуется). В дальнейшем интервал обновления можно будет сделать настраиваемым, если это потребуется.

Разработка

python3 -m venv .venv
. .venv/bin/activate
pip install -e .
export NETDISCO_USERNAME=your-user
export NETDISCO_PASSWORD=your-password
python -m mcp_netdisco

Лицензия

Лицензия пока не выбрана.