设备 MCP 服务器

Model Context Protocol (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        # 服务器主机地址
MCP_PORT=8000             # 服务器端口
MCP_ENABLE_CAMERA=true    # 启用摄像头功能
MCP_ENABLE_PRINTER=true   # 启用打印机功能
MCP_ENABLE_AUDIO=true     # 启用音频功能
MCP_ENABLE_SCREEN=true    # 启用屏幕功能

可用的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许可证