Metadata-Version: 2.3
Name: iotsploit-mcp
Version: 0.0.6
Summary: IoTSploit MCP runtime (FastMCP stdio server + WebSocket bridge), framework-free outer ring.
License: GPL-3.0-or-later
Keywords: iot,security,mcp,model-context-protocol,pentest
Author: IoTSploit Team
Author-email: support@iotsploit.org
Requires-Python: >=3.10,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Classifier: Topic :: System :: Hardware
Requires-Dist: iotsploit-core (>=0.0.6,<0.0.7)
Requires-Dist: mcp (>=1.9.4,<2.0.0)
Requires-Dist: nest-asyncio (>=1.6.0,<2.0.0)
Requires-Dist: requests (>=2.31.0,<3.0.0)
Requires-Dist: websockets (>=12.0,<13.0)
Project-URL: Documentation, https://www.iotsploit.org/
Project-URL: Homepage, https://www.iotsploit.org/
Project-URL: Repository, https://github.com/TKXB/iotsploit
Description-Content-Type: text/markdown

# iotsploit-mcp

`iotsploit-mcp` 是 IoTSploit 的 MCP 运行时组件（execution plane / outer ring），包含：

- FastMCP **stdio server**（提供 MCP tools）
- WebSocket **bridge**（给上层 UI/Django consumer 通过 `ws://host:9998` 访问）

## 命令

- 默认启动 WebSocket bridge（等价于 `ws`）：

```bash
iotsploit-mcp
```

- 显式启动 WebSocket bridge：

```bash
iotsploit-mcp ws --host 0.0.0.0 --port 9998
```

- 只启动 stdio FastMCP server（一般由 bridge 拉起）：

```bash
iotsploit-mcp stdio
```

## 环境变量

- `IOTSPLOIT_DJANGO_API_BASE_URL`：Django HTTP API base URL（默认 `http://127.0.0.1:8888`）
- `IOTSPLOIT_DJANGO_API_TOKEN`：可选 Bearer token
- `IOTSPLOIT_DJANGO_API_TIMEOUT_S`：可选超时（秒）
- `IOTSPLOIT_DEVICE_PLUGINS_DIR`：device driver 插件目录
- `IOTSPLOIT_EXPLOIT_PLUGINS_DIR`：exploit 插件目录



