1---
2name: silkworm-mcp-bootstrap
3description: Install and run the silkworm-mcp server from GitHub with uv (stdio or HTTP), plus quick validation commands.
4allowed-tools: Bash, Read
5---
6 
7# silkworm-mcp-bootstrap
8 
9Bootstrap helper for the upstream project:
10`https://github.com/BitingSnakes/silkworm-mcp`
11 
12Use this skill when you need to quickly install and run the Silkworm MCP server for scraper-oriented MCP workflows.
13 
14## What this skill does
15 
16- clones/updates the upstream repo into a local working directory
17- installs dependencies via `uv sync`
18- runs the server in `stdio` mode (for desktop MCP clients)
19- runs the server in `http` mode with health checks
20- provides a small smoke test path
21 
22## Quickstart
23 
24```bash
25bash scripts/setup_silkworm_mcp.sh
26bash scripts/start_silkworm_stdio.sh
27```
28 
29HTTP mode:
30 
31```bash
32bash scripts/start_silkworm_http.sh
33# health: http://127.0.0.1:8000/healthz
34# ready:  http://127.0.0.1:8000/readyz
35```
36 
37## Environment knobs
38 
39Optional runtime variables accepted by upstream server:
40 
41- `SILKWORM_MCP_DOCUMENT_MAX_COUNT`
42- `SILKWORM_MCP_DOCUMENT_MAX_TOTAL_BYTES`
43- `SILKWORM_MCP_DOCUMENT_TTL_SECONDS`
44- `SILKWORM_MCP_LOG_LEVEL`
45- `SILKWORM_MCP_READINESS_REQUIRE_CDP`
46- `SILKWORM_MCP_READINESS_CDP_WS_ENDPOINT`
47 
48## Notes
49 
50- This package is a bootstrap wrapper around the upstream repository, not a forked reimplementation.
51- Upstream repository ownership and maintenance remain with `BitingSnakes/silkworm-mcp`.
52- Before production use, validate legal/licensing suitability for your environment.
53