Skip to main content
Glama
M-R-Abedini

Altium MCP Suite

by M-R-Abedini
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Altium MCP Suite

مجموعهٔ سورس سه MCP برای Altium Designer، به‌همراه هماهنگ‌کنندهٔ اجرای اسکریپت‌ها، بازیابی اتصال و آزمون‌های اصلاحات. این مخزن snapshot قابل‌ساخت از پروژه‌های اصلی است؛ نویسندگان و مجوزهای اصلی در هر زیرپوشه حفظ شده‌اند.

بخش

کاربرد

مجوز اصلی

eda-agent

کنترل شماتیک، PCB و کتابخانه در Altium؛ ورودی هماهنگ‌شده: eda_stdio.py

Apache-2.0

coffeenmusic

ابزارهای پل قدیمی Altium؛ ورودی: coffeenmusic/server/codex_stdio.py

MIT

altium-designer-mcp

خواندن و نوشتن فایل‌های کتابخانهٔ Altium با سرور Rust

GPL-3.0-or-later

منبع و commit هر snapshot در UPSTREAM.json ثبت شده‌اند. کدهای هماهنگ‌کنندهٔ جدید تحت MIT هستند؛ این مجوز جایگزین مجوز زیرپروژه‌ها نیست. یادداشت تغییرات و گزارش بررسی محدوده و نتیجهٔ کنترل‌ها را توضیح می‌دهند.

نصب در Windows

Python 3.12، Git و Altium Designer لازم‌اند. کنترل زنده روی AD26 آزمایش شده است. دستورها را از ریشهٔ همین مخزن اجرا کنید:

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe setup.py --altium-exe "C:\Program Files\Altium\AD26\X2.EXE" --library-dir "D:\MyProject\Libraries"

مسیرها را برای رایانهٔ خود تنظیم کنید. --library-dir اختیاری است و می‌تواند چند بار تکرار شود. خروجی‌های mcp.local.json و codex.local.toml تنظیمات آمادهٔ کلاینت هستند؛ بخش‌های آن‌ها را در تنظیمات کلاینت خود ادغام و سرورهای MCP را یک بار دوباره راه‌اندازی کنید. نصب‌کننده تنظیمات فعلی کلاینت را بازنویسی نمی‌کند. سرورهای قدیمی همان مجموعه را هم‌زمان با این ورودی‌ها فعال نگه ندارید.

برای ساخت سرور کتابخانه، Rust 1.95.0 و ابزار C++ ویژوال استودیو روی Windows لازم‌اند:

Set-Location altium-designer-mcp
cargo build --release --locked

فایل ساخته‌شده در altium-designer-mcp/target/release/altium-designer-mcp.exe قرار می‌گیرد. سورس کامل Rust و Cargo.lock در مخزن هستند؛ محیط Python و باینری‌های نصب محلی در Git نگهداری نمی‌شوند.

Related MCP server: kicad-mcp

رفتار اتصال

Altium و پروژهٔ موردنظر را باز کنید. برای عملیات زنده، ابتدا app_context را بخوانید تا نوع سند فعال و نسخهٔ اسکریپت مشخص شود. در صورت توقف پل، درخواست بعدی آن را پیش از ارسال فرمان بازیابی می‌کند. هماهنگ‌کننده، موتور مشترک اسکریپت را میان دو پل Python نوبتی در اختیارشان می‌گذارد. ابزار کتابخانهٔ Rust مستقل است.

X پنجرهٔ وضعیت فقط آن را مخفی می‌کند؛ Detach توقف صریح است. keepalive پل متوقف‌شده را پشت صحنه راه‌اندازی نمی‌کند. اگر پنجرهٔ modal باز باشد، خطای مشخص گزارش می‌شود؛ پس از تکمیل یا بستن آن درخواست را تکرار کنید. فرمان ویرایشِ timeoutشده خودکار تکرار نمی‌شود.

فایل‌های runtime به‌صورت پیش‌فرض در %LOCALAPPDATA%/AltiumMCPSuite ساخته می‌شوند. اسکریپت‌ها در مسیر دارای هش محتوا کپی می‌شوند تا cache اسکریپت Altium نسخهٔ قدیمی را نگه ندارد. مسیر تبادل پل قدیمی نیز در همین فضای کاربری است. ALTIUM_EXE، ALTIUM_MCP_RUNTIME و EDA_AGENT_WORKSPACE برای نصب سفارشی قابل تنظیم‌اند. برای چند نسخهٔ نصب‌شدهٔ Altium، مسیر executable را صریح مشخص کنید.

آزمون‌ها

.\.venv\Scripts\python.exe -m pytest tests -q
.\.venv\Scripts\python.exe tests/smoke_stdio.py
Set-Location eda-agent
..\.venv\Scripts\python.exe -m pytest tests/test_bridge.py tests/test_recovery.py tests/test_workspace_pointer_isolation.py tests/test_timeout_looks_for_a_dialog.py tests/test_units.py tests/test_websocket_framing.py -q

آزمون tests/smoke_stdio.py --live اختیاری است و پل Altium باز را برای کنترل بازیابی متوقف و دوباره راه‌اندازی می‌کند؛ پس از پایان عملیات جاری اجرا شود. تست‌های کامل upstream نیز همراه سورس هستند؛ برخی به پنجرهٔ واقعی، دادهٔ fixture یا ابزارهای دیگر نیاز دارند.

پروژهٔ سخت‌افزار مرتبط: RV1106G3 Header Board Robotics.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • kicad-mcp

    AbdulAzeez0001
    A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that gives AI agents end-to-end control of KiCad 9+ for rule checks, manufacturing exports, production-readiness certification, and live PCB editor control.
    MIT

  • KiCad MCP Server

    Akhil-Chaturvedi
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server for controlling KiCad EDA software, enabling schematics, PCB design, manufacturing outputs, design checks, and library management through any MCP-compatible AI assistant.
    MIT

  • CDT-KiCAD

    SlncTrZ
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to drive KiCAD PCB design automation through MCP, covering schematic authoring, board and routing operations, footprint/symbol libraries, vendor PCB import, validation and DRC, and manufacturing export. It exposes 236 registered tools with keyword discovery, dynamic project-state resources, and optional Streamable HTTP transport with fail-closed Bearer authentication.
    MIT