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

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

特徴

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

• 時刻と日付: 現在の現地の時刻と日付（曜日を含む）をさまざまな形式で取得します

• ホスト名: システムのホスト名を取得する

• パブリックIP : マシンのパブリックIPアドレスを取得します

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

• Node.js バージョン: 現在実行中の Node.js バージョンを取得します

• ポートチェッカー: 特定のポートで実行されているプロセスを確認します

• 思考ツール: 開発セッション中に思考を記録、取得、分析します

Related MCP server: MCP LLMS-TXT Documentation Server

インストール

グローバルインストール

pnpm add -g localutils-mcp-server

npx での使用

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

npx localutils-mcp-server

使用法

サーバーの起動

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

localutils-mcp

npx の場合:

npx localutils-mcp-server

カーソルの使用

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

1. カーソル設定を開く

2. MCPセクションに移動する

3. 次の構成で新しい MCP サーバーを追加します。

   {
     "name": "localutils",
     "command": "npx",
     "args": ["localutils-mcp-server"]
   }

MCPインスペクターの使用

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

pnpm run 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):

{
  "processes": [
    {
      "command": "node",
      "pid": "12345",
      "user": "username",
      "fd": "12u",
      "type": "IPv4",
      "device": "0x1234567890",
      "size": "0t0",
      "node": "TCP",
      "name": "*:3000 (LISTEN)"
    }
  ],
  "message": "Found 1 process(es) using port 3000"
}

think

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

パラメータ:

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

応答例:

{
  "success": true,
  "data": {
    "message": "Thought recorded successfully"
  }
}

get_thoughts

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

応答例:

{
  "success": true,
  "data": {
    "thoughts": [
      {
        "timestamp": "2025-03-24T15:00:00.000Z",
        "content": "Need to update the documentation"
      }
    ]
  }
}

clear_thoughts

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

応答例:

{
  "success": true,
  "data": {
    "message": "All thoughts cleared"
  }
}

get_thought_stats

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

応答例:

{
  "success": true,
  "data": {
    "totalThoughts": 1,
    "averageLength": 28,
    "oldestThought": "2025-03-24T15:00:00.000Z",
    "newestThought": "2025-03-24T15:00:00.000Z"
  }
}

発達

建物

pnpm run build

開発モードで実行

pnpm run dev

テスト

pnpm test

Gitワークフロー

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

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

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

pnpm install

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

ライセンス

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