feat(mcp): add netx-mcp package and HTTP stdio MCP

- Extract installable packages/netx-mcp (12 HTTP tools, mcp.json)

- Delegate netx_api.mcp to netx_mcp; keep legacy db_server shim

- Add docs/MCP.md, install payload, pyproject entry, tests

Co-authored-by: Cursor <cursoragent@cursor.com>

tests/test_mcp_http.py

@@ -0,0 +1,107 @@
+"""Tests for netx HTTP MCP (via netx-mcp package)."""
+
+from __future__ import annotations
+
+import json
+import subprocess
+import sys
+from unittest.mock import patch
+
+import pytest
+
+from netx_mcp.http_tools import HTTP_MCP_TOOLS, call_http_tool
+
+
+def test_http_mcp_tool_list_has_twelve_tools() -> None:
+    names = [str(t.get("name") or "") for t in HTTP_MCP_TOOLS]
+    assert len(names) == 12
+    assert "queryUmeAlarms" in names
+    assert "queryUmeAlarmsRaw" in names
+    assert "execManagedNe" in names
+
+
+def test_call_query_ume_alarms_forwards_http() -> None:
+    with patch("netx_mcp.http_tools.http_json") as mock_http:
+        mock_http.return_value = {"ok": True, "data": {"total": 0, "items": []}}
+        out = call_http_tool("queryUmeAlarms", {"severity": "critical", "page": 1, "page_size": 10})
+        mock_http.assert_called_once()
+        assert mock_http.call_args[0][0] == "GET"
+        assert mock_http.call_args[0][1] == "/v1/ume/alarms"
+        params = mock_http.call_args[1]["params"]
+        assert params["severity"] == "critical"
+        text = out["content"][0]["text"]
+        payload = json.loads(text)
+        assert payload["ok"] is True
+
+
+def test_call_get_ume_ne_requires_id() -> None:
+    out = call_http_tool("getUmeNe", {})
+    assert out.get("isError") is True
+    text = out["content"][0]["text"]
+    payload = json.loads(text)
+    assert payload["error"] == "ne_id_required"
+
+
+def test_call_exec_managed_ne_posts_body() -> None:
+    with patch("netx_mcp.http_tools.http_post_json") as mock_post:
+        mock_post.return_value = {"ok": True, "data": {"ok": True, "output": "ok"}}
+        out = call_http_tool(
+            "execManagedNe",
+            {"ne_id": "abc", "commands": ["show version"]},
+        )
+        mock_post.assert_called_once()
+        assert mock_post.call_args[0][0] == "/v1/managed-ne/exec"
+        body = mock_post.call_args[0][1]
+        assert body["ne_id"] == "abc"
+        assert body["commands"] == ["show version"]
+        text = out["content"][0]["text"]
+        payload = json.loads(text)
+        assert payload["ok"] is True
+
+
+def test_stdio_initialize_and_tools_list() -> None:
+    proc = subprocess.Popen(
+        [sys.executable, "-m", "netx_mcp"],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+    )
+    assert proc.stdin and proc.stdout
+    init_req = json.dumps({"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {}}) + "\n"
+    proc.stdin.write(init_req)
+    proc.stdin.flush()
+    init_line = proc.stdout.readline()
+    init_resp = json.loads(init_line)
+    assert init_resp["result"]["serverInfo"]["mode"] == "http"
+
+    list_req = json.dumps({"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}) + "\n"
+    proc.stdin.write(list_req)
+    proc.stdin.flush()
+    list_line = proc.stdout.readline()
+    list_resp = json.loads(list_line)
+    tools = list_resp["result"]["tools"]
+    assert len(tools) == 12
+
+    proc.terminate()
+    proc.wait(timeout=5)
+
+
+def test_legacy_netx_api_mcp_module_still_works() -> None:
+    proc = subprocess.Popen(
+        [sys.executable, "-m", "netx_api.mcp"],
+        stdin=subprocess.PIPE,
+        stdout=subprocess.PIPE,
+        stderr=subprocess.PIPE,
+        text=True,
+        cwd=str(__import__("pathlib").Path(__file__).resolve().parents[1]),
+    )
+    assert proc.stdin and proc.stdout
+    init_req = json.dumps({"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {}}) + "\n"
+    proc.stdin.write(init_req)
+    proc.stdin.flush()
+    init_line = proc.stdout.readline()
+    init_resp = json.loads(init_line)
+    assert init_resp["result"]["serverInfo"]["mode"] == "http"
+    proc.terminate()
+    proc.wait(timeout=5)