web-check-mcp 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (16) hide show
  1. web_check_mcp-0.2.0/LICENSE +21 -0
  2. web_check_mcp-0.2.0/PKG-INFO +130 -0
  3. web_check_mcp-0.2.0/README.md +118 -0
  4. web_check_mcp-0.2.0/pyproject.toml +26 -0
  5. web_check_mcp-0.2.0/setup.cfg +4 -0
  6. web_check_mcp-0.2.0/src/__init__.py +7 -0
  7. web_check_mcp-0.2.0/src/__main__.py +5 -0
  8. web_check_mcp-0.2.0/src/client.py +418 -0
  9. web_check_mcp-0.2.0/src/py.typed +0 -0
  10. web_check_mcp-0.2.0/src/server.py +385 -0
  11. web_check_mcp-0.2.0/tests/test_webcheck.py +317 -0
  12. web_check_mcp-0.2.0/web_check_mcp.egg-info/PKG-INFO +130 -0
  13. web_check_mcp-0.2.0/web_check_mcp.egg-info/SOURCES.txt +14 -0
  14. web_check_mcp-0.2.0/web_check_mcp.egg-info/dependency_links.txt +1 -0
  15. web_check_mcp-0.2.0/web_check_mcp.egg-info/entry_points.txt +2 -0
  16. web_check_mcp-0.2.0/web_check_mcp.egg-info/top_level.txt +1 -0
