MCP Device Server

🚀 Devices MCP Server

A Model Context Protocol (MCP) server that enables seamless integration with peripheral devices connected to your computer. Control, monitor, and manage hardware devices via a unified API.

✨ Features

• 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.

📦 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

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

Project Installation

1. Clone the repository:

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

2. Install Python dependencies:

uv sync

💻 Usage Examples

Basic Usage

Option A: Run directly:

uv run src/main.py

Option B: Use with Claude Desktop: Add the following configuration to your claude_desktop_config.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.

📚 Documentation

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

Printer

Audio

Screen

For detailed information about all available tools and their usage, see the Tools Reference Wiki.

📄 License

MIT License