Repository navigation
🇯🇵 日本語
TWSNMP NEO v0.7.0 をリリースしました!🎉
本バージョンでは、内蔵 MCP (Model Context Protocol) サーバーの 42 ツール・31 プロンプトへの大幅拡張および CLI アクセス制御フラグの追加、受信デーモンのバインドエラー検出・SystemView 表示対応、さらに Playwright による E2E テストスイートとドキュメントスクリーンショット/デモ録画の自動化 を導入しました。
🌟 主な新機能・改善点
1. 内蔵 MCP サーバーの拡張(42 ツール / 31 プロンプト)& CLI フラグ
- ノード / ライン / ポーリング CRUD ツール追加:
add_node、update_node、delete_node、add_line、delete_line、add_polling、update_polling、delete_pollingを追加し、AI エージェントからネットワークトポロジーや監視設定を自律的に構築・管理できるようになりました。 - 診断・検索・AI 異常検知ツール強化: 即時ポーリング実行(
check_polling)、NetFlow 検索(search_netflow)、AI 異常検知スコア取得(get_ai_anomaly_list)などのツールを追加・改善し、全 42 ツール・31 プロンプトテンプレートを提供します。 - 起動時アクセス制御フラグ:
-mcpFrom(TWSNMP_MCPFROM)および-mcpMode auth|noauth(TWSNMP_MCPMODE)を追加し、CLI 引数や環境変数から MCP サーバーのアクセス許可 IP/CIDR と認証モードを上書き指定できるようになりました。 - ドキュメント・仕様書更新: 42 ツールおよび CLI フラグに合わせて MCP 仕様・連携ガイド、AI プロンプトガイド、
SPEC.md/SPEC-ja.md、READMEを更新しました。
2. 受信デーモンのバインドエラー検出 & SystemView 表示
- バインドエラーの即時検知: Syslog、SNMP TRAP、NetFlow、sFlow、ARP Watch、OpenTelemetry、MQTT の各受信デーモンにおいて、ポート競合(
address already in use)や権限不足などのバインドエラー発生時にerrorステータスと詳細なエラーメッセージを記録します。 SystemViewでの可視化: システムステータス画面の該当レシーバーカードがエラー表示となり具体的な原因メッセージを確認できるほか、システム全体のデーモン稼働状態もERRORとして即座に通知されます。
3. Playwright E2E テスト & ドキュメント自動化基盤
- E2E テストスイート導入:
e2e/配下に Playwright を用いた自動テスト(認証・RBAC、全画面スモーク、3D VPanel、マップキャンバス操作、公開ダッシュボード、i18n/テーマ切替)を追加し、GitHub Actions CI(CI / Test)に統合しました。 - デモ録画 & スクリーンショット自動撮影:
mise run record-demoおよびmise run capture-docsによるデモ動画録画・日英ドキュメント画像自動取得に対応しました。
🇺🇸 English
TWSNMP NEO v0.7.0 is now released! 🎉
This release significantly expands the built-in MCP (Model Context Protocol) server to 42 tools and 31 prompts with new CLI access-control flags, adds receiver bind error detection and reporting in SystemView, and introduces a Playwright E2E test suite with automated demo recording and bilingual documentation screenshot capture.
🌟 Key New Features & Improvements
1. Expanded Built-in MCP Server (42 Tools / 31 Prompts) & CLI Flags
- Node, Line & Polling CRUD Tools: Added
add_node,update_node,delete_node,add_line,delete_line,add_polling,update_polling, anddelete_polling, enabling AI agents to autonomously build and manage network topologies and monitoring rules. - Enhanced Diagnostics, Search & AI Anomaly Tools: Added and improved tools including immediate polling execution (
check_polling), NetFlow search (search_netflow), and AI anomaly score retrieval (get_ai_anomaly_list), bringing the total to 42 tools and 31 prompt templates. - CLI Access Control Flags: Added
-mcpFrom(TWSNMP_MCPFROM) and-mcpMode auth|noauth(TWSNMP_MCPMODE) to override MCP IP/CIDR allowlists and authentication modes at startup. - Updated Documentation: Updated the MCP Server Specification & Guide, AI Prompts Guide,
SPEC.md/SPEC-ja.md, andREADMEfiles for all 42 tools.
2. Receiver Bind Error Detection & SystemView Reporting
- Bind Error Propagation: Protocol receivers (Syslog, SNMP TRAP, NetFlow, sFlow, ARP Watch, OpenTelemetry, MQTT) now capture and report bind failures (e.g., port conflicts or insufficient permissions) with
status: "error"and diagnostic error details. SystemViewError Visibility: Affected receiver cards highlight errors with the exact failure reason, and the overall system daemon status reflectsERRORimmediately.
3. Playwright E2E Test Suite & Documentation Automation
- Automated E2E Verification: Added a Playwright E2E suite under
e2e/covering auth/RBAC, 9-view smoke tests, 3D VPanel, map canvas interactions, Public Dashboard, and i18n/theme switching, integrated into GitHub Actions CI (CI / Test). - Demo Recording & Screenshot Capture: Added
mise run record-demoandmise run capture-docsfor automated demo walkthrough videos and bilingual documentation screenshots.
📦 Commits & Changelog
- 5365bdb chore(release): bump version to v0.7.0 and update docs
- ffdcc1f docs(mcp): update specifications, guides, and README for 42 MCP tools
- 84e2423 feat(e2e): add Playwright E2E test suite, demo recording, and doc screenshot automation
- 7f155f7 feat(mcp): fix tool issues, add node/line/polling CRUD and CLI flags
- 4e2d6b8 fix(receiver): report bind errors in daemon status and SystemView