Devices MCP Server

Servidor MCP de Devices

Un servidor de Model Context Protocol (MCP) para la integración perfecta con dispositivos periféricos conectados a tu computadora. Controla, monitorea y administra dispositivos de hardware a través de una API unificada.

Herramientas compatibles

• Control de cámara: Captura imágenes y graba video desde cámaras conectadas
• Gestión de impresión: Envía documentos a impresoras y administra trabajos de impresión
• Capacidades de audio: Graba desde micrófonos y reproduce audio a través de altavoces
• Captura de pantalla: Toma capturas de pantalla y graba la actividad de la pantalla desde pantallas conectadas

Requisitos previos e instalación

Dependencias del sistema

Se requieren las siguientes dependencias del sistema para un funcionamiento completo:

• FFMPEG: Requerido para la funcionalidad de grabación de pantalla y cámara
• PortAudio: Requerido para la funcionalidad de grabación de audio

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

Instalación del proyecto

1. Clona el repositorio:

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

2. Instala las dependencias de Python:

uv sync

Uso

Opción A: Ejecutar directamente:

uv run src/main.py

Opción B: Usar con Claude Desktop:

Agrega la siguiente configuración a tu claude_desktop_config.json:

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

Luego reinicia Claude Desktop para cargar el servidor.

Configuración

Configura el servidor usando variables de entorno. Puedes establecerlas o crear un archivo .env en la raíz del proyecto.

Opciones de configuración disponibles:

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

Herramientas MCP disponibles

Cámara

Herramienta	Descripción
list_cameras	Lista todas las cámaras conectadas
get_camera_info	Obtiene información detallada de la cámara
capture_image	Toma una foto desde una cámara
start_video_recording	Inicia la grabación de video
stop_video_recording	Detiene la grabación de video

Impresora

Herramienta	Descripción
list_printers	Lista las impresoras disponibles
print_file	Envía un archivo a una impresora
print_as_pdf	Imprime un archivo como PDF
get_print_job	Obtiene información del trabajo de impresión
cancel_print_job	Cancela un trabajo de impresión

Audio

Herramienta	Descripción
list_audio_devices	Lista todos los dispositivos de entrada/salida de audio
record_audio	Graba desde un dispositivo de entrada
stop_record_audio	Detiene la grabación desde un dispositivo de entrada
play_audio	Reproduce audio a través de un dispositivo

Pantalla

Herramienta	Descripción
list_displays	Lista las pantallas conectadas
capture_screenshot	Toma una captura de pantalla
record_screen	Inicia la grabación de pantalla
stop_record_screen	Detiene la grabación de pantalla

Documentación

Para información detallada sobre todas las herramientas disponibles y su uso, consulta la Wiki de Referencia de Herramientas.

Licencia

Licencia MIT