Nmstate MCP

🚀 Nmstate MCP

このプロジェクトは、nmstateを用いてネットワーク構成を適用するMCPサーバーです。LLMとMCPの力を借りて、ネットワーク管理をより簡単にすることを目指しています。ぜひアイデアを持ったイシューを投稿してください😃

現在のコードはプロトタイピング段階です。もっと慎重なコーディングで書き直す必要があるかもしれません。

!! 進行中の作業です !!

✨ 主な機能

Nmstate MCPは、nmstateを利用してネットワーク構成を適用するMCPサーバーで、LLMとMCPの機能を活用してネットワーク管理を容易にします。

📦 インストール

前提条件

• npm (オプション: MCP-Superassistant用)
• python3
• uv
• python3-libnmstate

DNF Coprからのインストール

dnfパッケージマネージャーからプロジェクトをセットアップして実行する方法です。

Coprリポジトリからのインストール: rrajesh/nmstate-mcp

sudo dnf copr enable rrajesh/nmstate-mcp
sudo dnf install nmstate-mcp

セットアップスクリプトの実行

nmstate-mcp-setup

これは現時点ではsetup_cursor.pyに相当し、現在はCursor IDEのみをサポートしています。

inventory.yamlのセットアップ

設定したいリモートホストを含めるように~/.nmstate-mcp/inventory.yamlを設定します。nmstate-mcpはリモートホストの設定にAnsibleを使用します。

ソースからのインストール

ソースからプロジェクトをセットアップして実行する方法です。

libnmstateのインストール

sudo dnf install python3-libnmstate uv

libnmstateを使用するためにシステムサイトパッケージ付きのvenvを作成

uv venv --system-site-packages .venv

source .venv/bin/activate

依存関係のダウンロード

uv sync

サーバーを実行するコマンド

uv run --directory <プロジェクトディレクトリのパス> main.py

または、プロジェクトディレクトリ内にいる場合:

uv run main.py

このコマンドでは、Python仮想環境を手動でアクティブ化する必要はありません。

MCPクライアントの設定

Claude DesktopとCursor、および他のいくつかのツールがこの "mcpServers" 形式をサポートしています。

{
  "mcpServers": {
    "nmstate-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<あなたのプロジェクトのパス>",
        "main.py"
      ]
    },
  }
}

MCP SuperAssistant用: プロキシサーバーの実行

これにより、nmstate mcpサーバーの実装も実行されます。mcpconfig.jsonを参照し、ディレクトリの設定を反映するように編集してください。 UV runのドキュメント: docs.astral.sh/uv/reference/cli/#uv-run

npx @srbhptl39/mcp-superassistant-proxy@latest --config ./mcpconfig.json

🔧 リモートホストの設定

前提条件:

• Ansible
• SSH
• デモ目的では、VMでパスワードレスのsudoを設定するか、他の認証方法を見つける必要があります。Cursorを通してパスワードプロンプトを取得することはできません。