mcp-netdisco

一个 Docker 化的 Model Context Protocol (MCP) 服务器，为 MCP 客户端提供对 Netdisco 的只读访问。

功能

• 使用 Netdisco 的 /login 端点，并携带 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

用户名和密码仅用于从 POST /login 获取 API 密钥。请勿提交 .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：相对的 Netdisco API 路径，例如 /api/v1/search/device

• query：可选的查询字符串参数

数据调用仅支持 HTTP GET 请求。绝对 URL 会被拒绝，并且请求不能重定向到其他主机。

Netdisco 令牌有效期

服务器每 30 天刷新缓存的 API 密钥，并在收到 401 响应后重试一次。Netdisco 的 api_token_lifetime 设置必须长于刷新间隔（否则 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

许可证

尚未选择许可证。