Devices MCP Server

Um servidor MCP para controlar e monitorar dispositivos periféricos conectados ao seu computador, como câmeras e microfones.

GitHub

Documentação

Devices MCP Server

Um servidor Model Context Protocol (MCP) para integração perfeita com dispositivos periféricos conectados ao seu computador. Controle, monitore e gerencie dispositivos de hardware por meio de uma API unificada.

Ferramentas Suportadas

Controle de Câmera: Capture imagens e grave vídeos de câmeras conectadas
Gerenciamento de Impressão: Envie documentos para impressoras e gerencie trabalhos de impressão
Recursos de Áudio: Grave a partir de microfones e reproduza áudio pelos alto-falantes
Captura de Tela: Tire capturas de tela e grave a atividade da tela de monitores conectados

Pré-requisitos e Instalação

Dependências do Sistema

As seguintes dependências do sistema são necessárias para funcionalidade completa:

FFMPEG: Necessário para funcionalidade de gravação de tela e câmera
PortAudio: Necessário para funcionalidade de gravação de áudio

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

Instalação do Projeto

Clone o repositório:

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

Instale as dependências Python:

uv sync

Uso

Opção A: Execute diretamente:

uv run src/main.py

Opção B: Use com o Claude Desktop:

Adicione a seguinte configuração ao seu claude_desktop_config.json:

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

Em seguida, reinicie o Claude Desktop para carregar o servidor.

Configuração

Configure o servidor usando variáveis de ambiente. Você pode defini-las ou criar um arquivo .env na raiz do projeto.

Opções de configuração disponíveis:

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

Ferramentas MCP Disponíveis

Câmera

Ferramenta	Descrição
`list_cameras`	Listar todas as câmeras conectadas
`get_camera_info`	Obter informações detalhadas da câmera
`capture_image`	Tirar uma foto de uma câmera
`start_video_recording`	Iniciar gravação de vídeo
`stop_video_recording`	Parar gravação de vídeo

Impressora

Ferramenta	Descrição
`list_printers`	Listar impressoras disponíveis
`print_file`	Enviar um arquivo para uma impressora
`print_as_pdf`	Imprimir arquivo como PDF
`get_print_job`	Obter informações do trabalho de impressão
`cancel_print_job`	Cancelar um trabalho de impressão

Áudio

Ferramenta	Descrição
`list_audio_devices`	Listar todos os dispositivos de entrada/saída de áudio
`record_audio`	Gravar a partir de um dispositivo de entrada
`stop_record_audio`	Parar gravação de um dispositivo de entrada
`play_audio`	Reproduzir áudio por um dispositivo

Tela

Ferramenta	Descrição
`list_displays`	Listar monitores conectados
`capture_screenshot`	Tirar uma captura de tela
`record_screen`	Iniciar gravação de tela
`stop_record_screen`	Parar gravação de tela

Documentação

Para informações detalhadas sobre todas as ferramentas disponíveis e seu uso, consulte a Referência da Wiki de Ferramentas.

Licença

Licença MIT