AI导哈

多功能工具服务器

一个提供时间管理、系统信息获取、文件操作等多样化工具服务的MCP服务器。

  • by lumerix7
  • Python
  • 混合部署
  • 更新于
在 GitHub 查看 lumerix7/utilities-box-mcp-server

使用说明

实用程序盒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-server

MCP配置

可用环境变量：

名称 默认值 说明
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运行

请参阅：

工具

任务和时间管理工具

  1. calc_time_diff

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

  2. get_current_time

    获取具有指定时区名称（可选）和格式（可选）的当前时间， 默认为本地时区和%Y-%m-%d%H:%m:%S。 以指定格式返回当前时间，包括时区名称和偏移量（如果可用）。

  3. get_unix_timestamp

    获取自1970年1月1日UTC（纪元时间）以来的当前Unix时间戳（秒）。

系统信息和状态工具

  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编码的内容。

网络工具

  1. check_connectivity

    使用带有可选超时和代理选项的curl命令检查与目标的连接。 返回连接状态的描述。

  2. ping

    使用可选的超时和计数ping DNS名称或IP地址。返回ping命令的详细信息。

其他工具

  1. evaluate

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

  2. generate_uuid

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

  3. sleep

    睡眠指定的时间。

相关 MCP