web_check_mcp-0.2.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 AMEOBIUS
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
web_check_mcp-0.2.0/PKG-INFO ADDED
@@ -0,0 +1,130 @@
1
+ Metadata-Version: 2.4
2
+ Name: web-check-mcp
3
+ Version: 0.2.0
4
+ Summary: MCP + CLI agent wrapper for Lissy93 Web Check OSINT API
5
+ Author: AMEOBIUS
6
+ License: MIT
7
+ Keywords: mcp,web-check,osint,security,agents
8
+ Requires-Python: >=3.10
9
+ Description-Content-Type: text/markdown
10
+ License-File: LICENSE
11
+ Dynamic: license-file
12
+
13
+ # Web Check MCP
14
+
15
+ > Agent wrapper for [Lissy93/web-check](https://github.com/Lissy93/web-check) — 31 OSINT checks as MCP tools + CLI.
16
+
17
+ Gap verified 2026-07-25: no public MCP/SDK/Hermes skill existed for this API. This package fills it.
18
+
19
+ ## Features
20
+
21
+ - **8 MCP tools**: `webcheck_run`, `webcheck_ssl`, `webcheck_dns`, `webcheck_security`, `webcheck_headers`, `webcheck_whois`, `webcheck_list_checks`, `webcheck_health`
22
+ - **31 OpenAPI checks** from upstream (`ssl`, `dns`, `headers`, `ports`, `firewall`, `whois`, …)
23
+ - **Presets**: `quick` | `security` | `server` | `quality` | `heavy` | `all`
24
+ - **Parallel fan-out** + **payload truncation** (agent-context safe)
25
+ - **Zero pip deps** — Python 3.10+ stdlib only
26
+ - **STDIO JSON-RPC** with `initialize` handshake + tool annotations (`readOnlyHint` + `openWorldHint`)
27
+
28
+ ## Public API works (with fallback)
29
+
30
+ Two public bases are tried automatically:
31
+
32
+ | Base | Status |
33
+ |------|--------|
34
+ | `web-check.as93.net/api` (Netlify mirror) | **200 OK** — more open, Cloudflare front |
35
+ | `web-check.xyz/api` (Vercel primary) | **200/429** — may challenge datacenter IPs |
36
+
37
+ Set `WEB_CHECK_BASE_URL` explicitly to skip probing. Fallback auto-enables when base starts with `https://web-check.` and can be forced via `WebCheckClient(fallback=True)`.
38
+
39
+ No key, no auth. LO confirms UI works fine; the agent wrapper mirrors that.
40
+
41
+ ## Self-host (optional)
42
+
43
+ For heavy load or offline use:
44
+
45
+ ```bash
46
+ docker run -d --name web-check -p 3000:3000 lissy93/web-check
47
+ export WEB_CHECK_BASE_URL=http://127.0.0.1:3000/api
48
+ ```
49
+
50
+ Upstream Go rewrite [`xray-web/web-check-api`](https://github.com/xray-web/web-check-api) is early WIP — prefer Node/Docker image for full endpoint parity.
51
+
52
+ ## Quick Start
53
+
54
+ ```bash
55
+ cd products/web-check-mcp
56
+
57
+ # Manifest
58
+ python3 -m src.server --manifest
59
+
60
+ # List checks
61
+ python3 -m src.server list --group quick
62
+
63
+ # Health probe
64
+ python3 -m src.server health
65
+
66
+ # Run quick recon (needs live API)
67
+ python3 -m src.server run example.com --group quick
68
+
69
+ # Single check
70
+ python3 -m src.server check ssl example.com
71
+
72
+ # MCP STDIO (Claude Desktop / Hermes / Cursor)
73
+ python3 -m src.server --stdio
74
+ ```
75
+
76
+ ### Library
77
+
78
+ ```python
79
+ from src.client import WebCheckClient
80
+
81
+ client = WebCheckClient(base_url="http://127.0.0.1:3000/api")
82
+ print(client.run("example.com", group="quick"))
83
+ print(client.check_one("ssl", "example.com"))
84
+ ```
85
+
86
+ ## MCP client config
87
+
88
+ ```json
89
+ {
90
+ "mcpServers": {
91
+ "web-check": {
92
+ "command": "python3",
93
+ "args": ["-m", "src.server", "--stdio"],
94
+ "cwd": "/absolute/path/to/products/web-check-mcp",
95
+ "env": {
96
+ "WEB_CHECK_BASE_URL": "http://127.0.0.1:3000/api"
97
+ }
98
+ }
99
+ }
100
+ }
101
+ ```
102
+
103
+ ## Tool Reference
104
+
105
+ | Tool | Description |
106
+ |------|-------------|
107
+ | `webcheck_list_checks` | Catalog of endpoints / groups |
108
+ | `webcheck_health` | Probe API base reachability |
109
+ | `webcheck_run` | Parallel multi-check (default group=`quick`) |
110
+ | `webcheck_ssl` | Certificate chain |
111
+ | `webcheck_dns` | DNS records |
112
+ | `webcheck_security` | Security preset bundle |
113
+ | `webcheck_headers` | HTTP headers |
114
+ | `webcheck_whois` | Domain WHOIS |
115
+
116
+ Env: `WEB_CHECK_BASE_URL`, `WEB_CHECK_TIMEOUT`, `WEB_CHECK_MAX_WORKERS`, `WEB_CHECK_MAX_CHARS`.
117
+
118
+ ## Tests
119
+
120
+ ```bash
121
+ python3 -m pytest tests/ -v
122
+ ```
123
+
124
+ All network paths mocked — no live API required for CI.
125
+
126
+ ## License
127
+
128
+ MIT. Upstream Web Check © Alicia Sykes, MIT.
129
+
130
+ Not affiliated with Lissy93; thin agent-facing client only.
web_check_mcp-0.2.0/README.md ADDED
@@ -0,0 +1,118 @@
1
+ # Web Check MCP
2
+
3
+ > Agent wrapper for [Lissy93/web-check](https://github.com/Lissy93/web-check) — 31 OSINT checks as MCP tools + CLI.
4
+
5
+ Gap verified 2026-07-25: no public MCP/SDK/Hermes skill existed for this API. This package fills it.
6
+
7
+ ## Features
8
+
9
+ - **8 MCP tools**: `webcheck_run`, `webcheck_ssl`, `webcheck_dns`, `webcheck_security`, `webcheck_headers`, `webcheck_whois`, `webcheck_list_checks`, `webcheck_health`
10
+ - **31 OpenAPI checks** from upstream (`ssl`, `dns`, `headers`, `ports`, `firewall`, `whois`, …)
11
+ - **Presets**: `quick` | `security` | `server` | `quality` | `heavy` | `all`
12
+ - **Parallel fan-out** + **payload truncation** (agent-context safe)
13
+ - **Zero pip deps** — Python 3.10+ stdlib only
14
+ - **STDIO JSON-RPC** with `initialize` handshake + tool annotations (`readOnlyHint` + `openWorldHint`)
15
+
16
+ ## Public API works (with fallback)
17
+
18
+ Two public bases are tried automatically:
19
+
20
+ | Base | Status |
21
+ |------|--------|
22
+ | `web-check.as93.net/api` (Netlify mirror) | **200 OK** — more open, Cloudflare front |
23
+ | `web-check.xyz/api` (Vercel primary) | **200/429** — may challenge datacenter IPs |
24
+
25
+ Set `WEB_CHECK_BASE_URL` explicitly to skip probing. Fallback auto-enables when base starts with `https://web-check.` and can be forced via `WebCheckClient(fallback=True)`.
26
+
27
+ No key, no auth. LO confirms UI works fine; the agent wrapper mirrors that.
28
+
29
+ ## Self-host (optional)
30
+
31
+ For heavy load or offline use:
32
+
33
+ ```bash
34
+ docker run -d --name web-check -p 3000:3000 lissy93/web-check
35
+ export WEB_CHECK_BASE_URL=http://127.0.0.1:3000/api
36
+ ```
37
+
38
+ Upstream Go rewrite [`xray-web/web-check-api`](https://github.com/xray-web/web-check-api) is early WIP — prefer Node/Docker image for full endpoint parity.
39
+
40
+ ## Quick Start
41
+
42
+ ```bash
43
+ cd products/web-check-mcp
44
+
45
+ # Manifest
46
+ python3 -m src.server --manifest
47
+
48
+ # List checks
49
+ python3 -m src.server list --group quick
50
+
51
+ # Health probe
52
+ python3 -m src.server health
53
+
54
+ # Run quick recon (needs live API)
55
+ python3 -m src.server run example.com --group quick
56
+
57
+ # Single check
58
+ python3 -m src.server check ssl example.com
59
+
60
+ # MCP STDIO (Claude Desktop / Hermes / Cursor)
61
+ python3 -m src.server --stdio
62
+ ```
63
+
64
+ ### Library
65
+
66
+ ```python
67
+ from src.client import WebCheckClient
68
+
69
+ client = WebCheckClient(base_url="http://127.0.0.1:3000/api")
70
+ print(client.run("example.com", group="quick"))
71
+ print(client.check_one("ssl", "example.com"))
72
+ ```
73
+
74
+ ## MCP client config
75
+
76
+ ```json
77
+ {
78
+ "mcpServers": {
79
+ "web-check": {
80
+ "command": "python3",
81
+ "args": ["-m", "src.server", "--stdio"],
82
+ "cwd": "/absolute/path/to/products/web-check-mcp",
83
+ "env": {
84
+ "WEB_CHECK_BASE_URL": "http://127.0.0.1:3000/api"
85
+ }
86
+ }
87
+ }
88
+ }
89
+ ```
90
+
91
+ ## Tool Reference
92
+
93
+ | Tool | Description |
94
+ |------|-------------|
95
+ | `webcheck_list_checks` | Catalog of endpoints / groups |
96
+ | `webcheck_health` | Probe API base reachability |
97
+ | `webcheck_run` | Parallel multi-check (default group=`quick`) |
98
+ | `webcheck_ssl` | Certificate chain |
99
+ | `webcheck_dns` | DNS records |
100
+ | `webcheck_security` | Security preset bundle |
101
+ | `webcheck_headers` | HTTP headers |
102
+ | `webcheck_whois` | Domain WHOIS |
103
+
104
+ Env: `WEB_CHECK_BASE_URL`, `WEB_CHECK_TIMEOUT`, `WEB_CHECK_MAX_WORKERS`, `WEB_CHECK_MAX_CHARS`.
105
+
106
+ ## Tests
107
+
108
+ ```bash
109
+ python3 -m pytest tests/ -v
110
+ ```
111
+
112
+ All network paths mocked — no live API required for CI.
113
+
114
+ ## License
115
+
116
+ MIT. Upstream Web Check © Alicia Sykes, MIT.
117
+
118
+ Not affiliated with Lissy93; thin agent-facing client only.
web_check_mcp-0.2.0/pyproject.toml ADDED
@@ -0,0 +1,26 @@
1
+ [project]
2
+ name = "web-check-mcp"
3
+ version = "0.2.0"
4
+ description = "MCP + CLI agent wrapper for Lissy93 Web Check OSINT API"
5
+ readme = "README.md"
6
+ requires-python = ">=3.10"
7
+ license = { text = "MIT" }
8
+ authors = [{ name = "AMEOBIUS" }]
9
+ keywords = ["mcp", "web-check", "osint", "security", "agents"]
10
+ dependencies = []
11
+
12
+ [project.scripts]
13
+ web-check-mcp = "src.server:main"
14
+
15
+ [build-system]
16
+ requires = ["setuptools>=61"]
17
+ build-backend = "setuptools.build_meta"
18
+
19
+ [tool.setuptools]
20
+ packages = ["src"]
21
+
22
+ [tool.setuptools.package-data]
23
+ src = ["py.typed"]
24
+
25
+ [tool.pytest.ini_options]
26
+ testpaths = ["tests"]
web_check_mcp-0.2.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
web_check_mcp-0.2.0/src/__init__.py ADDED
@@ -0,0 +1,7 @@
1
+ """web-check-mcp — agent wrapper for Lissy93 Web Check OpenAPI."""
2
+
3
+ __version__ = "0.2.0"
4
+
5
+ from .client import WebCheckClient, CHECKS, CHECK_GROUPS
6
+
7
+ __all__ = ["WebCheckClient", "CHECKS", "CHECK_GROUPS", "__version__"]
web_check_mcp-0.2.0/src/__main__.py ADDED
@@ -0,0 +1,5 @@
1
+ """Allow `python -m src.server` from product root."""
2
+ from .server import main
3
+
4
+ if __name__ == "__main__":
5
+ main()