逻辑分析仪 MCP
此项目为Saleae逻辑分析仪提供了一个MCP（消息控制协议）服务器和自动化接口。它实现了对Saleae Logic设备和捕获功能的远程控制、自动化操作以及集成，使得通过编程来脚本编写、管理和分析逻辑分析仪数据变得轻而易举。
特点/特性
- 设备配置管理
- 捕获配置和执行
- 以多种格式导出数据
- 逻辑文件分析与处理
- 协议解码与可视化
- 图表生成与分析
- MCP（消息控制协议）服务器集成
- 支持Logic 16及其他Logic 2设备
- 使用Python-Saleae进行捕获文件的解析与分析
要求
- Python 3.10或更高版本
- 已安装Saleae Logic 2软件
- Python-Saleae 模块
- Logic 2 设备（Logic 16、Logic Pro 8 等）
安装
- 克隆仓库
- 使用 uv 创建并激活虚拟环境：
# Create virtual environment
uv venv
# Activate virtual environment
# On Windows:
.venv\Scripts\activate
# On Unix/MacOS:
source .venv/bin/activate- 使用 uv 安装依赖项：
# Install all dependencies
uv pip install -e .如果你在依赖项上遇到任何问题，可以尝试直接安装它们：
# Install logic2-automation from GitHub
uv pip install git+https://github.com/saleae/logic2-automation/#subdirectory=python
# Install other dependencies
uv pip install grpcio protobuf grpcio-tools saleae mcp[cli] pytest注：由于依赖需求，此项目需要 Python 3.10 或更高版本。
使用方法
运行MCP服务器
启动用于远程控制的MCP服务器：
# Using uv (recommended)
uv --directory
run -m logic_analyzer_mcp注：使用时 uv确保你已经安装了它，并且它在你的环境变量PATH中 --directory 参数应指向项目的根目录。
当前兼容性与测试版本
这个项目已经过测试，使用的是 [Saleae Logic 1.2.40 Windows版]().
- 请使用此版本以确保最佳兼容性。
- 其他版本可能也能正常工作，但本项目不对其提供保证或官方支持。
实验笔记（α）
这是一个实验性（alpha）版本。以下MCP工具序列已经过测试，对我有效：
- Saleae_connect（适用于Saleae Logic 1.2.40）
- Saleae配置
- saleae_capture — 将捕获数据保存为.logicdata格式
- 解析捕获文件（可选）
- 获取MCP数字数据
- saleae_export（可选。如需使用，请使用csv格式）
注：
- 在使用这些工具之前，请确保Saleae Logic应用程序正在运行，并且脚本套接字服务器已启用。
- 在调用 saleae_capture 时，请请求 .logicdata 格式，以确保与控制器方法的最佳兼容性。
故障排除与重要注意事项
- 逻辑软件必须正在运行：
- 在使用此自动化接口之前，请确保您的系统上已运行Saleae Logic软件。自动化脚本将尝试连接到正在运行的实例。 - 如果软件未运行，脚本可能无法连接，或者可能会以模拟模式启动一个新的实例（该实例将无法检测到您的真实设备）。
- 启用脚本套接字服务器：
- 在Logic软件中，前往 Options > Preferences （或 Edit > Preferences)，并确保勾选了“启用脚本套接字服务器”选项。 - 默认端口通常是10429。如果您更改了此端口，请相应地更新您的脚本。 - 如果脚本服务器未启用，Python API 将无法与 Logic 通信，您将看到连接错误。
- 设备未检测到：
- 在运行任何脚本之前，请确保您的Logic设备已连接到计算机，并且已被Logic软件识别。 - 如果设备未被检测到，请检查您的USB连接，并尝试重新启动Logic软件。
- 架构兼容性：
- 确保Logic软件和您的Python环境均为32位或均为64位。架构不匹配可能导致连接失败。
- 权限：
- 在某些系统上，您可能需要以管理员权限运行Logic软件和/或您的Python脚本，以允许套接字通信。
- 支持的版本：
- 这个项目是为Saleae Logic 1.x/2.x自动化设计的。某些功能可能仅在安装了相应的自动化API的情况下，才可在Logic 2.x中使用。
关于捕获文件格式的说明
- 逻辑数据格式 是推荐且支持度最高的捕获文件格式。所有自动化和解析功能均设计为与之可靠配合使用
.logicdata文件。 - .sal 文件 （一些较旧或替代性的Saleae软件所使用的）目前已知存在bug和兼容性问题。自动转换或处理
.sal文件可能会失败或需要手动修复。为了获得最佳效果，请始终使用.logicdata捕获数据的格式。
API 参考文档
Saleae控制器
提供对Logic 2功能高级访问的主要控制器类。
设备配置方法：
create_device_config(name: str, digital_channels: List[int], digital_sample_rate: int, analog_channels: Optional[List[int]] = None, analog_sample_rate: Optional[int] = None, digital_threshold_volts: Optional[float] = None) -> str
- 创建一个具有指定通道和采样率的新设备配置 - 返回配置名称
get_device_config(name: str) -> Optional[LogicDeviceConfiguration]
- 通过名称检索设备配置 - 如果未找到，则返回 None
list_device_configs() -> List[str]
- 列出所有可用的设备配置名称
remove_device_config(name: str) -> bool
- 移除设备配置 - 如果成功则返回 True，未找到则返回 False
捕获配置方法：
create_capture_config(name: str, duration_seconds: float, buffer_size_megabytes: Optional[int] = None) -> str
- 创建一个新的捕获配置，指定持续时间 - 返回配置名称
get_capture_config(name: str) -> Optional[CaptureConfiguration]
- 通过名称检索捕获配置 - 如果未找到，则返回 None
list_capture_configs() -> List[str]
- 列出所有可用的捕获配置名称
remove_capture_config(name: str) -> bool
- 移除捕获配置 - 如果成功则返回 True，未找到则返回 False
配置：
Claude配置（包含uv运行）：
{
"mcpServers": {
"logic-analyzer-ai-mcp": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"
",
"run",
"-m",
"logic_analyzer_mcp"
]
}
}
}Claude配置（直接使用）：
{
"mcpServers": {
"logic-analyzer-ai-mcp": {
"type": "stdio",
"command": "python",
"args": [
"
\\src\\logic_analyzer_mcp.py"
]
}
}
}克劳德配置（带uv运行）：
{
"mcpServers": {
"logic-analyzer-ai-mcp": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"
",
"run",
"-m",
"logic_analyzer_mcp"
]
}
}
}Logic2 参数说明
此项目包含一个用于Logic2自动化的可选实验路径。默认情况下，该功能处于禁用状态。您可以通过以下三种方式之一将其启用：
- CLI 标志（推荐用于一次性运行）
- 示例： - 使用 Python 运行 logic_analyzer_mcp 模块，并传入 --logic2 参数
- 环境变量（便于CI/持久化Shell使用）
- 示例（Unix）： - LOGIC2=1 python -m logic_analyzer_mcp 翻译为中文是：“LOGIC2设置为1，运行python模块logic_analyzer_mcp” - 示例（Windows PowerShell）： - 将环境变量 LOGIC2 设置为 '1'；然后运行 logic_analyzer_mcp 模块
- 程序化API（当嵌入库时）
- 在注册工具之前调用辅助函数： - 从 mcp_tools 模块导入 set_logic2_enabled 和 setup_mcp_tools 函数 - 设置逻辑2启用状态为真（True） - 设置MCP工具（mcp, 控制器） - 或者将显式参数传递给 setup_mcp_tools： - \setup_mcp_tools(mcp, controller, enable_logic2=True)\ 翻译成中文是：“设置MCP工具（mcp，控制器，启用逻辑2为真）”
注释
- 默认行为：Logic2 实验性功能处于关闭状态。当禁用时，代码将优先使用基于控制器的或离线回退方案。
- 安全性：实验性功能可能会发生变化——请在生产环境中使用前，有意启用并在您的环境中进行测试。
- 故障排除：如果启用 Logic2 失败，请检查是否已安装 logic2-automation 和 python-saleae 包，并确保 Saleae 应用程序正在运行且可访问。
克劳德配置（示例）
以下是一个最小化的Claude MCP服务器配置示例，您可以根据需要进行调整。请将此配置放置在您的Claude配置文件或工具设置中。
{
"mcpServers": {
"logic-analyzer-ai-mcp": {
"type": "stdio",
"command": "uv",
"args": [
"--directory",
"
",
"run",
"-m",
"logic_analyzer_mcp",
"--logic2"
]
}
}
}注释：
- 移除
--logic2如果你不希望启用实验性的 Logic2 工具，请进行标记。 - 调整 `
和其他 uv` 根据您的环境进行参数匹配。
- 使用
python如果您更倾向于直接调用模块而不是通过（某种方式或接口），则基于配置uv。