Devices MCP Server

Devices MCP サーバー

コンピューターに接続された周辺機器とシームレスに連携するための、Model Context Protocol（MCP）サーバーです。統一された API を通じて、ハードウェアデバイスを制御、監視、管理できます。

対応ツール

• カメラ制御：接続されたカメラで画像を撮影し、動画を録画します
• 印刷管理：プリンターにドキュメントを送信し、印刷ジョブを管理します
• オーディオ機能：マイクから録音し、スピーカーから音声を再生します
• 画面キャプチャ：接続されたディスプレイのスクリーンショットを撮影し、画面の動作を録画します

前提条件とインストール

システム依存関係

すべての機能を利用するには、次のシステム依存関係が必要です。

• FFMPEG：画面およびカメラの録画機能に必要です
• PortAudio：音声録音機能に必要です

macOS

brew install ffmpeg portaudio

Linux（Ubuntu/Debian）

sudo apt update
sudo apt install ffmpeg portaudio19-dev

Linux（Fedora）

sudo dnf install ffmpeg portaudio-devel

Windows

winget install ffmpeg

プロジェクトのインストール

1. リポジトリをクローンします：

git clone https://github.com/akshitsinha/mcp-device-server.git
cd mcp-device-server

2. Python の依存関係をインストールします：

uv sync

使用方法

オプション A：直接実行する：

uv run src/main.py

オプション B：Claude Desktop で使用する：

次の設定を claude_desktop_config.json に追加します。

{
  "mcpServers": {
   "mcp-device-server": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/mcp-device-server",
      "run",
      "src/main.py"
    ]
   }
  }
}

その後、Claude Desktop を再起動してサーバーを読み込みます。

設定

環境変数を使ってサーバーを設定します。環境変数を設定するか、プロジェクトのルートに .env ファイルを作成できます。

利用可能な設定オプション：

MCP_HOST=127.0.0.1        # Server host address
MCP_PORT=8000             # Server port
MCP_ENABLE_CAMERA=true    # Enable camera functionality
MCP_ENABLE_PRINTER=true   # Enable printer functionality
MCP_ENABLE_AUDIO=true     # Enable audio functionality
MCP_ENABLE_SCREEN=true    # Enable screen functionality

利用可能な MCP ツール

カメラ

ツール	説明
list_cameras	接続されているすべてのカメラを一覧表示します
get_camera_info	カメラの詳細情報を取得します
capture_image	カメラで写真を撮影します
start_video_recording	動画の録画を開始します
stop_video_recording	動画の録画を停止します

プリンター

ツール	説明
list_printers	利用可能なプリンターを一覧表示します
print_file	ファイルをプリンターに送信します
print_as_pdf	ファイルを PDF として印刷します
get_print_job	印刷ジョブの情報を取得します
cancel_print_job	印刷ジョブをキャンセルします

オーディオ

ツール	説明
list_audio_devices	すべてのオーディオ入力／出力デバイスを一覧表示します
record_audio	入力デバイスから録音します
stop_record_audio	入力デバイスからの録音を停止します
play_audio	デバイスから音声を再生します

画面

ツール	説明
list_displays	接続されているディスプレイを一覧表示します
capture_screenshot	スクリーンショットを撮影します
record_screen	画面録画を開始します
stop_record_screen	画面録画を停止します

ドキュメント

利用可能なすべてのツールとその使用方法について詳しくは、ツールリファレンス Wiki をご覧ください。

ライセンス

MIT ライセンス