Simple Tool Server

What is Simple Tool Server?

Simple Tool Server is a lightweight, asynchronous Python-based server that implements the Model Context Protocol (MCP) for running and managing MCP tools in isolated, secure Docker environments.

How to use Simple Tool Server?

Deploy the Docker container (Debian 13, Python 3.13, FastAPI) and load MCP tools via uvx or npx. Access tools through SSE, Swagger REST, or OpenAPI.json endpoints. Configure tool filtering (whitelist/blacklist) and custom environment variables via JSON configuration or environment variables.

Key features of Simple Tool Server

• Local Docker container with a single SSE-MCP connection
• Dynamic tool loading and filtering (whitelist/blacklist)
• Access via SSE, Swagger REST, and OpenAPI.json
• Each MCP tool runs in its own thread for isolation
• JSON-based configuration – easy to edit and portable
• Async FastAPI Python server with full type hints

Use cases of Simple Tool Server

• Run and manage MCP tools locally in a secure, isolated Docker container
• Quickly test or prototype MCP servers using uvx/npx without complex setup
• Integrate MCP tools with OpenWebUI via OpenAPI.json endpoints
• Deploy a custom MCP server with tailored environment variables and admin authorization

FAQ from Simple Tool Server

What runtime does Simple Tool Server require?

The server runs as a Docker container built on Debian 13 with Python 3.13 and FastAPI.

How are MCP tools loaded and filtered?

Tools are launched via uvx or npx commands and can be dynamically loaded and filtered using a whitelist/blacklist configuration.

Is a database needed for configuration?

No, all configuration is stored in JSON files – no database required, making it easy to edit and portable.

How do I access the tools?

Tools are accessible via SSE (Server-Sent Events), Swagger REST API, and OpenAPI.json endpoints, compatible with OpenWebUI.

How is admin authorization handled?

A configurable Bearer token is set via environment variable for simple admin authorization, ideal for testing and quick changes.