金大哥 - mcp-device-server MCP 详情

article

README

🚀 设备MCP服务器

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

🚀 快速开始

设备MCP服务器允许你通过统一的API控制、监控和管理硬件设备。以下是使用该服务器的基本步骤：

安装系统依赖项和项目。
配置服务器（可选）。
选择运行方式（直接运行或与Claude Desktop一起使用）。

✨ 主要特性

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

📦 安装指南

系统依赖

要实现完整功能，需要安装以下系统依赖：

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

项目安装

克隆仓库：

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

安装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 | 停止屏幕录制 |

📄 许可证

本项目采用 MIT许可证。

mcp-device-server