MCP Device Server

🚀 设备MCP服务器

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

🚀 快速开始

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

1. 安装系统依赖项和项目。
2. 配置服务器（可选）。
3. 选择运行方式（直接运行或与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

项目安装

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工具

相机

打印机

音频

屏幕

更多详细信息

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

📄 许可证

本项目采用 MIT许可证。