Macos Tools MCP Server

🚀 macOS Internal Tools MCP Server

macOS用のMCPサーバーで、高度なシステム監視とファイル検索機能を提供します。

🚀 クイックスタート

このドキュメントでは、macOS用のMCPサーバーの機能、インストール方法、使用方法、テスト方法、および将来的な機能拡張について説明します。

✨ 主な機能

システムパフォーマンスモニター

• リアルタイム監視：CPU、メモリ、ディスクI/O、ネットワーク統計を追跡します。
• プロセス分析：詳細なメトリクスを持つ上位のリソース消費プロセスを表示します。
• 履歴追跡：SQLiteを使用して、時間の経過とともにパフォーマンスデータを保存および分析します。
• 最適化提案：システムパフォーマンスを向上させるためのインテリジェントな推奨事項を取得します。

拡張ファイル検索

• 深い内容検索：正規表現または平文を使用してファイル内容内を検索します。
• Spotlight統合：高速なメタデータ検索のためにmacOS Spotlightを活用します。
• タグ管理：拡張属性を使用して、カスタムファイルタグを作成、検索、管理します。
• 高度な機能：ファジーマッチング、ブール演算子、およびファイルタイプフィルタリング。

📦 インストール

要件

• macOS 10.15以降
• Node.js 18.0.0以降
• npmまたはyarnパッケージマネージャー

権限

サーバーの全機能を使用するには、特定の権限が必要です。

1. フルディスクアクセス（ファイル検索に推奨）：

   • システム環境設定 → セキュリティとプライバシー → プライバシー → フルディスクアクセス
   • ターミナルを追加

2. 開発ツール（プロセス監視用）：

   • まだインストールされていない場合は、Xcodeコマンドラインツールをインストールします。

   xcode-select --install
   

インストール方法

Claude Desktopの設定

このMCPサーバーをClaude Desktopとともに使用するには、以下の手順に従ってください。

1. Claude Desktopの設定ファイルを開きます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 設定ファイルにmacOS Toolsサーバーを追加します。

{
  "mcpServers": {
    "macos-tools": {
      "command": "npx",
      "args": [
        "@tgomareli/macos-tools-mcp"
      ],
      "env": {}
    }
  }
}

3. すでに他のMCPサーバーが設定されている場合は、macos-toolsの設定を既存のmcpServersオブジェクトに追加します。

{
  "mcpServers": {
    "existing-server": {
      // ... 既存の設定
    },
    "macos-tools": {
      "command": "npx",
      "args": [
        "@tgomareli/macos-tools-mcp"
      ],
      "env": {}
    }
  }
}

4. 設定ファイルを保存し、Claude Desktopを再起動します。

5. Claude DesktopでmacOS Toolsサーバーが利用可能になり、2つのツールが表示されるはずです。

   • system_performance - システムリソースを監視する
   • enhanced_search - 高度なファイル検索とタグ付け

MCPインストーラー

または、mcp-installerを使用して、設定ファイルを開くことなく直接インストールすることもできます。 Claudeに以下を入力してください。

Hey Claude, install the MCP server named macos-tools-mcp

💻 使用例

system_performance

システムパフォーマンスメトリクスを監視および分析します。

パラメーター：

• action（必須）: "current" | "history" | "processes" | "optimize"
• timeRange（オプション）: 履歴データの時間範囲（"1h", "24h", "7d"）
• metric（オプション）: 分析する特定のメトリクス（"cpu", "memory", "disk", "network", "all"）

基本的な使用法

await callTool("system_performance", {
  action: "current",
  metric: "all"
});

await callTool("system_performance", {
  action: "history",
  timeRange: "24h",
  metric: "memory"
});

await callTool("system_performance", {
  action: "processes",
  metric: "cpu"
});

await callTool("system_performance", {
  action: "optimize"
});

enhanced_search

内容分析とタグ付け機能を備えた高度なファイル検索です。

パラメーター：

• action（必須）: "search" | "tag" | "untag"
• query（オプション）: 検索クエリ（正規表現をサポート）
• searchType（オプション）: "content" | "filename" | "tags" | "regex"
• fileTypes（オプション）: 含めるファイル拡張子の配列
• path（オプション）: 検索のルートディレクトリ
• maxResults（オプション）: 最大結果数
• tags（オプション）: 検索または適用するタグの配列

基本的な使用法

