MCP PCコントロールサーバー

ファイル操作、ディレクトリ管理、コマンド実行、システム調査、プロセス管理など、包括的なPC制御機能を提供する強力なModel Context Protocol (MCP) サーバーです。AIアシスタント（Claude、GPT、Geminiなど）がホストマシンを完全かつ効率的に制御できるように設計されています。

機能

ファイル操作

read_file - 適切なエンコーディングでファイルの内容全体を読み取る
read_file_lines - ファイルの特定の範囲の行を読み取る（大きなファイルで効率的）
write_file - 新規ファイルの作成または既存ファイルの上書き
append_to_file - 上書きせずにファイルに内容を追記する
edit_file - diff出力を使用して正確なテキストベースの編集を行う
copy_file - ファイルを新しい場所にコピーする（ソースは保持される）
delete_file - ファイルシステムからファイルを削除する
move_file - ファイルやディレクトリの移動または名前変更
get_file_info - 詳細なファイルメタデータ（サイズ、タイムスタンプ、権限、読み取り可能性）を取得する

ディレクトリ操作

create_directory - ディレクトリを作成する（ネストされた作成をサポート）
list_directory - 詳細情報とともにディレクトリの内容を一覧表示する
delete_directory - ディレクトリとその内容を再帰的に削除する
search_files - 名前パターンに一致するファイルを再帰的に検索する

コンテンツ検索

search_in_files - ファイル内のテキストコンテンツをGrepのように検索する（オプションのファイルパターンフィルタリングおよび大文字小文字を区別しないモード付き）

システム操作

execute_command - 作業ディレクトリと設定可能なタイムアウトを指定してシェルコマンドを実行する
get_system_info - OS、CPU、メモリ、稼働時間、ホスト名、ネットワークインターフェースの詳細を取得する
list_processes - 名前フィルタを指定して実行中のプロセスを一覧表示する
get_environment - 環境変数を読み取る（一つまたはすべて）

インストール

このリポジトリをクローンまたはダウンロードします
依存関係をインストールします：

npm install

プロジェクトをビルドします：

npm run build

使用方法

サーバーの実行

サーバーはstdioを介して通信し、MCPクライアントで使用するように設計されています：

npm start

Claude Desktopでの設定

Claude Desktopの設定ファイルにこのサーバーを追加します：

macOSの場合: ~/Library/Application Support/Claude/claude_desktop_config.json

Windowsの場合: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pc-control": {
      "command": "node",
      "args": ["/absolute/path/to/first_mcp/build/index.js"]
    }
  }
}

/absolute/path/to/first_mcp をこのプロジェクトディレクトリの実際の絶対パスに置き換えてください。

他のAIクライアントでの設定

MCP互換クライアント（Claude、Cursor、Windsurf、Continueなど）は、同じstdioトランスポートアプローチを使用してこのサーバーに接続できます。クライアントで node を使用してビルド済みの build/index.js を指定してください。

npxを使用した例（代替）

{
  "mcpServers": {
    "pc-control": {
      "command": "npx",
      "args": ["-y", "mcp-pc-control-server"]
    }
  }
}

利用可能なツール

read_file

{ path: string }

read_file_lines

{
  path: string,
  start: number,  // 1-based, inclusive
  end?: number    // 1-based, inclusive (omit to read to end)
}

write_file

{ path: string, content: string }

append_to_file

{ path: string, content: string }

edit_file

{
  path: string,
  edits: [{ oldText: string, newText: string }]
}

copy_file

{ source: string, destination: string }

create_directory

{ path: string }

list_directory

{ path: string }

delete_file

{ path: string }

delete_directory

{ path: string }

move_file

{ source: string, destination: string }

get_file_info

{ path: string }

execute_command

{
  command: string,
  workingDirectory?: string,
  timeout?: number  // ms, default 30000
}

search_files

{ path: string, pattern: string }  // pattern supports * and **

search_in_files

{
  path: string,
  query: string,
  filePattern?: string,     // e.g. "*.ts"
  caseSensitive?: boolean   // default false
}

get_system_info

{}  // no arguments required

list_processes

{ filter?: string }  // optional substring filter on process name

get_environment

{ variable?: string }  // omit to get all env vars

セキュリティ上の考慮事項

警告: このサーバーは強力なファイルシステムおよびコマンド実行機能を提供します。

ファイルアクセス: プロセスが権限を持つあらゆるファイルを読み取り、書き込み、削除できます
コマンド実行: 任意のシェルコマンドを実行できます
サンドボックスなし: 操作はサンドボックス化や制限されていません

推奨事項:

信頼できるMCPクライアントでのみ使用してください
最小限の必要な権限で実行してください
execute_command および delete_directory ツールには注意してください
本番環境で使用する場合は、追加のアクセス制御の実装を検討してください
機密性の高い環境ではすべての操作を確認してください

開発

ビルド

npm run build

ウォッチモード

npm run watch

プロジェクト構造

.
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

ライセンス

MIT

貢献

貢献を歓迎します！問題の報告やプルリクエストを自由に行ってください。

トラブルシューティング

Claude Desktopにサーバーが表示されない

claude_desktop_config.json のパスが絶対パスであり、正しいことを確認してください
ビルドディレクトリが存在し、index.js が含まれていることを確認してください
設定変更後にClaude Desktopを再起動してください
Claude Desktopのログでエラーを確認してください

権限エラー

サーバープロセスが必要なファイルシステム権限を持っていることを確認してください
Unixシステムでは、ls -la でファイル/ディレクトリの権限を確認してください
必要な操作に対して適切なユーザー権限で実行してください

コマンド実行の問題

作業ディレクトリが存在し、アクセス可能であることを確認してください
シェルコマンドがオペレーティングシステムに適していることを確認してください
長時間実行されるコマンドには timeout パラメータを増やしてください
一部のコマンドには特定の環境変数が必要な場合があります