- MCP Server for Network Administration

NetSensei - ネットワーク管理用 MCP サーバー

NetSensei は、ネットワーク管理者を支援する MCP サーバーです。Model Context Protocol（MCP）を使用して、ネットワーク関連のコマンドを処理・実行するための ping、traceroute、Nmap スキャン、パケットスニッフィング、SSH など、さまざまなネットワークユーティリティとツールを提供します。

使用方法

Claude Desktop または mcpo を使用した OpenWebUI で利用できます。

機能

• Ping テスト：詳細な出力でネットワーク接続をすばやくテストします。
• Traceroute：任意の宛先へのネットワーク経路を特定します。
• Nmap スキャン：カスタマイズ可能な引数でネットワークをスキャンし、デバイスやサービスを検出します。
• パケットスニッファー：tshark を使用してネットワークパケットをキャプチャし、カスタム条件（例：DNS、HTTP、ICMP）でフィルタリングして分析します。
• SSH 接続：SSH 経由でデバイスに接続し、デバイスのプラットフォーム（例：Ubuntu Server、Cisco、Aruba など）に応じたコマンドを実行します。
• AI アシスタント：AI の力を活用して、定型的なネットワークタスクを自動化し、より深い洞察を得られます。

要件

• Python 3.x
• MCP Python SDK - https://github.com/modelcontextprotocol/python-sdk
• uvicorn - FastAPI サーバーを実行するための ASGI サーバーです。
• tshark（Wireshark のコマンドラインツール）がインストールされ、システムの PATH から利用できる必要があります。
• nmap - ネットワークスキャンに使用します。
• netmiko - SSH 接続とコマンド実行に使用します。
• パケットスニッフィングに対応したネットワークインターフェース（例：Wi-Fi、Ethernet）。

インストール

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/netsensei.git
   cd netsensei
   
   

2. Add this to your Claude Desktop config file.

   {
       "mcpServers": {
           "NetSensei": {
               "command": "uv",
               "args": [
                   "run",
                   "--with",
                   "mcp[cli]",
                   "mcp",
                   "run",
                   "C:\\path\\to\\cloned\\repo\\main.py"
               ]
           }
       }
   }
   

3. Integrating with OpenWebUI

   uvx mcpo --port 9003 -- mcp run main.py    
   

Example

Prompting Claude AI to discover live host in a network.

▶️ Watch the demo video

Contribution

Contributions are welcome! Feel free to fork the repository, create an issue, or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.