KingBuilds MCP Server
This is a production-ready MCP server providing four core tools for sandboxed file operations, web scraping, data transformation, and authenticated HTTP requests.
File Operations: Read, write, and list files within a sandboxed directory (
/app), with path traversal protection, size limits, and automatic parent directory creation.Web Scraping: Fetch public web pages to extract titles, visible text (scripts/styles stripped), outgoing links, or specific elements via CSS selectors. Includes SSRF protection blocking private/loopback addresses.
Data Transformation: Convert between JSON and CSV formats, and perform aggregations (sum, average, min, max, count, unique) on structured or flat data.
HTTP Requests: Make authenticated HTTP requests (GET, POST, PUT, PATCH, DELETE, HEAD) to public APIs with custom headers, query params, and flexible request bodies. Supports server-managed authentication (Bearer token or API key) and SSRF protection on every redirect hop.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@KingBuilds MCP Server scrape the title and links from https://example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
KingBuilds MCP Server
Production-ready reference MCP server with 4 tools:
file_ops — Sandboxed file read/write/list within allowed directory
web_scraper — Clean HTML extraction (title, text, links, CSS selectors)
data_transform — JSON↔CSV conversion + aggregation (sum/avg/count/min/max/filter/sort)
http_request — Authenticated HTTP requests with SSRF protection
Architecture
This server is built on the Soliven architecture — the autonomous build agent running on this VPS. Shared patterns:
Component | Purpose | Soliven Reference |
| Path traversal protection, SSRF-safe URL validation | Soliven sandbox |
| Safe HTTP client with redirect validation | Soliven outbound requests |
| Pydantic Settings with | Soliven config |
Dual transport | stdio (Claude Desktop) + HTTP/SSE (web) | Soliven multi-interface |
Structured logging | Consistent format across all tools | Soliven observability |
Related MCP server: Enhanced Fetch MCP
Quickstart
# Install
pip install -e .
# Run stdio transport (for Claude Desktop)
mcp-server-stdio
# Run HTTP/SSE server
mcp-server-httpConfiguration
Environment variables:
ALLOWED_DIR— Sandbox directory for file operations (default:./data)MCP_TRANSPORT—stdioorstreamable-http(default:streamable-http)MCP_HOST— Host to bind (default:0.0.0.0)MCP_PORT— Port for HTTP transport (default:8080)MAX_FILE_BYTES— Max file size for read/write (default:1048576)REQUEST_TIMEOUT— HTTP request timeout seconds (default:30)
Tools
file_ops
read_file(path: str)— Read UTF-8 text filewrite_file(path: str, content: str, overwrite: bool)— Write filelist_directory(path: str)— List directory contents
Example prompts:
"Read the README.md file and summarize it"
"Create a file called todo.txt with my task list"
"List all files in the data directory"
web_scraper
fetch_page(url: str, selector: str = None)— Fetch and extract HTML content
Example prompts:
"Fetch the latest headlines from Hacker News"
"Get the title and main text from this article URL"
"Extract all links from this page matching
.titleline a"
data_transform
transform_data(data: list, operation: str, **kwargs)— Transform data
Example prompts:
"Convert this JSON data to CSV"
"Calculate the average score from this data"
"Sum these numbers: [10, 20, 30, 40, 50]"
"Count unique values in the 'category' field"
http_request
http_request(method: str, url: str, headers: dict, body: dict, auth: dict)— Make HTTP requests
Example prompts:
"Call this API endpoint and return the JSON response"
"POST this data to the webhook with Bearer auth"
Example Tool Calls (MCP JSON-RPC)
file_ops
{"name": "read_file", "arguments": {"path": "README.md"}}
{"name": "write_file", "arguments": {"path": "notes.txt", "content": "Hello from MCP!", "overwrite": true}}
{"name": "list_directory", "arguments": {"path": "."}}web_scraper
{"name": "scrape_web_page", "arguments": {"url": "https://example.com"}}
{"name": "scrape_web_page", "arguments": {"url": "https://news.ycombinator.com", "selector": ".titleline a", "max_links": 10}}data_transform
{"name": "transform_data", "arguments": {"data": "[{\"name\": \"Alice\", \"age\": 30}, {\"name\": \"Bob\", \"age\": 25}]", "input_format": "json", "operation": "convert", "output_format": "csv"}}
{"name": "transform_data", "arguments": {"data": "[10, 20, 30, 40, 50]", "input_format": "json", "operation": "sum"}}
{"name": "transform_data", "arguments": {"data": "[{\"score\": 85}, {\"score\": 92}, {\"score\": 78}]", "input_format": "json", "operation": "average", "field": "score"}}http_request
{"name": "http_request", "arguments": {"method": "GET", "url": "https://api.github.com/users/octocat"}}
{"name": "http_request", "arguments": {"method": "POST", "url": "https://api.example.com/data", "headers": {"Content-Type": "application/json"}, "body": {"key": "value"}, "auth": {"scheme": "bearer", "token": "your-token-here"}}}Claude Desktop Config
{
"mcpServers": {
"kingbuilds-mcp": {
"command": "mcp-server-stdio",
"env": {
"ALLOWED_DIR": "/home/user/data"
}
}
}
}Deployment
# Docker
docker-compose up -d
# Systemd
sudo cp deploy/systemd/claude-mcp-server.service /etc/systemd/system/
sudo systemctl enable --now claude-mcp-serverSecurity
File operations sandboxed to
ALLOWED_DIRwith path traversal protectionSSRF protection: private/loopback/link-local IPs blocked by default
Request size/timeouts enforced
Input validation on all tool inputs
License
MIT
Available Tools
6 toolshttp_requestA
Make an authenticated HTTP request to a public API. The server attaches its own configured credential (bearer token or API key) — do not attempt to pass Authorization headers yourself, they will be ignored. GET/POST/PUT/PATCH/DELETE/HEAD supported. Blocks requests to private, loopback, link-local, and other non-public addresses, and re-validates every redirect hop.
Inputs: url (required), body, method, headers, +2 more. Returns: object
list_directoryA
List files and subdirectories within the server's sandboxed directory (/app). Path is relative to that directory ('' or '.' for the root).
Inputs: path. Returns: object
read_fileA
Read a UTF-8 text file from within the server's sandboxed directory (/app). Path is relative to that directory. Refuses files above the configured size limit or outside the sandbox.
Inputs: path (required). Returns: object
scrape_web_pageA
Fetch a public web page and extract its content. Without selector, returns the page title, visible text (script/style stripped), and outgoing links. With selector, returns the text of every element matching that CSS selector instead. Blocks requests to private, loopback, link-local, and other non-public addresses.
Inputs: url (required), selector, max_links. Returns: object
transform_dataA
Transform or aggregate tabular/record data. operation='convert' converts between JSON (array of objects) and CSV (requires output_format). operation in {sum, average, min, max, count, unique} aggregates a single field across the records (omit field if data is a flat JSON array of numbers).
Inputs: data (required), operation (required), input_format (required), field, +1 more. Returns: object
write_fileA
Write UTF-8 text to a file within the server's sandboxed directory (/app). Path is relative to that directory. Creates parent directories as needed; refuses to write outside the sandbox or above the configured size limit.
Inputs: path (required), content (required), overwrite. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct operation: HTTP requests, directory listing, file reading, web scraping, data transformation, and file writing. No two tools overlap in purpose, making selection unambiguous.
Five of six tools follow a verb_noun pattern (list_directory, read_file, scrape_web_page, transform_data, write_file). http_request breaks the pattern as it is noun_noun, creating a minor inconsistency.
With six tools, the server offers a focused set covering file operations, web access, and data manipulation. The count is appropriate for the scope and doesn't feel sparse or bloated.
The set covers core capabilities: file read/write, directory listing, HTTP requests, web scraping, and data transformation. Missing operations like file deletion or appending are minor gaps given the sandboxed environment.
Maintenance
Related MCP Connectors
Sandbox workspace tools: search, file read, DB queries, integrations. Returns synthetic data.
Run AI agent tasks in isolated sandboxes with a cost cap, saved workflows and scoped connections.
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
Execution platform for AI agents on Firecracker microVMs in the EU. Interactive Linux sandboxes with root, templates for Python, Node.js, Go, Rust and a headless browser, public HTTPS URLs. Background jobs that outlive the connection, batches of up to 1,000 jobs with dependencies, hard cost caps reserved up front, execution receipts with SHA-256, log digests that fit the context. IPv4, dual-stack or IPv6-only with its own public address, allowlists or no network. WASI runtime for small tasks. Idle sandboxes sleep and keep their files. Also REST API, Python SDK and LangChain.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides secure filesystem operations, HTTP fetching with SSRF protection, JSON validation, artifact logging, and optional Redis key-value storage through both stdio and HTTP transports. Features production-ready security controls including sandbox enforcement, allowlist validation, and comprehensive input validation.Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides advanced web scraping with HTTP client, smart content extraction to Markdown, browser automation via Playwright, screenshot/PDF generation, and Docker sandbox execution environments.1MIT
- AlicenseNot gradedqualityCmaintenanceProvides sandboxed code execution for AI agents with support for Python, JavaScript, and shell commands. Includes comprehensive safety features like destructive pattern blocking, timeout protection, and restricted file access for secure production use.35 PyPIMIT
- AlicenseCqualityDmaintenanceProvides secure file system, web fetching, and Google Cloud Storage access for AI IDEs.6ISC