Altium MCP Server

基本能力

产品定位

Altium MCP Server 是一个用于与 Altium Designer 交互的 MCP 服务器，通过 Python 接口实现对 PCB 设计的程序化查询和操作。

核心功能

1. 组件信息查询：获取设计中的所有组件标识符、属性名称和值、详细数据以及引脚信息。
2. 原理图/符号操作：获取原理图数据、读取符号放置规则、创建原理图符号。
3. 布局操作：获取 PCB 规则、获取选中组件坐标、移动组件、获取 PCB 截图、布局复制等。
4. 服务器状态：检查 MCP 服务器状态，包括 Altium 和脚本文件的路径。

适用场景

1. 自动化设计：通过程序化方式查询和操作 PCB 设计，提高设计效率。
2. 组件管理：快速获取和管理设计中的组件信息。
3. 布局复制：通过 LLM 智能匹配源和目标组件，实现布局复制。
4. 规则检查：获取和检查 PCB 设计中的规则。

工具列表

1. Component Information：
2. get_all_designators：获取所有组件标识符。
3. get_all_component_property_names：获取所有组件属性名称。
4. get_component_property_values：获取特定属性的所有组件值。
5. get_component_data：获取指定组件的详细数据。
6. get_component_pins：获取指定组件的引脚信息。
7. Schematic/Symbol：
8. get_schematic_data：获取指定组件的原理图数据。
9. get_symbol_placement_rules：读取符号放置规则。
10. create_schematic_symbol：创建原理图符号。
11. Layout Operations：
12. get_pcb_rules：获取所有 PCB 规则描述。
13. get_selected_components_coordinates：获取选中组件的坐标和旋转信息。
14. move_components：移动指定组件。
15. get_pcb_screenshot：获取 PCB 窗口截图。
16. layout_duplicator：启动布局复制。
17. layout_duplicator_apply：应用布局复制。
18. Server Status：
19. get_server_status：检查服务器状态。

常见问题解答

1. 安装路径：目前仅在 Windows 上测试，且脚本路径硬编码为 C:\AltiumMCP。
2. 布局复制失败：Claude 目前无法正确放置组件到 PCB 上。
3. Altium 安装：服务器会自动搜索 Altium Designer 安装路径，若未找到会提示手动选择。

使用教程

使用依赖

1. 安装 uv： bash powershell -c "irm https://astral.sh/uv/install.ps1 | iex" 然后设置路径： bash set Path=C:\Users\nntra\.local\bin;%Path%

安装教程

1. 克隆仓库到 C:\，确保目录为 C:\AltiumMCP。
2. 在 C:\AltiumMCP 目录下运行 uv sync 以安装依赖。
3. Claude 桌面集成：
4. 启用开发者模式：Claude > Help > Enable Developer Mode。
5. 编辑 claude_desktop_config.json 文件，添加以下内容： json { "mcpServers": { "altium": { "command": "uv", "args": [ "--directory", "C:\\AltiumMCP", "run", "server.py" ] } } }
6. 重启 Claude 桌面应用。

调试方式

1. 启动服务器后，检查侧边栏中的锤子图标，确认 Altium MCP 工具已加载。
2. 使用 get_server_status 工具检查服务器状态。
3. 若 Altium 未自动识别，手动选择 Altium 可执行文件（X2.EXE）。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。