实用程序盒mcp服务器
MCP服务器,具有用于各种任务的实用程序和工具,包括时间管理、系统信息等。
另请参见:
- 模型上下文协议/python sdk
- 将MCP添加到python项目中
安装并运行
使用pip安装```bash
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
### 从源代码安装```bash
cd /path/to/your/project
pip install .
跑```bash
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` 运输。 |
**命令行用法:**```bash
$ 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:```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"
}
}
}
或者:```json
{
"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: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
工具
任务和时间管理工具
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
睡眠指定的时间。
