Device MCP Server

# Devices MCP Server A Model Context Protocol (MCP) server for seamless integration with peripheral devices connected to your computer. Control, monitor, and manage hardware devices through a unified API. ## Supported Tools - **Camera Control**: Capture images and record video from connected cameras - **Print Management**: Send documents to printers and manage print jobs - **Audio Capabilities**: Record from microphones and play audio through speakers - **Screen Capture**: Take screenshots and record screen activity from connected displays ## Prerequisites & Installation ### System Dependencies The following system dependencies are required for full functionality: - **FFMPEG**: Required for screen and camera recording functionality - **PortAudio**: Required for audio recording functionality #### macOS ```sh brew install ffmpeg portaudio ``` #### Linux (Ubuntu/Debian) ```sh sudo apt update sudo apt install ffmpeg portaudio19-dev ``` #### Linux (Fedora) ```sh sudo dnf install ffmpeg portaudio-devel ``` #### Windows ```powershell winget install ffmpeg ``` ### Project Installation 1. **Clone the repository**: ```bash git clone https://github.com/akshitsinha/mcp-device-server.git cd mcp-device-server ``` 2. **Install Python dependencies**: ```bash uv sync ``` ## Usage **Option A: Run directly**: ```bash uv run src/main.py ``` **Option B: Use with Claude Desktop**: Add the following configuration to your `claude_desktop_config.json`: ```json { "mcpServers": { "mcp-device-server": { "command": "uv", "args": [ "--directory", "/path/to/mcp-device-server", "run", "src/main.py" ] } } } ``` Then restart Claude Desktop to load the server. ## Configuration Configure the server using environment variables. You can set these or create a `.env` file in the project root. **Available configuration options**: ``` 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 ``` ## Available MCP Tools ### Camera | Tool | Description | | ----------------------- | ------------------------------- | | `list_cameras` | List all connected cameras | | `get_camera_info` | Get detailed camera information | | `capture_image` | Take a picture from a camera | | `start_video_recording` | Begin video recording | | `stop_video_recording` | Stop video recording | ### Printer | Tool | Description | | ------------------ | ------------------------- | | `list_printers` | List available printers | | `print_file` | Send a file to a printer | | `print_as_pdf` | Print file as PDF | | `get_print_job` | Get print job information | | `cancel_print_job` | Cancel a print job | ### Audio | Tool | Description | | -------------------- | ----------------------------------- | | `list_audio_devices` | List all audio input/output devices | | `record_audio` | Record from an input device | | `stop_record_audio` | Stop recording from an input device | | `play_audio` | Play audio through a device | ### Screen | Tool | Description | | -------------------- | ----------------------- | | `list_displays` | List connected displays | | `capture_screenshot` | Take a screenshot | | `record_screen` | Start screen recording | | `stop_record_screen` | Stop screen recording | ## Documentation For detailed information about all available tools and their usage, see the [Tools Reference Wiki](https://github.com/akshitsinha/mcp-device-server/wiki/Tools-Reference-Wiki). ## License [MIT License](LICENSE.md)