Devices MCP Server

设备 MCP 服务

一个模型上下文协议（MCP）服务，可与连接到计算机的外围设备无缝集成。通过统一的 API 控制、监控和管理硬件设备。

支持的工具

• 摄像头控制：从已连接的摄像头拍摄图像和录制视频
• 打印管理：向打印机发送文档并管理打印作业
• 音频功能：通过麦克风录音，并通过扬声器播放音频
• 屏幕捕获：从已连接的显示器截取屏幕截图并录制屏幕活动

先决条件和安装

系统依赖项

要使用全部功能，需要以下系统依赖项：

• FFMPEG：录制屏幕和摄像头视频所需
• PortAudio：录制音频所需

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

项目安装

1. 克隆代码库：

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

2. 安装 Python 依赖项：

uv sync

用法

选项 A：直接运行：

uv run src/main.py

选项 B：与 Claude Desktop 搭配使用：

将以下配置添加到你的 claude_desktop_config.json 中：

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

然后重启 Claude Desktop 以加载服务。

配置

使用环境变量配置服务。你可以设置这些变量，或在项目根目录中创建 .env 文件。

可用配置选项：

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

可用的 MCP 工具

摄像头

工具	描述
list_cameras	列出所有已连接的摄像头
get_camera_info	获取摄像头的详细信息
capture_image	使用摄像头拍摄照片
start_video_recording	开始录制视频
stop_video_recording	停止录制视频

打印机

工具	描述
list_printers	列出可用的打印机
print_file	将文件发送到打印机
print_as_pdf	将文件打印为 PDF
get_print_job	获取打印作业信息
cancel_print_job	取消打印作业

音频

工具	描述
list_audio_devices	列出所有音频输入/输出设备
record_audio	使用输入设备录音
stop_record_audio	停止使用输入设备录音
play_audio	通过设备播放音频

屏幕

工具	描述
list_displays	列出已连接的显示器
capture_screenshot	截取屏幕截图
record_screen	开始录制屏幕
stop_record_screen	停止录制屏幕

文档

有关所有可用工具及其用法的详细信息，请参阅 工具参考 Wiki。

许可证

MIT 许可证