mirror of https://github.com/mblanke/ThreatHunt.git synced 2026-03-01 05:50:21 -05:00

Files

mblanke 9b98ab9614 feat: interactive network map, IOC highlighting, AUP hunt selector, type filters

- NetworkMap: hunt-scoped force-directed graph with click-to-inspect popover
- NetworkMap: zoom/pan (wheel, drag, buttons), viewport transform
- NetworkMap: clickable IP/Host/Domain/URL legend chips to filter node types
- NetworkMap: brighter colors, 20% smaller nodes
- DatasetViewer: IOC columns highlighted with colored headers + cell tinting
- AUPScanner: hunt dropdown replacing dataset checkboxes, auto-select all
- Rename 'Social Media (Personal)' theme to 'Social Media' with DB migration
- Fix /api/hunts timeout: Dataset.rows lazy='noload' (was selectin cascade)
- Add OS column mapping to normalizer
- Full backend services, DB models, alembic migrations, new routes
- New components: Dashboard, HuntManager, FileUpload, NetworkMap, etc.
- Docker Compose deployment with nginx reverse proxy

2026-02-19 15:41:15 -05:00

1.7 KiB

Raw Permalink Blame History

MCP Server Design (Agent-First)

Build MCP servers like you're designing a UI for a non-human user.

This skill distills Phil Schmid's MCP server best practices into concrete repo rules. Source: "MCP is Not the Problem, It's your Server" (Jan 21, 2026).

1) Outcomes, not operations

Do not wrap REST endpoints 1:1 as tools.
Expose high-level, outcome-oriented tools.
- Bad: get_user, list_orders, get_order_status
- Good: track_latest_order(email) (server orchestrates internally)

2) Flatten arguments

Prefer top-level primitives + constrained enums.
Avoid nested dict/config objects (agents hallucinate keys).
Defaults reduce decision load.

3) Instructions are context

Tool docstrings are instructions:
- when to use the tool
- argument formatting rules
- what the return means
Error strings are also context:
- return actionable, self-correcting messages (not raw stack traces)

4) Curate ruthlessly

Aim for 5–15 tools per server.
One server, one job. Split by persona if needed.
Delete unused tools. Don't dump raw data into context.

5) Name tools for discovery

Avoid generic names (create_issue).
Prefer {service}_{action}_{resource}:
- velociraptor_run_hunt
- github_list_prs
- slack_send_message

6) Paginate large results

Always support limit (default ~20–50).
Return metadata: has_more, next_offset, total_count.
Never return hundreds of rows unbounded.

Repo conventions

Put MCP tool specs in mcp/ (schemas, examples, fixtures).
Provide at least 1 "golden path" example call per tool.
Add an eval that checks:
- tool names follow discovery convention
- args are flat + typed
- responses are concise + stable
- pagination works

1.7 KiB Raw Permalink Blame History Unescape Escape