项目简介

Altium MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在通过 Python 脚本桥接 Altium Designer 与大型语言模型 (LLM)，例如 Claude。它允许用户使用自然语言与 Altium PCB 设计进行交互，实现数据查询、设计操作等功能。

主要功能

PCB 设计数据访问: 获取 Altium 设计中的组件信息、属性、坐标、引脚数据、设计规则等。
PCB 设计操作: 支持组件移动、布局复制等操作（部分功能仍在开发中）。
截图功能: 获取 Altium PCB 编辑器窗口的截图。
工具注册: 通过 MCP 协议向 LLM 客户端暴露一系列工具，允许 LLM 调用这些工具来执行 Altium 相关的功能。

安装步骤

环境准备: 确保已安装 Python 和 'uv' 包管理器。Windows 用户可以使用 PowerShell 运行安装命令。

# 安装 uv (根据操作系统选择命令)
brew install uv  # macOS
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" # Windows
set Path=C:\Users\nntra\.local\bin;%Path% # Windows, 安装后需设置环境变量

目录设置: 创建 'C:\AltiumMCP' 目录，并将仓库中的 'server.py' 文件、'AltiumScript' 文件夹以及 'config.json' 文件放置在该目录下。请注意，目前脚本中路径硬编码为 'C:\AltiumMCP'。
Altium 脚本: 确保 'Altium_API.PrjScr' 脚本文件位于 'C:\AltiumMCP\AltiumScript' 目录下。
安装依赖: 在 'C:\AltiumMCP' 目录下，使用 'uv' 安装 Python 依赖（如果项目有 'requirements.txt' 或 'pyproject.toml'）。根据仓库内容，似乎不需要额外的依赖，但如果运行 'server.py' 报错缺少模块，请使用 'uv pip install <缺失模块名>' 安装。

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。对于 Claude 桌面应用，您需要编辑 'claude_desktop_config.json' 文件，添加以下配置信息。

{
    "mcpServers": {
        "altium": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\AltiumMCP",
                "run",
                "server.py"
            ]
        }
    }
}

'server name': 'altium' (服务器名称，在客户端配置中引用)
'command': 'uv' (启动服务器的命令，这里使用 'uv' 运行 Python 脚本)
'args': 启动参数，包括：
- '--directory': 'C:\AltiumMCP' (指定服务器工作目录为 'C:\AltiumMCP'，脚本和配置文件应位于此目录下)
- 'run': 运行命令
- 'server.py': 'server.py' (服务器启动脚本)

基本使用方法

启动服务器: 在命令行或终端中，导航到 'C:\AltiumMCP' 目录，并运行 'uv run server.py' 启动 Altium MCP Server。
连接 Claude: 配置好 'claude_desktop_config.json' 后，重启 Claude 桌面应用。
使用工具: 在 Claude 侧边栏中，如果配置正确且服务器运行正常，您应该能看到一个锤子图标，点击后可以访问 Altium MCP 提供的工具。通过自然语言指令，即可调用这些工具与 Altium Designer 交互。例如，您可以尝试询问 "Get me all parts on my design made by Molex" 或 "Give me the description and part number of U4"。

关键词

项目简介

主要功能

安装步骤

服务器配置

基本使用方法

信息