Localutils MCP Server

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

このサーバーは、モデルコンテキストプロトコル（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 サーバーを構成することで、このサーバーを使用できます。

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

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

MCP インスペクターの使用

以下のコマンドを実行することで、サーバーをテストできます。

pnpm run inspector

これにより、http://localhost:5173 で MCP インスペクターが起動します。

利用可能なツール

基本的な使用法

# サーバーの起動方法や基本的なコマンドの使用例
# グローバルインストールした場合
localutils-mcp
# npx を使用する場合
npx localutils-mcp-server

高度な使用法

# Cursor との連携や MCP インスペクターの使用など、高度なシナリオでのコマンド例
# Cursor の設定で MCP サーバーを構成
{
    "name": "localutils",
    "command": "npx",
    "args": ["localutils-mcp-server"]
}
# MCP インスペクターを起動
pnpm run 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（数値、必須）：確認するポート番号

record_thought

考えの内容を記録します。 パラメーター：

• thought（文字列、必須）：記録する考えの内容
• metadata（オブジェクト、オプション）：追加のメタデータを含むオブジェクト（例：コンテキスト情報）

retrieve_thoughts

すべての記録された考えを検索します。

delete_thought

指定した ID の考えを削除します。 パラメーター：

• id（文字列、必須）：削除する考えの一意の識別子

🔧 開発

ビルド

pnpm run build

開発モードで実行

pnpm run dev

テスト

pnpm test

Git ワークフロー

このリポジトリには、コミットする前に自動的にサーバーをビルドするプリコミットフックが含まれています。これにより、ビルドファイルが常にリポジトリと同期されます。 ビルドファイルは、npx を使用してビルドせずにすぐに使用できるように、git リポジトリに含まれています。 プリコミットフックを設定するには、リポジトリをクローンした後、以下のコマンドを実行します。

pnpm install

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

📄 ライセンス

MIT