实用程序盒mcp服务器
MCP服务器,具有用于各种任务的实用程序和工具,包括时间管理、系统信息等。
另请参见:
安装并运行
使用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从源代码安装
cd /path/to/your/project
pip install .跑
# 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-serverMCP配置
可用环境变量:
| 名称 | 默认值 | 说明 |
|---|---|---|
UTILITIES_BOX_MCP_SERVER_NAME | Utilities Box MCP Server | MCP服务器的名称。 |
UTILITIES_BOX_ENABLED_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 | *空* | 禁用工具的逗号分隔列表。如果为空,则不禁用任何工具。看 UTILITIES_BOX_ENABLED_TOOLS 对于可用的工具。 |
UTILITIES_BOX_SSE_BIND_HOST | 0.0.0.0 | 将服务器绑定到的主机(仅限sse传输)。 |
UTILITIES_BOX_TRANSPORT | stdio | 要使用的运输类型。可以是 stdio 或 sse. |
UTILITIES_BOX_HOST | 0.0.0.0 | 将服务器绑定到的主机(仅限sse传输)。 |
UTILITIES_BOX_PORT | 41104 | 服务器使用的端口(仅限sse传输)。 |
UTILITIES_BOX_SSE_DEBUG_ENABLED | false | 为sse传输启用调试模式(仅限sse传输)。 |
SIMP_LOGGER_LOG_CONSOLE_ENABLED | true | 启用控制台日志记录, 必须 如果使用,则禁用 stdio 运输。 |
命令行用法:
$ 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
示例端点: http://127.0.0.1:41102/sse
标准
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"
}
}
}或者:
{
"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"使用Docker运行
请参阅:
工具
任务和时间管理工具
calc_time_diff
以指定格式计算两次之间的差值。
get_current_time
获取具有指定时区名称(可选)和格式(可选)的当前时间, 默认为本地时区和%Y-%m-%d%H:%m:%S。 以指定格式返回当前时间,包括时区名称和偏移量(如果可用)。
get_unix_timestamp
获取自1970年1月1日UTC(纪元时间)以来的当前Unix时间戳(秒)。
系统信息和状态工具
get_system_info
获取系统信息,包括系统、节点名称、版本、机器、处理器、CPU计数、内存总数、, 并交换总计。
get_system_stats
获取系统统计信息,包括启动时间、CPU计数、CPU百分比、内存百分比、内存总量、已用内存, 内存可用、交换百分比、交换总数、交换已用和交换可用。
文件系统工具
read_lines
读取最大字节限制为10MB的文件行。以utf-8编码的字符串列表形式返回。
read_files
读取一个或多个文件的所有内容,每个文件的最大大小限制为10MB。 返回一个content_list,其中包含file_path项和utf-8编码的内容。
网络工具
check_connectivity
使用带有可选超时和代理选项的curl命令检查与目标的连接。 返回连接状态的描述。
ping
使用可选的超时和计数ping DNS名称或IP地址。返回ping命令的详细信息。
其他工具
evaluate
使用给定的变量(如果有的话)计算给定的数值表达式。 返回表达式的数值。
generate_uuid
生成一个或多个具有指定版本的UUID,默认为版本4的UUID(随机)。 返回UUID字符串列表。
sleep
睡眠指定的时间。
