mcp-netdisco

Docker化されたModel Context Protocol (MCP)サーバーで、MCPクライアントにNetdiscoへの読み取り専用アクセスを提供します。

特徴

• Netdiscoの/loginエンドポイントをHTTP Basic認証情報で使用します

• 返されたAPIキーをキャッシュし、30日ごとに更新します

• NetdiscoがHTTP 401を返した場合に自動的に再認証します

• 設定されたNetdiscoサーバー上の相対パスにリクエストを制限します

• Dockerコンテナを起動するクライアント向けにMCP stdio上で動作します

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: /api/v1/search/device などのNetdisco APIの相対パス

• query: オプションのクエリ文字列パラメータ

データ呼び出しではHTTP GETリクエストのみがサポートされています。絶対URLは拒否され、リクエストは別のホストにリダイレクトできません。

Netdiscoトークンの有効期間

サーバーはキャッシュされたAPIキーを30日ごとに更新し、401応答後は1回再試行します。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

ライセンス

ライセンスはまだ選択されていません。