Firecrawl-backed web scrape MCP server with browser cookie support
Project description
web-mcp-tools
Standalone MCP server and Python package for Firecrawl-backed web scraping with optional browser-cookie request headers.
Install
uv sync --extra dev
Configuration
FIRECRAWL_BASE_URL: Firecrawl API base URL.FIRECRAWL_API_KEYorFIRECRAWL_API_KEY_FILE: Firecrawl API credential.WEB_MCP_TOOLS_COOKIES_FROM_BROWSER: Optional browser selector for authenticated scrapes, for examplesafariorsafari:/path/to/Cookies.binarycookies.WEB_MCP_TOOLS_COOKIES_MODE:off,best_effort, orrequired.WEB_MCP_TOOLS_HOST: HTTP bind host for MCP HTTP transports.WEB_MCP_TOOLS_PORT: HTTP bind port for MCP HTTP transports.WEB_MCP_TOOLS_STREAMABLE_HTTP_PATH: Streamable HTTP endpoint path. Defaults to/mcp.
Run
Run over stdio:
uv run web-mcp-tools mcp
Run over Streamable HTTP:
uv run web-mcp-tools mcp --transport streamable-http --host 0.0.0.0 --port 8000
The HTTP server exposes health probes at /health and /healthz, and the default Streamable HTTP MCP endpoint at /mcp.
Compatibility health-only server:
uv run web-mcp-tools serve --host 127.0.0.1 --port 8000
Build
uv build
Test
uv run pytest
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file web_mcp_tools-0.0.1.tar.gz.
File metadata
- Download URL: web_mcp_tools-0.0.1.tar.gz
- Upload date:
- Size: 12.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
400b7d62bce2acfcc7e3d88bcf0040b9d0611fa4de521b4f624acc0aa0520df7
|
|
| MD5 |
2e7acf5d1671b4666b30cdc6a3941b9f
|
|
| BLAKE2b-256 |
85d52307801cba3c2784c2e989b20d4c69852c27338df7553c293e2cbc3b46c6
|
File details
Details for the file web_mcp_tools-0.0.1-py3-none-any.whl.
File metadata
- Download URL: web_mcp_tools-0.0.1-py3-none-any.whl
- Upload date:
- Size: 16.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.4 {"installer":{"name":"uv","version":"0.11.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b1de4e8f14651ca02a5bae0c3723b815f75db1b5c1d72d9b1fef5d173b669ec1
|
|
| MD5 |
9dc76e89c4d5cba13b1c6d08e1041a46
|
|
| BLAKE2b-256 |
4d7488df07b390f2048d477fd15f1b0c6421a3a29cb90e8fdfbb3d28eed3f62b
|
