utilities-box-mcp-server
About
A MCP Server with utilities and tools for various tasks, including time management, system information, and more.
Details
- License
- MIT
Explore
- Time management tools (current time, time difference, Unix timestamp).
- System information and stats (CPU, memory, swap, boot time).
- File system tools (read lines, read multiple files, 10MB limit per file).
- Network tools (connectivity check with curl, ping).
- Expression evaluation, UUID generation, and sleep functionality.
- Tool enable/disable via environment variables.
- Supports both stdio and SSE transport protocols.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
utilities-box-mcp-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip uninstall --yes utilities-box-mcp-server
pip install utilities-box-mcp-server --upgrade --force-reinstall --extra-index-url http://127.0.0.1:8081/repository/pypi-group/simple --trusted-host 127.0.0.1
cd /path/to/your/project
pip install .
Available environment variables:
| Name | Default value | Description |
|-----------------------------------|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| UTILITIES_BOX_MCP_SERVER_NAME | Utilities Box MCP Server | Name of the MCP server. |
| UTILITIES_BOX_ENABLED_TOOLS | Empty | Comma-separated list of enabled tools. If empty, all tools are enabled. Available tools: calc_time_diff, check_connectivity, evaluate, generate_uuid, get_current_time, get_system_info, get_system_stats, get_unix_timestamp, ping, read_file, read_files, sleep. |
| UTILITIES_BOX_DISABLED_TOOLS | Empty | Comma-separated list of disabled tools. If empty, no tools are disabled. See UTILITIES_BOX_ENABLED_TOOLS for available tools. |
| UTILITIES_BOX_SSE_BIND_HOST | 0.0.0.0 | Host to bind the server to (sse transport only). |
| UTILITIES_BOX_TRANSPORT | stdio | Transport type to use. Can be stdio or sse. |
| UTILITIES_BOX_HOST | 0.0.0.0 | Host to bind the server to (sse transport only). |
| UTILITIES_BOX_PORT | 41104 | Port to use for the server (sse transport only). |
| UTILITIES_BOX_SSE_DEBUG_ENABLED | false | Enable debug mode for sse transport (sse transport only). |
| SIMP_LOGGER_LOG_CONSOLE_ENABLED | true | Enable logging to console, MUST DISABLED if using stdio transport. |
Command line usage:
$ utilities-box-mcp-server --help
usage: utilities-box-mcp-server [-h] [--transport TRANSPORT]
Utilities Box MCP Server
options:
-h, --help show this help message and exit
--transport TRANSPORT
Transport type, defaults to 'stdio', can be 'stdio' or 'see'. Use Environment variable 'UTILITIES_BOX_TRANSPORT' if not provided.
1. calc_time_diff
Calculates the difference between two times in the specified format.
2. get_current_time
Gets current time with the specified timezone name(optional) and format(optional),
defaults to local timezone and %Y-%m-%d %H:%M:%S.
Returns the current time in the specified format with timezone name and offset if available.
3. get_unix_timestamp
Gets the current Unix timestamp as seconds since January 1, 1970 UTC (Epoch time).
1. get_system_info
Gets system information, including system, node name, release, version, machine, processor, CPU count, memory total,
and swap total.
2. get_system_stats
Gets system stats, including boot time, CPU count, CPU percent, memory percent, memory total, memory used,
memory free, swap percent, swap total, swap used, and swap free.
1. read_lines
Reads the lines of a file with a max bytes limit of 10MB. Returns it as a list of strings in utf-8 encoding.
2. read_files
Reads all content of one or multiple files with a max size limit of 10MB per file.
Returns a content_list with the item of file_path and content in utf-8 encoding.
1. check_connectivity
Checks connectivity to a destination using curl command with optional timeout and proxy options.
Returns a description of the connectivity status.
2. ping
Pings a DNS name or IP address with the optional timeout and count. Returns details of the ping command.
1. evaluate
Evaluates the given numeric expression with the given variables (if any).
Returns numerical value of the expression.
2. generate_uuid
Generates one or multiple UUIDs with the specified version, defaults to one UUID of version 4 (random).
Returns a list of UUID strings.
3. sleep
Sleeps for a specified amount of time.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"utilities-box-mcp-server": {
"utilities-box-mcp-server": {
"command": "python",
"args": [
"-m",
"utilities_box_mcp_server"
]
}
}
}
}McpServers
{
"utilities-box-mcp-server": {
"command": "python",
"args": [
"-m",
"utilities_box_mcp_server"
]
}
}See also:
modelcontextprotocol/python-sdk
Adding MCP to your python project
Install and run
Install using pip
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
