容器化MCP服务器工具库

# Example: naabu-mcp on port 8105
docker pull hackerdogs/naabu-mcp:latest
docker run -d --name naabu-mcp -p 8105:8105 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8105 \
  hackerdogs/naabu-mcp:latest

cd naabu-mcp
docker build -t hackerdogs/naabu-mcp:latest .
docker run -d --name naabu-mcp -p 8105:8105 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8105 \
  hackerdogs/naabu-mcp:latest

cd naabu-mcp
docker compose up -d

cd mcpfarm

# One or more MCP servers (direct host ports)
docker compose up -d --no-deps naabu-mcp dnsx-mcp

# Or via deploy.sh (preferred when you also want farm infra)
./deploy.sh start naabu-mcp dnsx-mcp

http://<host>:<port>/mcp

{
  "mcpServers": {
    "naabu": {
      "type": "http",
      "url": "http://localhost:8105/mcp"
    }
  }
}

npx @modelcontextprotocol/inspector

PORT=8105
SESSION_ID=$(curl -s -D - -X POST "http://localhost:${PORT}/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST "http://localhost:${PORT}/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl -s -X POST "http://localhost:${PORT}/mcp" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

{
  "mcpServers": {
    "julius-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT", "hackerdogs/julius-mcp:latest"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

docker run -d --name virustotal-mcp -p 8369:8369 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8369 \
  -e VIRUSTOTAL_API_KEY=your-key \
  hackerdogs/virustotal-mcp:latest

run_semgrep(
  source_url="https://github.com/org/repo",
  arguments="scan {source} --config auto"
)

scan_path(path="https://github.com/org/repo")

download_file(url="https://example.com/firmware.bin")
# Returns: {"path": "/app/workdir/abc123/firmware.bin", "job_id": "abc123"}

run_binwalk(arguments="/app/workdir/abc123/firmware.bin")
run_checksec(arguments="--file /app/workdir/abc123/firmware.bin")

cleanup_downloads(job_id="abc123")

<tool>-mcp/
├── Dockerfile              # Multi-stage Docker build
├── mcp_server.py           # FastMCP server wrapping the CLI tool
├── hd_fetch.py             # URL download utility (file-dependent tools)
├── requirements.txt        # Python dependencies
├── publish_to_hackerdogs.sh # Build & publish script
├── mcpServer.json          # MCP client configuration
├── docker-compose.yml      # Standalone compose file
├── test.sh                 # Test script
├── README.md               # Tool-specific documentation
└── progress.md             # Implementation progress tracking

cd julius-mcp
./publish_to_hackerdogs.sh --build                    # Build locally
./publish_to_hackerdogs.sh --publish hackerdogs       # Publish to Docker Hub
./publish_to_hackerdogs.sh --build --publish hackerdogs # Build and publish
./publish_to_hackerdogs.sh --help                     # Show help

cd julius-mcp
./test.sh

MCP Client (Cursor/Claude) ──MCP──▶ ivre-mcp ──HTTP──▶ IVRE Web (Nginx+uWSGI) ──▶ MongoDB

{
  "mcpServers": {
    "ivre-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network", "ivre-deployment_default",
               "-e", "IVRE_WEB_URL", "-e", "MCP_TRANSPORT",
               "hackerdogs/ivre-mcp:latest"],
      "env": {
        "IVRE_WEB_URL": "http://ivreweb:80",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

docker run -d --rm --network ivre-deployment_default \
  -e IVRE_WEB_URL=http://ivreweb:80 \
  -e MCP_TRANSPORT=streamable-http -e MCP_PORT=8366 \
  -p 8366:8366 hackerdogs/ivre-mcp:latest

Client → Caddy (:8485) → forward_auth → auth-gateway (:9090) → MCP server containers
                                              │
                                         SQLite + Redis
                                         (keys, audit, vectors)

git clone <repo-url>
cd hd-mcpservers-docker/mcpfarm

ADMIN_SECRET=<your-secret> ./deploy.sh up --skip-build
./deploy.sh start naabu-mcp   # example tool — replace with any name from port-map.json
./deploy.sh status

# Clone farm config (compose, Caddyfile, port-map.json) — images still pull from Hub
git clone <repo-url>
cd hd-mcpservers-docker/mcpfarm

# Create external Docker network `hdnet` (auth-gateway attaches here for Redis)
docker network create hdnet 2>/dev/null || true

# Write ADMIN_SECRET used by X-Admin-Secret /admin calls (port stays 8485 unless FARM_PORT set)
echo "ADMIN_SECRET=<your-secret>" > .env

# Download + start only farm infra: auth-gateway, Caddy (:8485), mcpfarm-ui — not the 400 tools
docker compose pull auth-gateway caddy mcpfarm-ui
docker compose up -d auth-gateway caddy mcpfarm-ui

# Load port-map.json into SQLite `servers`; create seed-admin API key on first run (print once)
docker exec mcpfarm-auth python seed.py

# Build Caddy routes from `servers` and hot-reload so /{name}/* proxies to each tool
curl -s -X POST http://localhost:8485/admin/reload \
  -H "X-Admin-Secret: <your-secret>"

# Optional: pull/start one tool container (naabu-mcp = example; any port-map.json name works)
docker compose up -d --no-deps naabu-mcp

{
  "mcpServers": {
    "naabu": {
      "type": "http",
      "url": "http://localhost:8485/naabu-mcp/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

cd mcpfarm
ADMIN_SECRET=<strong-secret> \
MCPFARM_SECRETS_KEY=<fernet-key> \
./deploy.sh up --skip-build