Mypc MCP

🚀 MYPC-MCP

MYPC-MCPは、強力なModel Context Protocol (MCP) サーバーで、AIエージェントにローカルWindows PCの包括的な制御を提供します。これはAIアシスタントのバトラーのような存在で、AIに視覚（スクリーンショット）、聴覚（システム状態）、手足（制御）、音声（自動化）の機能を与えます。

🚀 クイックスタート

1行でのインストール (Windows)

# ダブルクリックで実行 - すべてを自動的にチェックしてインストールします
start.bat

または手動で:

# インストール
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

# 起動
python main.py

サーバーはデフォルトで http://localhost:9999 で起動します。

✨ 主な機能

• 🖥️ 画面ツール：全画面、アクティブウィンドウ、ウェブカメラのキャプチャとAI分析
• 🪟 ウィンドウ管理：ウィンドウの一覧表示、フォーカス、最小化、最大化、閉じる
• 📁 ファイル操作：読み取り、書き込み、編集、コピー、移動、削除（セーフゾーン付き）
• 🔍 ファイル検索：Everythingを統合した高速検索
• ⌨️ キーボードとマウス：テキスト入力とホットキー自動化
• 🧠 スマート検出：アクティブウィンドウのファイルパスを自動検出
• 📊 Excel自動化：xlwingsを介して開いているExcelブックを制御
• 📝 Office自動化：pywin32を介してWordとPowerPointを制御
• 🌐 SSHリモート：リモートLinuxサーバーでコマンドを実行
• 📊 システム制御：音量、電源、通知、ハードウェア状態
• 📋 クリップボード：クリップボードの内容を読み書き
• 🐧 Bashシェル：Git Bashコマンドを実行（ブラックリスト保護付き）

📦 インストール

1行でのインストール (Windows)

# ダブルクリックで実行 - すべてを自動的にチェックしてインストールします
start.bat

または手動で:

# インストール
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

# 起動
python main.py

💻 使用例

基本的な使用法

# ドキュメント内のファイルを一覧表示
MyPC-list_directory(path="%USERPROFILE%\\Documents")

# ファイルを読み取る
MyPC-read_file(path="%USERPROFILE%\\Documents\\notes.txt")

# ファイルを編集する
MyPC-edit_file(
    path="%USERPROFILE%\\Documents\\notes.txt",
    search_text="old text",
    replace_text="new text"
)

高度な使用法

# 現在のブラウザのURLを取得
MyPC-get_browser_url()

# AI分析付きでスクリーンショットを撮る
MyPC-take_screenshot(display_index=1, ai_analysis=True)

# URLをクリップボードにコピー
MyPC-set_clipboard(text="https://example.com")

📚 ドキュメント

基本設定 (config.json)

{
    "server": {
        "enabled": true,
        "name": "MyPC-MCP",
        "port": 9999,
        "host": "0.0.0.0",
        "domain": "localhost"
    },
    "safe_zones": [
        "%USERPROFILE%\\Documents",
        "%USERPROFILE%\\Downloads",
        "%USERPROFILE%\\Desktop",
        "D:\\"
    ]
}

ネットワークアクセスモード

ローカルのみ (デフォルト):

{
    "server": {
        "host": "127.0.0.1",
        "domain": "localhost"
    }
}

LANアクセス:

{
    "server": {
        "host": "0.0.0.0",
        "domain": "192.168.1.100"
    }
}

管理者として setup-firewall.bat を実行して、ポート9999を許可します。

🔧 技術詳細

環境変数

設定は環境変数の展開をサポートしています:

• %USERPROFILE% - ユーザープロファイルディレクトリ
• %APPDATA% - アプリケーションデータ
• %TEMP% - 一時フォルダ
• ~ - ホームディレクトリ

Everything検索

高速なファイル検索を有効にするには、Everything をインストールし、config.json でパスを設定します:

{
    "paths": {
        "everything": [
            "C:\\Program Files\\Everything\\es.exe",
            "D:\\APP\\Everything\\es.exe"
        ]
    }
}

Git Bash

config.json でGit Bashのパスを設定します:

{
    "paths": {
        "git_bash": [
            "C:\\Program Files\\Git\\bin\\bash.exe"
        ]
    }
}

AI分析 (VLM)

スクリーンショット分析用のビジョン言語モデルを設定します:

{
    "vlm": {
        "enabled": true,
        "base_url": "https://open.bigmodel.cn/api/paas/v4",
        "api_key": "your_api_key_here",
        "model": "glm-4.6v",
        "prompt": "Please identify all text in this image."
    }
}

📄 ライセンス

MIT License