What is Mcp Device Server

The mcp-device-server is a Model Context Protocol (MCP) server designed for seamless integration with peripheral devices connected to a computer. It allows users to control, monitor, and manage hardware devices through a unified API.

Use cases

Use cases include developing applications that require camera input for video conferencing, managing print jobs in an office setting, creating audio recording applications, and building tools for screen sharing and capturing.

How to use

To use mcp-device-server, clone the repository from GitHub, install the necessary Python dependencies, and run the server using the command ‘uv run src/main.py’. Alternatively, it can be integrated with Claude Desktop by adding specific configuration settings.

Key features

Key features include camera control for capturing images and recording videos, print management for sending documents to printers, audio capabilities for recording from microphones and playing audio, and screen capture for taking screenshots and recording screen activity.

Where to use

mcp-device-server can be used in various fields such as software development, multimedia applications, educational tools, and any environment requiring interaction with peripheral devices.

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

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

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.

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

Documentation

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

License

MIT License