utilities-box-mcp-server

utilities-box-mcp-server

時間管理、システム情報など、さまざまなタスクに役立つユーティリティとツールを備えた MCP サーバーです。

こちらもご覧ください。

• modelcontextprotocol/python-sdk
• Python プロジェクトに 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

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つの時刻の差を計算します。

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

   1つまたは複数のファイルの内容を、ファイルごとの最大サイズ10MBの制限で読み込みます。 UTF-8 エンコードの file_path と content を含む項目の content_list を返します。

ネットワークツール

1. check_connectivity

   タイムアウトおよびプロキシのオプションを指定して、curl コマンドを使い宛先への接続を確認します。 接続状態の説明を返します。

2. ping

   タイムアウトと回数を指定して（いずれも省略可）、DNS 名または IP アドレスに ping を実行します。ping コマンドの詳細を返します。

その他のツール

1. evaluate

   指定された変数（ある場合）を使って、指定された数値式を評価します。 式の数値を返します。

2. generate_uuid

   指定されたバージョンの UUID を1つまたは複数生成します。省略した場合は、バージョン4（ランダム）の UUID を1つ生成します。 UUID 文字列のリストを返します。

3. sleep

   指定した時間だけスリープします。