ローカルユーティリティMCPサーバー

様々なローカルシステムユーティリティへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、Cursorやその他のMCP互換クライアントと併用することで、システム情報への迅速なアクセスを提供します。

特徴

サーバーは次のユーティリティを提供します。

• 時刻と日付: 現在の現地の時刻と日付（曜日を含む）をさまざまな形式で取得します
• ホスト名: システムのホスト名を取得する
• パブリックIP : マシンのパブリックIPアドレスを取得します
• ディレクトリ一覧: 指定されたディレクトリの内容を一覧表示します
• Node.js バージョン: 現在実行中の Node.js バージョンを取得します
• ポートチェッカー: 特定のポートで実行されているプロセスを確認します
• 思考ツール: 開発セッション中に思考を記録、取得、分析します

インストール

グローバルインストール

npx での使用

グローバルにインストールせずに、npx を使用してサーバーを直接実行することもできます。

使用法

サーバーの起動

グローバルにインストールされている場合:

npx の場合:

カーソルの使用

Cursor の設定でサーバーを MCP サーバーとして構成することにより、Cursor でサーバーを使用できます。

1. カーソル設定を開く
2. MCPセクションに移動する
3. 次の構成で新しい MCP サーバーを追加します。
   { "name": "localutils", "command": "npx", "args": ["localutils-mcp-server"] }

MCPインスペクターの使用

MCP Inspector を使用してサーバーをテストできます。

これにより、 http://localhost:5173で MCP Inspector が起動します。

利用可能なツール

get_time_and_date

現在のローカルの時刻と日付を、次のようなさまざまな形式で返します。

• 現地時間
• 現地の日付
• 曜日
• ISO 8601形式
• Unixタイムスタンプ

get_hostname

MCP サーバーを実行しているマシンのホスト名を返します。

get_public_ip

MCP サーバーを実行しているマシンのパブリック IP アドレスを返します。

list_directory

指定されたディレクトリの内容を一覧表示します。

パラメータ:

• path （文字列、必須）: リストへのディレクトリパス

get_node_version

MCP サーバーを実行している環境の Node.js バージョン情報を返します。

check_port

特定のポート上で実行されているプロセスを確認します。

パラメータ:

• port （数値または文字列、必須）：チェックするポート番号（1～65535）。文字列値は自動的に数値に変換されます。

応答例 (macOS/Linux):

think

新しい考えをタイムスタンプとともに記録します。

パラメータ:

• thought (文字列、必須): 記録する思考内容

応答例:

get_thoughts

記録されたすべての考えを取得します。

応答例:

clear_thoughts

記録された思考をすべて消去します。

応答例:

get_thought_stats

記録された思考に関する統計を返します。

応答例:

発達

建物

開発モードで実行

テスト

Gitワークフロー

このリポジトリには、コミット前にサーバーを自動的にビルドするpre-commitフックが含まれています。これにより、リポジトリ内のビルドファイルが常に最新の状態になります。

ビルド フォルダーは、最初にビルドしなくても npx でパッケージを簡単に使用できるようにするために、git リポジトリに含まれています。

リポジトリのクローン作成後にコミット前フックを設定するには:

これにより、依存関係がインストールされ、Husky を介してコミット前のフックが設定されます。

ライセンス

マサチューセッツ工科大学