lumerix7/utilities-box-mcp-server
If you are the rightful owner of utilities-box-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A MCP Server with utilities and tools for various tasks, including time management, system information, and more.
utilities-box-mcp-server
A MCP Server with utilities and tools for various tasks, including time management, system information, and more.
See also:
Install and run
Install using pip
# Uninstall the previous version
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
Install from source
cd /path/to/your/project
pip install .
Run
# Run this server directly
utilities-box-mcp-server
# Or run this server using sse transport
export UTILITIES_BOX_PORT=41104
export UTILITIES_BOX_TRANSPORT=sse
utilities-box-mcp-server
# Or run with python
python -m utilities_box_mcp_server
# Or run with uv
uv run utilities-box-mcp-server
MCP configurations
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.
sse
Example endpoint: http://127.0.0.1:41102/sse
stdio
JSON:
{
"utilities-box": {
"type": "stdio",
"command": "utilities-box-mcp-server",
"args": [],
"env": {
"SIMP_LOGGER_LOG_CONSOLE_ENABLED": "false",
"UTILITIES_BOX_SSE_DEBUG_ENABLED": "true",
"UTILITIES_BOX_TRANSPORT": "stdio"
}
}
}
Or:
{
"utilities-box": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"utilities-box-mcp-server"
],
"env": {
"SIMP_LOGGER_LOG_CONSOLE_ENABLED": "false",
"UTILITIES_BOX_SSE_DEBUG_ENABLED": "true",
"UTILITIES_BOX_TRANSPORT": "stdio"
}
}
}
YAML:
utilities-box:
type: stdio
command: utilities-box-mcp-server
args: [ ]
env:
SIMP_LOGGER_LOG_CONSOLE_ENABLED: "false"
UTILITIES_BOX_SSE_DEBUG_ENABLED: "true"
UTILITIES_BOX_TRANSPORT: "stdio"
Run with Docker
See:
Tools
Task and time management tools
-
calc_time_diffCalculates the difference between two times in the specified format.
-
get_current_timeGets 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.
-
get_unix_timestampGets the current Unix timestamp as seconds since January 1, 1970 UTC (Epoch time).
System information and status tools
-
get_system_infoGets system information, including system, node name, release, version, machine, processor, CPU count, memory total, and swap total.
-
get_system_statsGets 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.
File system tools
-
read_linesReads the lines of a file with a max bytes limit of 10MB. Returns it as a list of strings in utf-8 encoding.
-
read_filesReads 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.
Network tools
-
check_connectivityChecks connectivity to a destination using curl command with optional timeout and proxy options. Returns a description of the connectivity status.
-
pingPings a DNS name or IP address with the optional timeout and count. Returns details of the ping command.
Other tools
-
evaluateEvaluates the given numeric expression with the given variables (if any). Returns numerical value of the expression.
-
generate_uuidGenerates one or multiple UUIDs with the specified version, defaults to one UUID of version 4 (random). Returns a list of UUID strings.
-
sleepSleeps for a specified amount of time.
