Local Utilities MCP Server

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

さまざまなローカルシステムユーティリティへのアクセスを提供する、Model Context Protocol（MCP）サーバーです。このサーバーは、Cursor やその他の MCP 対応クライアントと一緒に使用して、システム情報にすばやくアクセスできます。

機能

このサーバーでは、次のユーティリティを利用できます。

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

インストール

グローバルインストール

pnpm add -g localutils-mcp-server

npx を使用する場合

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

npx localutils-mcp-server

使用方法

サーバーの起動

グローバルにインストールした場合：

localutils-mcp

npx の場合：

npx localutils-mcp-server

Cursor での使用

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

1. Cursor の設定を開きます
2. MCP セクションに移動します
3. 次の構成で新しい MCP サーバーを追加します

   {
     "mcpServers": {
       "localutils": {
         "command": "npx",
         "args": ["github:arjshiv/localutils-mcp-server"]
       }
     }
   }
   

MCP Inspector の使用

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

pnpm run inspector

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

利用可能なツール

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 でパッケージを使う際に事前のビルドを不要にするため、build フォルダーは git リポジトリに含まれています。

リポジトリをクローンした後に pre-commit フックを設定するには：

pnpm install

これにより、依存関係がインストールされ、Husky を使って pre-commit フックが設定されます。

ライセンス

MIT