utilities-box-mcp-server

utilities-box-mcp-server

一个提供各种任务所需实用工具的 MCP 服务，包括时间管理、系统信息等。

另请参阅：

• modelcontextprotocol/python-sdk
• 将 MCP 添加到你的 Python 项目

安装和运行

使用 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-server

MCP 配置

可用环境变量：

名称	默认值	说明
UTILITIES_BOX_MCP_SERVER_NAME	Utilities Box MCP Server	MCP 服务的名称。
UTILITIES_BOX_ENABLED_TOOLS	Empty	以逗号分隔的已启用工具列表。如果为空，则启用所有工具。可用工具：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	以逗号分隔的已禁用工具列表。如果为空，则不禁用任何工具。可用工具请参阅 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

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"
    }
  }
}

或者：

{
  "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 运行

请参阅：

• docker/run-utilities-box-mcp-server-in-docker.sh
• docker/0.1.0/Dockerfile
• docker/0.1.0/build.sh

工具

任务和时间管理工具

1. calc_time_diff

   以指定格式计算两个时间之间的差值。

2. get_current_time

   获取当前时间，可选指定时区名称和格式，默认使用本地时区和 %Y-%m-%d %H:%M:%S。 以指定格式返回当前时间；如果可用，还会包含时区名称和偏移量。

3. get_unix_timestamp

   获取当前 Unix 时间戳，即自 1970 年 1 月 1 日 UTC 起经过的秒数（纪元时间）。

系统信息和状态工具

1. get_system_info

   获取系统信息，包括系统、节点名称、发行版本、版本、机器、处理器、CPU 数量、内存总量 和交换空间总量。

2. get_system_stats

   获取系统统计信息，包括启动时间、CPU 数量、CPU 使用率、内存使用率、内存总量、内存已用量、 内存空闲量、交换空间使用率、交换空间总量、交换空间已用量和交换空间空闲量。

文件系统工具

1. read_lines

   读取文件中的行，最大字节数限制为 10MB。以 UTF-8 编码的字符串列表形式返回。

2. read_files

   读取一个或多个文件的全部内容，每个文件的大小上限为 10MB。 返回一个 content_list，其中包含 file_path 和以 UTF-8 编码的 content。

网络工具

1. check_connectivity

   使用 curl 命令检查与目标的连接情况，可选设置超时和代理选项。 返回连接状态说明。

2. ping

   对 DNS 名称或 IP 地址执行 ping，可选设置超时和次数。返回 ping 命令的详细信息。

其他工具

1. evaluate

   使用给定变量（如果有）计算给定的数值表达式。 返回表达式的数值。

2. generate_uuid

   根据指定版本生成一个或多个 UUID，默认生成一个版本为 4（随机）的 UUID。 返回 UUID 字符串列表。

3. sleep

   暂停指定时长。