Token导航 LogoToken导航TokenDH.com
AI Lab Testing logo
运维云端未说明官方级别未说明来源级核验

AI Lab Testing

MCP Server

MCP服务器提供远程嵌入式硬件测试能力,使工程师能够轻松发现、连接和测试实验室设备,支持SSH访问、命令执行、应用部署等功能。

工具数

0

提示词数

0

GitHub Stars

1

资源数

0
PythonClaude云端部署ClaudeCursor

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

DynamicDevices

提供方

DynamicDevices

最后核验

2026/5/17 20:22

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

实验室测试MCP服务器

![Tests](https://github.com/DynamicDevices/ai-lab-testing/actions/workflows/tests.yml) ![Python 3.10+](https://www.python.org/downloads/) ![License: GPL v3](https://www.gnu.org/licenses/gpl-3.0) ![Code style: black](https://github.com/psf/black)

MCP服务器向AI助手展示远程嵌入式硬件测试功能。

版本: 0.4.1

任务

使工程师能够轻松访问远程嵌入式硬件开发。

该项目旨在使远程硬件测试和开发尽可能无缝。远程工作的工程师应该能够:

  • 发现并连接 轻松使用实验室设备
  • 设置安全访问 (SSH密钥,无密码sudo),摩擦最小
  • 运行命令和测试 在无需复杂设置的远程板上
  • 构建和部署 远程设备的应用程序
  • 安全清理 完成时

MCP服务器提供智能工具,指导工程师完成最佳实践,建议下一步行动,并自动处理常见工作流程。当问题出现时,这些工具会提供可操作的建议和明确的下一步行动。

关键设计原则:

  • 易用性:工具应该直观,需要最少的配置
  • 有用的指导:错误消息包括建议和后续步骤
  • 最佳实践:工具引导用户实现安全、可维护的工作流程
  • 远程优先:针对通过VPN远程工作的工程师进行了优化
⚠️ 阿尔法质量警告:此程序包当前位于 阿尔法 发展状况。它是 未准备好用于专业或生产用途.API可能会更改,功能可能不完整,并且可能存在错误。使用风险自负。看 发布.md 了解更多详情。

安装

要求:

  • Python 3.10+ (MCP SDK需要Python 3.10+)
  • WireGuard工具 (有关VPN功能)-请参阅 VPN设置指南
  • fioctl命令行界面工具 (可选,了解Foundries VPN功能)-请参阅 Foundries VPN设置

来自PyPI(推荐)

# Install from PyPI
python3.10 -m pip install ai-lab-testing

# Or with development dependencies
python3.10 -m pip install "ai-lab-testing[dev]"

来源

# Clone the repository
git clone https://github.com/DynamicDevices/ai-lab-testing.git
cd ai-lab-testing

# Install in development mode
python3.10 -m pip install -e ".[dev]"

# Verify installation
python3.10 lab_testing/test_server.py

配置

MCP服务器配置

添加到光标MCP配置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "ai-lab-testing": {
      "command": "python3.10",
      "args": ["/path/to/ai-lab-testing/lab_testing/server.py"],
      "env": {
        "LAB_TESTING_ROOT": "/path/to/ai-lab-testing",
        "VPN_CONFIG_PATH": "/path/to/wg0.conf"
      }
    }
  }
}

重要提示: 使用 python3.10 (或 python3.11+)因为MCP SDK需要Python 3.10+。

目标网络配置

配置实验室测试操作的目标网络:

选项1:环境变量 (in ~/.cursor/mcp.json):

{
  "mcpServers": {
    "ai-lab-testing": {
      "command": "python3.10",
      "args": ["/path/to/ai-lab-testing/lab_testing/server.py"],
      "env": {
        "LAB_TESTING_ROOT": "/path/to/ai-lab-testing",
        "TARGET_NETWORK": "192.168.2.0/24"
      }
    }
  }
}

选项2:配置文件 (in lab_devices.json):

{
  "lab_infrastructure": {
    "network_access": {
      "target_network": "192.168.2.0/24",
      "lab_networks": ["192.168.2.0/24"]
    }
  }
}

默认: 192.168.2.0/24 如果未配置。

工具超时

一些工具,如 create_network_map 全网络扫描可能需要30秒以上。如果工具调用超时:

  • 使用 quick_mode: true 跳过网络扫描(在5秒内完成)
  • 网络扫描已优化,具有更快的超时和更高的并行性

VPN设置

