netx/packages/netx-mcp/README.md
oliver 45ce9d3f7e 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>
2026-05-30 15:44:32 +08:00

1.4 KiB
Raw Blame History

netx-mcp

轻量 stdio MCP 客户端,通过 HTTP 调用 netx REST API。装在 Cursor、oclaw、Claude Desktop 等 MCP 宿主所在机器;NETX_API_URL 可指向本机或远端 API。

安装、更新、各宿主配置、排错 → 仓库主文档 docs/MCP.md(请优先阅读)。

速查:安装

# 在 netx 仓库根目录
pip install -e ./packages/netx-mcp
python -c "import netx_mcp; print('ok')"

要求 Python 3.11+,且 netx API 已运行(GET /health)。

速查:更新

cd <netx 仓库>
git pull
pip install -e ./packages/netx-mcp

然后 重启 MCP 宿主(Cursor 重开;oclaw 重启后在 Admin 对 netx 执行 Health → Sync Tools)。

运行

$env:NETX_API_URL = "http://127.0.0.1:8890"
python -m netx_mcp
# 或: netx-mcp

配置

mcp.json — command: python,args: ["-m", "netx_mcp"],env 见文件。

工具(12)

UME:queryUmeAlarms, aggregateUmeAlarms, runUmeDiagnostics, queryUmeNeInventory, getUmeNe, queryUmeAlarmsRaw, aggregateUmeAlarmsRaw, listUmeAlarmFields, sqlQueryUme

托管网元:listManagedNe, getManagedNe, execManagedNe

兼容

全量 netx-ops 开发安装下 python -m netx_api.mcp 仍会转到本包;新环境请只装 netx-mcp。