docs: nest 19 files into audit/ clients/ infrastructure/ monitoring/ projects/ super-search/

2026-08-08 13:04:55 -04:00
parent 11a1110b81
commit a522d11c35
20 changed files with 927 additions and 0 deletions
@@ -0,0 +1,55 @@
+# OSINT Person MCP -- Super Search Integration
+
+**Created:** 2026-08-08
+**Service:** OSINT Person MCP (Core, port 8902)
+**Integration:** Super Search MCP (Core, port 8899)
+
+---
+
+## Overview
+
+The OSINT Person MCP now integrates with Super Search via a dedicated client module. This mirrors the IntelSight pattern: an MCP server that calls Super Search tools through the local MCP endpoint at `http://127.0.0.1:8899/mcp`.
+
+## Architecture
+
+```
+OSINT Person MCP (port 8902)
+    -> super_search.py (MCP client module)
+    -> http://127.0.0.1:8899/mcp (Super Search MCP endpoint)
+    -> Super Search tools (web_search, web_extract, etc.)
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `/root/docker/osint-person-mcp/super_search.py` | MCP client module (5.6K) |
+| `/root/docker/osint-person-mcp/server.py` | Main OSINT Person server |
+| `/root/docker/super-search/server.py` | Super Search MCP (referenced as dependency) |
+
+## Client Module (super_search.py)
+
+The module provides MCP client wrappers for Super Search tools:
+- Call Super Search via `http://127.0.0.1:8899/mcp`
+- Tool passthrough: any Super Search tool is available to OSINT Person
+- Pattern mirrors IntelSight's `intelsight_api.py`
+
+## Clients
+
+| Client | Role |
+|--------|------|
+| `hermes` | Hermes Agent skip tracing tasks |
+| `dre-osint` | DRE background research |
+
+## Service Status
+
+```
+systemctl is-active osint-person-mcp  -> active
+ss -tlnp | grep 8902                  -> 127.0.0.1:8902
+```
+
+## Related
+
+- Super Search v2.4.0: `/root/projects/itpp-infrastructure/docs/super-search-v2.4.0-client-tracking.md`
+- IntelSight API: Core :8099
+- DRE MCP: Core :8900