服务器自动检测WireGuard VPN配置。如果你没有:

  • docs/VPN_SETUP.md 安装指南
  • 使用MCP工具: vpn_setup_instructions, create_vpn_config_template

docs/SETUP.md 了解详细的设置说明或 mcp.json.example 对于模板。

建筑

graph TB
    subgraph "AI Assistant"
        AI[Claude/Cursor]
    end
    subgraph "MCP Server"
        MCP[server.py]
        TOOLS[Tools]
        RES[Resources]
    end
    subgraph "Lab Framework"
        CFG[Config]
        DEV[Device Manager]
        VPN[VPN Manager]
        PWR[Power Monitor]
    end
    subgraph "Hardware"
        BOARD[iMX Boards]
        DMM[DMM]
        TASMOTA[Tasmota]
    end
    AI -->|MCP| MCP
    MCP --> TOOLS
    TOOLS --> DEV
    TOOLS --> VPN
    TOOLS --> PWR
    DEV --> BOARD
    PWR --> DMM

数据流:AI→ MCP服务器→ 工具→ 实验室框架→ 硬件

工具

  • 设备: list_devices (带过滤、排序、限制、汇总统计数据、电源状态)-使用电源开关列显示设备清单:Tasmota设备显示自己的电源状态(🟢 ON/🔴 OFF),其他设备显示哪个电源开关控制它们。支持按类型、状态、SSH状态、电源状态和搜索进行过滤。支持按IP、friendly_name、status或last_seen排序。支持限制结果。使用force_refresh绕过缓存。 test_device, ssh_to_device, verify_device_identity, verify_device_by_ip, update_device_ip, update_device_friendly_name
  • 虚拟专用网络: vpn_status, connect_vpn, disconnect_vpn
  • 力量: start_power_monitoring (DMM或Tasmota), get_power_logs, analyze_power_logs, monitor_low_power, compare_power_profiles -通过DMM(SCPI)或Tasmota能量监测进行功率监测
  • 塔莫塔: tasmota_control, list_tasmota_devices, power_cycle_device -通过Tasmota开关关闭设备电源。Tasmota设备显示电源状态(🟢 ON/🔴 电源开关列中的OFF)和设备列表类型列中的功耗(瓦特)
  • 测试设备: list_test_equipment, query_test_equipment -通过SCPI协议自动检测和查询测试设备(DMM、示波器)
  • OTA/集装箱: check_ota_status, trigger_ota_update, list_containers, deploy_container, get_system_status, get_firmware_version, get_foundries_registration_status, get_secure_boot_status, get_device_identity
  • 进程管理: kill_stale_processes -杀死可能会干扰的重复进程
  • 远程访问: create_ssh_tunnel, list_ssh_tunnels, close_ssh_tunnel, access_serial_port, list_serial_devices -SSH隧道和串行端口访问
  • 更改跟踪: get_change_history, revert_changes -跟踪和还原安全/调试更改
  • 批处理/回归: batch_operation, regression_test, get_device_groups
  • 网络映射: create_network_map -网络可视化地图,包括设备类型、正常运行时间、友好名称、电源开关
  • 设备验证: verify_device_identity, verify_device_by_ip, update_device_ip -在DHCP环境中验证设备身份。设备列表显示SSH状态、上次看到的时间戳和电源开关信息(Tasmota设备显示自己的状态,其他设备显示控制开关)
  • 帮助: help -获取使用文档和示例

资源

  • device://inventory -设备清单
  • network://status -网络/VPN状态
  • config://lab_devices -原始配置
  • help://usage -帮助文档和使用示例
  • health://status -服务器运行状况、指标和SSH池状态

发展

# Use Python 3.10+ for development
python3.10 -m pip install -e ".[dev]"
pre-commit install
black . && ruff check . --fix

添加工具:在中创建函数 lab_testing/tools/,注册 lab_testing/server/tool_definitions.pylab_testing/server/tool_handlers.py.

版本控制:语义版本控制(主、次、补丁)。更新 version.py,请参阅 更改日志.md.

文档

许可证

GPL-3.0或更高版本-版权所有(C)2025 Dynamic Devices Ltd

许可证 获取完整的许可证文本。

维护者

亚历克斯·J·列侬

目录标签

目录标签

PythonClaude云端部署嵌入式开发本地部署远程测试硬件测试自动化工具VPN集成

支持客户端

ClaudeCursor

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

none

工具数量(toolCount,工具数)

0

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP