mcp-toolbox
A Docker container that downloads and pre-builds MCP (Model Context Protocol) servers
claude mcp add --transport stdio timlisemer-mcp-toolbox docker exec -i mcp-toolbox npx -y @upstash/context7-mcp \ --env MCP_TOOLBOX_ENV="Path to secrets file (optional)"
How to use
This MCP server bundle provides several pre-built tools that Claude Code can call via standard input/output JSON-RPC. Each tool is built to run as a separate process and communicates over stdio, so every invocation starts a fresh process. You can access the tools inside the running Docker container with docker exec commands that target the pre-built tool entry points. For example, mcp-nixos is exposed via a Python module that starts the mcp_nixos.server, tailwind-svelte-assistant runs as a Node.js script at run.mjs, context7 is pulled in via npx, and agent-framework runs a Node.js server built under dist/mcp/server.js. Use Claude Code to register these tools by providing the appropriate command and arguments, so Claude can invoke them on demand for code search, documentation, or quality checks.
How to install
Prerequisites:
- Docker installed and running
- Access to the MCP Toolbox repository (this project)
Installation steps:
- Install Docker on your system (follow platform-specific instructions from docker.com).
- Clone the MCP Toolbox repository: git clone https://github.com/your-org/mcp-toolbox.git
- Build and run the Docker container (examples assume a Makefile is provided as shown in the README): cd mcp-toolbox make build make run
- Verify tools are available inside the container: docker exec -i mcp-toolbox ls -l /app/tools
- (Optional) Persist tool data by enabling docker_volume: true in your deployment configuration, so tool data lives under hosts/servers as described in the README.
Additional notes
- Tools communicate via JSON-RPC over stdin/stdout. Each invocation should be treated as an isolated process.
- If you enable docker_volume: true for a tool, its data and native dependencies are stored on the host in the servers/ directory, enabling native execution outside the container.
- You can register tools with Claude Code using commands like claude mcp add <tool-name> -- docker exec -i mcp-toolbox <appropriate-entrypoint>, or by editing the Claude Code MCP settings JSON under ~/.claude/settings.json as demonstrated in the README.
- For context7 and the Node-based tools, ensure the required runtimes (Node, Python) are available in the container image or on the host if you choose native execution.
Related MCP Servers
sandbox
A Model Context Protocol (MCP) server that enables LLMs to run ANY code safely in isolated Docker containers.
mcp-rest-api
A TypeScript-based MCP server that enables testing of REST APIs through Cline. This tool allows you to test and interact with any REST API endpoints directly from your development environment.
awesome s
A curated list of excellent Model Context Protocol (MCP) servers.
Kilntainers
MCP server to give every agent an ephemeral Linux sandboxes for executing shell commands.
Python-Runtime-Interpreter
PRIMS is a lightweight, open-source Model Context Protocol (MCP) server that lets LLM agents safely execute arbitrary Python code in a secure, throw-away sandbox.
mcp-sysoperator
MCP for Ansible, Terraform, LocalStack, and other IaC tools. Create and iterate IaC