mcpField
🚀
🚀 Wayland MCP Server

🚀 Wayland MCP Server

ローカル
github.com/someakaその他1757 週間前に更新

🚀 Wayland MCP Server について

Wayland MCP Serverは、Waylandデスクトップ向けにスクリーンショット、画像分析、入力制御ツールを提供し、Linuxデスクトップを操作するエージェントを対象とします。カスタムVLMによる分析、画像比較、マウス・キーボード操作と操作の連結に対応します。

主な機能

  1. 01Waylandデスクトップの撮影
  2. 02カスタムVLMによる画像分析
  3. 03画像比較
  4. 04マウスとキーボードの制御
  5. 05入力操作の連結

活用シーン

  1. 01デスクトップ画面の撮影と分析
  2. 02状態ごとの画面画像の比較
  3. 03マウスとキーボード操作の連続実行

MCP 対応

MCPクライアントにWaylandデスクトップの撮影、画像分析、マウス、キーボード操作ツールを提供します。入力制御を有効にすると、サーバーはマウスとキーボードに完全にアクセスできます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"wayland": {
"command": "uvx",
"args": [
"wayland-mcp"
],
"env": {
"OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
"VLM_MODEL": "<VLM_MODEL>",
"XDG_RUNTIME_DIR": "<XDG_RUNTIME_DIR>",
"WAYLAND_MCP_PORT": "<WAYLAND_MCP_PORT>",
"DISPLAY": "<DISPLAY>",
"WAYLAND_DISPLAY": "<WAYLAND_DISPLAY>",
"XDG_SESSION_TYPE": "<XDG_SESSION_TYPE>"
}
}
}
}
起動コマンドuvx wayland-mcp
設定が必要な環境変数
OPENROUTER_API_KEYシークレット
VLM_MODEL
XDG_RUNTIME_DIR
WAYLAND_MCP_PORT
DISPLAY
WAYLAND_DISPLAY
XDG_SESSION_TYPE

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiwayland-mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

🚀 Wayland MCP サーバー

Status: WIP License: GPL3

注記: このパッケージは、既存のスクリーンショットソリューションが自分の Wayland 環境で安定して動作しなかったため作成されました。 Wayland MCP は、最新の Linux デスクトップ向けにスクリーンショット、分析、マウスおよびキーボードの制御ツールを提供します。


✨ 機能

  • 📸 スクリーンショットと分析

    • 画像分析のためのカスタム VLM 統合
    • 画像比較機能
  • 🖱️ 入力シミュレーション

    • マウス制御(移動、クリック、ドラッグ、スクロール)
    • キーボード入力(文字入力、キー押下)
    • 複雑な操作手順を実行するためのアクション連結

⚠️ セキュリティに関する警告

警告: 入力制御を有効にすると、MCP サーバーはマウスとキーボードに完全にアクセスできるようになります。 信頼できる MCP サーバーとモデルのみを使用してください。


🚀 クイックスタート

🔧 入力制御のセットアップ
./setup.sh

GitHub で setup.sh を表示

入力デバイスを制御するための evemu-event の権限を設定します。

⚙️ MCP サーバーの設定

MCP サーバーの設定(.roo/mcp.json)に追加します。

{
  "mcpServers": {
    "wayland-screenshot": {
      "command": "uvx",
      "args": ["wayland-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key",
        "VLM_MODEL": "qwen/qwen2.5-vl-72b-instruct:free",
        "XDG_RUNTIME_DIR": "/run/user/1000",
        "WAYLAND_MCP_PORT": "4999",
        "DISPLAY": ":0",
        "WAYLAND_DISPLAY": "wayland-0",
        "XDG_SESSION_TYPE": "wayland"
      }
    }
  }
}

🛠️ 開発

git clone https://github.com/someaka/wayland-mcp
cd wayland-mcp
pip install -e .

📜 ライセンス

GPL 3

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。