// コードファイル内のTODOコメントを検索する
await callTool("enhanced_search", {
  action: "search",
  query: "TODO|FIXME",
  searchType: "regex",
  fileTypes: ["js", "ts", "py"],
  path: "~/Projects"
});

await callTool("enhanced_search", {
  action: "tag",
  path: "~/Documents/important.pdf",
  tags: ["urgent", "project-x"]
});

await callTool("enhanced_search", {
  action: "search",
  searchType: "tags",
  tags: ["urgent"],
  path: "~/Documents"
});

await callTool("enhanced_search", {
  action: "search",
  query: "apiKey",
  searchType: "content",
  fileTypes: ["json", "env"],
  path: "~/Projects",
  maxResults: 50
});

主な機能

1. macOSネイティブ統合

   • 最適なパフォーマンスのためにネイティブコマンド（ps、mdfind、xattr）を使用します。
   • 高速検索のためにSpotlightインデックスを活用します。
   • タグ付けのためにmacOS拡張属性をサポートします。

2. パフォーマンス最適化

   • 多段階キャッシュシステム
   • デバウンス操作
   • システム呼び出しのレート制限
   • 大きなファイルのストリーミング

3. データ永続化

   • パフォーマンス履歴のためのSQLiteデータベース
   • 設定可能なデータ保持
   • 効率的な時系列クエリ

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください。

サーバーのテスト

Claude Desktopでサーバーを設定したら、以下のプロンプトを使用してすべての機能をテストすることができます。

クイックテストプロンプト

1. 基本的なパフォーマンスチェック：

Show me my current system performance metrics

2. プロセス分析：

What are the top 5 CPU-consuming processes on my system?

3. ファイル検索：

Search for TODO comments in JavaScript files in my current directory

4. システム最適化：

Analyze my system and suggest performance optimizations

包括的なテストスイート

この包括的なプロンプトを使用して、すべての機能をテストします。

I want to test the macOS Tools MCP server. Please help me:

1. **システムパフォーマンステスト**：
   - 現在のシステムパフォーマンスメトリクス（CPU、メモリ、ディスク、ネットワーク）を表示する
   - CPUを最も多く消費している上位5つのプロセスを表示する
   - 直近1時間のメモリ使用履歴を表示する
   - システムを分析し、最適化提案を提供する
   - 最もメモリを消費しているプロセスを取得する

2. **ファイル検索テスト**：
   - ホームディレクトリ内のすべてのJavaScriptおよびTypeScriptファイルで、"TODO"または"FIXME"コメントを含むものを検索する
   - 現在のプロジェクトディレクトリ内のファイル名に"test"が含まれるすべてのファイルを検索する
   - 設定ファイル（.json、.env、.yml）内で"password"という単語を含むファイルを検索する
   - 正規表現を使用して、テキストファイル内のすべてのメールアドレスを検索する
   - 直近24時間以内に変更されたファイルを検索する

3. **タグ管理テスト**：
   - このファイルに"important"と"reviewed"のタグを付ける：/Users/tornikegomareli/Development/macos-tools-mcp/README.md
   - "important"というタグが付けられたすべてのファイルを検索する
   - READMEファイルから"reviewed"タグを削除する
   - srcディレクトリ内のすべてのTypeScriptファイルに"source-code"のタグを付ける

4. **複合操作**：
   - 大規模なファイル検索を行いながらシステムパフォーマンスを監視する
   - リソースを大量に消費するプロセスを見つけ、そのログファイルを検索する
   - 現在のディスク使用量を表示し、100MBを超える大きなファイルを検索する

5. **エッジケース**：
   - 存在しないディレクトリを検索する
   - 変更権限のないファイルにタグを付けようとする
   - 無効な時間範囲のパフォーマンスデータを要求する
   - 無効な正規表現パターンで検索する

期待される動作

• パフォーマンスモニター：リアルタイムメトリクス、プロセスリスト、履歴データ、および最適化提案を返す必要があります。
• ファイル検索：内容、名前、またはタグでファイルを検索し、正規表現パターンをサポートする必要があります。
• タグ操作：タグの追加/削除およびタグによる検索を正常に行う必要があります。
• エラー処理：権限エラー、無効なパス、および不正なクエリを適切に処理する必要があります。

将来的な機能拡張

• [ ] GPU監視サポート
• [ ] ネットワーク接続分析
• [ ] アプリケーション固有のパフォーマンス追跡
• [ ] ファイルバージョン検索のためのTime Machineとの統合