FASTMEAN MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@FASTMEAN MCP Create RC low-pass R=1k C=1u, preview, run AC 1Hz–100kHz, open in FASTMEAN"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
FASTMEAN MCP
Опишите электрическую схему обычным языком — получите готовый проект FASTMEAN и графики расчёта.
Локальный MCP-сервер позволяет ИИ создавать и изменять родные .scm, соединять
элементы проводниками, собирать подсхемы и запускать численный расчёт в FASTMEAN.
Ключевые номиналы можно вынести в .parameter, а формулы графиков и короткие
пояснения сохранить прямо в схеме. Числа рассчитывает установленная FASTMEAN;
рисунок схемы и графики по этим данным строит MCP.
Графики приходят ИИ прямо через MCP как изображения. Сохранённый расчёт можно
показать в нужном масштабе, выбрать интервал и получить RMS, среднюю мощность
и пик через fastmean_plot — с PNG/SVG, измерениями и происхождением данных.
Есть готовые профили подключения для Codex, Claude Code/Desktop, Kimi CLI и DeepSeek через Cline. Сервер использует стандартный протокол MCP stdio. Работа идёт через файлы и пакетный запуск решателя, без управления окнами.
Быстрый старт · Каталог элементов · Усилитель · Автоматическая схема на 20 элементах · Графики через MCP · Другие ИИ-клиенты · Все инструменты
В 1.6.0 добавлены все 44 обычных электрических класса каталога FASTMEAN 6.1: в том числе двух- и трёхобмоточные трансформаторы, ключи, нелинейные элементы, линии, модуляторы, логика и сумматоры. Доступны рабочая точка DC, развёртки параметров, нативные FFT и гармоники, редактирование таблиц и настроек. Состав каталога и границы поддержки · Что проверено в 1.6.0.
Быстрый старт
1. Что потребуется
Windows и отдельно установленная FASTMEAN 6.1 или 6.0 для расчётов.
Python 3.12+ с
pipиvenv, доступ к загрузке Python-зависимостей.Codex CLI для автоматической установки в Codex. Другие клиенты можно подключить вручную — инструкция.
Git для клонирования. Также можно скачать репозиторий через Code → Download ZIP.
FASTMEAN устанавливается отдельно по своей лицензии. Этот репозиторий содержит адаптер и примеры; установщик не скачивает программу, её решатели или шрифты. Без FASTMEAN доступны создание, чтение и preview поддержанных схем, а также графики по уже зарегистрированным нативным расчётам.
2. Скачать проект
В PowerShell или терминале Windows:
git clone https://github.com/maxewka/fastmean-mcp.git
cd fastmean-mcpПри скачивании ZIP распакуйте его и откройте терминал в папке с pyproject.toml.
3. Установить и подключить к Codex
py -3.12 distribution/install.py --dry-run
py -3.12 distribution/install.py
py -3.12 distribution/doctor.pyПервая команда показывает план. Вторая создаёт отдельную Python-среду,
устанавливает адаптер и добавляет сервер fastmean в настройки Codex.
Третья проверяет зависимости, путь FASTMEAN и настоящее соединение MCP.
Ожидаемый результат doctor: ok: true, mcp_protocol.initialized: true
и mcp_protocol.tool_count: 29.
По умолчанию FASTMEAN ищется в %LOCALAPPDATA%\FASTMEAN 6.1, затем в 6.0.
При другом расположении задайте путь явно:
py -3.12 distribution/install.py --dry-run --app-dir "C:\Apps\FASTMEAN 6.1" --output-dir C:\FastmeanResults
py -3.12 distribution/install.py --app-dir "C:\Apps\FASTMEAN 6.1" --output-dir C:\FastmeanResultsПодставьте свой путь к папке с Fastmean.exe. Для пакетных расчётов используйте
папку результатов с ASCII-путём. Вместо py -3.12 можно вызвать уже установленный
Python 3.12+ по полному пути. Настройки других MCP сохраняются; перед изменением
конфигурации создаётся резервная копия.
4. Переподключить MCP и выполнить первый расчёт
Перезапустите подключение MCP или приложение Codex. Отдельно запускать сервер
в терминале не нужно: клиент сам запускает его как процесс stdio.
Отправьте агенту, например:
Проверь fastmean_status. Создай RC-фильтр: R = 1 кОм, C = 1 мкФ. Соедини элементы проводниками, проверь preview, построй АЧХ и ФЧХ от 1 Гц до 100 кГц. Верни готовый SCM и графики.
При подключённой FASTMEAN fastmean_status возвращает installed: true.
Результат запроса — новый файл схемы, нативные числовые данные, CSV и PNG графика.
Файлы исходной схемы сохраняются; каждый расчёт получает свою папку.
После клонирования установите сервер в отдельную среду без Codex:
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install .Пример stdio-конфигурации. Замените три пути на реальные пути своего компьютера:
{
"mcpServers": {
"fastmean": {
"command": "C:\\path\\fastmean-mcp\\.venv\\Scripts\\python.exe",
"args": ["-X", "utf8", "-m", "fastmean_mcp"],
"env": {
"FASTMEAN_APP_DIR": "C:\\Apps\\FASTMEAN 6.1",
"FASTMEAN_OUTPUT_DIR": "C:\\FastmeanResults"
}
}
}
}Либо сгенерируйте конфигурацию для своего клиента:
.\.venv\Scripts\python.exe -X utf8 -m fastmean_mcp.client_config --client kimi --app-dir "C:\Apps\FASTMEAN 6.1" --output-dir C:\FastmeanResults --write fastmean-kimi.jsonПрофили: claude-code, claude-desktop, kimi, deepseek-cline, generic.
В существующих настройках объедините только запись fastmean, сохранив другие
серверы. Ключ модели и вход в аккаунт настраиваются в ИИ-клиенте; серверу
FASTMEAN ключи поставщиков моделей не нужны.
Куда поместить конфигурацию и как проверить каждый клиент →
Установку можно поручить агенту из открытой папки репозитория:
Установи FASTMEAN MCP через distribution/install.py. Сначала проверь dry-run, затем выполни установку и doctor. Используй мою установленную FASTMEAN и существующий Python. Сохрани остальные настройки MCP и настройки Windows.
Обновление, удаление и дополнительные параметры — в руководстве установщика.
Related MCP server: kicad-forge
Пример: усилитель на четырёх транзисторах
Запрос: синус 1 кГц, вход 1 В RMS, выход около 25 В RMS и 500 Вт на 1,25 Ом. Питание усилителя — ±38 В. Каждый транзистор представлен отдельной редактируемой подсхемой с эквивалентной моделью. MCP создал схему с четырьмя BJT-подсхемами, физическими проводниками, параметрами нагрузки и обратной связи, формулами напряжения, тока и мощности.



Каждый блок можно открыть и изменить: три сопротивления, два PWL-диода и два управляемых источника тока. Это фиксированные авторские эквиваленты; параметры и допущения описаны в примере.
Величина | Результат FASTMEAN в установившемся режиме |
Входное напряжение | 1,000 В RMS |
Выходное напряжение | 25,003 В RMS |
Ток нагрузки | 20,002 А RMS |
Средняя мощность нагрузки | 500,10 Вт |
Входной ток | 66,8 мА RMS; 94,5 мА пик |
Это учебный пример с приближёнными PWL-моделями. Тепловая устойчивость, пробой, SOA и высокочастотные эффекты не моделируются; результат не подтверждает пригодность схемы для физической сборки на 500 Вт. Рисунок схемы отрисован MCP, графики Matplotlib построены по числам штатного решателя FASTMEAN.
Открыть пример: файлы схемы, подсхемы, данные и повторение расчёта →
Чтобы попробовать после клонирования, попросите:
Возьми examples/four-bjt-amplifier/Amplifier_4BJT.scm. Проверь соединения, рассчитай переходный процесс до 0,30 с с шагом 10 мкс и eps = 1e-5. Построй U(IN), U(OUT), I(RL), I(VIN), U(OUT)*I(RL). После fastmean_transient передай его run_id в fastmean_plot. Покажи 0,297–0,300 с, а RMS и среднюю мощность измерь на 0,29–0,30 с. Выведи входной ток в мА, добавь линию средней мощности и верни PNG/SVG через MCP. Объясни, какие параметры можно менять через .parameter.
В схеме сохранены пять выражений графиков и поясняющие TEXT. Папка models
должна находиться рядом с SCM. Для этого нелинейного примера используйте
переходный расчёт TD; частотные графики FD в примере отключены.
При изменении номиналов через fastmean_edit_values MCP сохраняет новую схему
вместе со всеми вложенными моделями. Переносите всю возвращённую папку проекта:
это позволяет открыть изменённый усилитель независимо от исходной папки.
Для изменения общей настройки используйте fastmean_edit_parameters, например
updates={"Rload":2,"Rf":"3k","Vrail":40}. Он меняет объявления параметров,
сохраняя привязки парных элементов, подписи и формулы. Это новый вариант схемы;
его режим нужно пересчитать. Обычный edit_values заменяет значение выбранного
элемента числом. Параметры и чтение больших схем →
fastmean_plot выбирает точные столбцы сохранённого нативного CSV. Интервалы
display_window=[0.297,0.3] и measurement_window=[0.29,0.3] независимы;
x_unit="ms" меняет отображение оси. Для I(VIN) задайте unit="mA",
scale=1000, metrics=["rms","peak"]; для U(OUT)*I(RL) —
unit="W", metrics=["mean"], guides=["mean"]. Измерения учитывают
неравномерные временные шаги, а новый график получает собственный run_id.
Полные аргументы, формулы измерений и повторное открытие графика →
Автоматическая компоновка: 20 элементов
Три каскада фильтра Бесселя по топологии Texas Instruments SLOA049D:
18 элементов исходной схемы плюс источник и нагрузка. MCP сам выбрал
координаты: сигнальная цепь идёт слева направо, обратные связи расположены
над своими каскадами, шунтирующие элементы — снизу. Используются настоящие
ортогональные проводники и родные трёхвыводные символы OPAMP.

В SCM сохранены девять .parameter, формулы графиков и поясняющие TEXT.
FASTMEAN рассчитал 301 точку АЧХ и 5004 точки переходного процесса;
комплексная АЧХ совпала с независимым решением узловых уравнений с ошибкой
менее 1,6e-12. Номиналы выбраны для учебного примера; OPAMP — идеальная
модель с конечным усилением, без ограничения питания, тока и полосы.
Готовый SCM, графики, источник топологии и повторение через MCP →
Возможности и инструменты
Можно попросить: «Создай RC-фильтр с R=1 кОм и C=1 мкФ, проверь рисунок, построй АЧХ и ФЧХ от 1 Гц до 100 кГц и получи передаточную функцию. Затем открой схему в FASTMEAN».
Обычная последовательность: status → example → create → preview → inspect → AC / transient / symbolic. Для оформления численного результата: AC / transient → plot. Открытие окна выполняется отдельно через fastmean_open.
Доступно 29 инструментов:
Инструмент | Назначение |
| Установка, возможности, лимиты и активные операции |
| JSON-примеры RC, RLC, делителя напряжения и flyback |
| Классы элементов, родные параметры, порядок и геометрия выводов, границы проверок |
| Новая родная SCM из элементов и узлов |
| Переносимый проект с родными подсхемами и исходным JSON |
| Параметры, поясняющий TEXT и сохранённые формулы TD/FD в новой копии |
| Нативное раскрытие схемы и экспорт полного netlist с происхождением файлов |
| Компоненты, соединения, порты и параметры SCM |
| Изменение номиналов в новой копии |
| Параметры и таблицы элементов, сохранённые настройки анализа и |
| Изменение существующих |
| Перекомпоновка поддержанной цепи с физическими проводами |
| PNG и SVG схемы для визуальной проверки |
| Нативная АЧХ/ФЧХ, CSV и PNG графика |
| Нативный переходный процесс, CSV и PNG |
| Нативная рабочая точка с явным заданием постоянного смещения источников |
| 1–32 расчёта для заданных значений переменной или параметра элемента |
| Нативные итоговые функции AVG/RMS/last и FFT с явными настройками |
| До семи гармоник через штатные tre/tim/tmag/tph |
| Амплитуда, фаза и PSD: NumPy rFFT по нативным временным данным |
| График по сохранённому нативному run_id: PNG/SVG через MCP, интервалы, единицы, RMS/mean/peak и происхождение данных |
| Нативная символьная формула и передаточная функция |
| Поиск схем в установленной FASTMEAN |
| Открытие рабочей копии штатной программой |
| Поиск по включённой справке возможностей |
| Сохранённые задания и результаты |
| Результат по run_id, изображения и ссылки на файлы |
| Страница числовых данных CSV |
| Отмена принадлежащей серверу активной операции |
Схемы и рисунки
Создание поддерживает 44 электрических класса FASTMEAN 6.1.
Перед незнакомым элементом вызовите fastmean_catalog(query="TR3",detail=true):
он возвращает порядок выводов, числовой шаблон и ограничения параметров.
Источники U/V и I имеют все пять режимов: постоянный, синусоидальный,
импульсный, треугольный и табличный PWL. Узлы U/V задаются
как [плюс, минус], узлы I — как [from, to]: положительный ток направлен от
первого узла ко второму. 0 — земля. Например,
{"kind":"I","name":"I1","nodes":["0","out"],"value":"1m"} задаёт
источник 1 мА из земли в out. Есть фиксированные нативные примитивы: диод D
с parameters={Ron,Roff,Uon}, управляемые источники G/VCCS, E/VCVS,
F/CCCS, H/CCVS с четырьмя узлами в порядке родных выводов и числовым value.
Их нативные параметры — g, k, h, r соответственно. Имена — ASCII-идентификаторы.
Поддерживаются также нативный идеальный трансформатор TR (n = Np/Ns)
и ключ SW, управляемый напряжением (Ron, Roff, Uon, Uoff).
Для TR узлы идут как [p1,p2,s1,s2], одноимённые выводы — p1 и s1;
для SW — [control+,control−,switch1,switch2], для D — [анод,катод].
Родной трёхвыводный OPAMP принимает
[неинвертирующий,инвертирующий,выход] и конечное усиление k.
Номиналы задаются в СИ или строками с суффиксами: M — мега, m — милли,
u — микро.
Публичный waveform.delay всегда задаётся в секундах. FASTMEAN хранит задержку
синуса, импульсов и треугольника в периодах — MCP выполняет это преобразование.
delay_periods позволяет явно задать периоды вместо секунд. Фаза синуса
передаётся в родной PHI0: в проверенной 6.1 нулевая фаза соответствует косинусу;
для синуса используйте phase=-90. PWL принимает 2–4096 пар [time,value].
Непериодический USER после последней точки линейно продолжает последний участок;
периодический режим ограничивается periods. Это поведение нативного источника.
{
"components": [
{"kind": "U", "name": "U1", "nodes": ["in", "0"], "value": 1, "waveform": {"kind": "sine", "frequency": "1k"}},
{"kind": "R", "name": "R1", "nodes": ["in", "out"], "value": "1k"},
{"kind": "C", "name": "C1", "nodes": ["out", "0"], "value": "1u"}
],
"ports": ["in", "out"],
"analysis": {"input": "in", "output": "out"}
}Новые схемы используют соседние элементы, ортогональные провода и родные
соединительные узлы. Порты обозначают внешние входы и выходы. Для ручной
компоновки есть layout.placements, layout.nodes, layout.ports и
layout.routes: координаты кратны 4, повороты — 0–3. Автоматические
интервалы остаются кратными 20; положение реальных выводов сохраняется точно.
layout.nodes задаёт подсказки для трассировки: лишний тупик к такой точке
может быть удалён после подключения выводов. Обязательную форму проводов
задавайте через layout.routes; координаты компонентов и портов — через
placements и ports.
layout.ground_style="rail" задаёт общую нижнюю шину земли по умолчанию;
"local" размещает отдельные родные GND у заземлённых выводов. Явные маршруты
узла 0 требуют режима rail.
Preview проверяет допустимость моделей и маршрутов, отклоняя неподдержанную
геометрию. Его PNG/SVG помечен MCP schematic preview, not native screenshot.
Часть новых элементов показана функциональными блоками с родными координатами
выводов; это инженерные обозначения MCP, а не точная копия всех символов GUI.
Проверяйте расположение элементов, подписи и провода по preview. Для плотной
схемы могут потребоваться ручные координаты или маршруты; автоматическая
компоновка не гарантирует совпадения с произвольным образцом.
Набор внешних эталонных схем содержит девять авторских транскрипций, аналитические ожидания и раздельные входы для компоновки по образцу и автоматической расстановки. Численная правильность, связность и визуальное сходство оцениваются отдельно; наличие входных JSON само по себе не подтверждает прохождение нативных проверок.
Point75A сохраняет расположение и все 25 R/L/C опубликованного кроссовера Troels Gravesen, Fig.31: оригинальный PDF. Четыре отдельно обозначенных компонента стенда — источник и три резистивные нагрузки — дают 29 элементов. Это электрическая модель фильтров: нагрузки 8 Ом не воспроизводят акустику динамиков. Оригинальные PDF и изображения не распространяются.

Это рисунок, построенный MCP по SCM, с читаемыми обозначениями; не снимок окна FASTMEAN. Готовая схема открывается в программе.
Flyback-преобразователь
fastmean_example(kind="flyback") возвращает готовую схему: 24 В, 50 кГц,
заполнение 40%, трансформатор 1:1, индуктивность намагничивания 200 мкГн,
выходной конденсатор 47 мкФ и нагрузка 20 Ом. Используются штатные TR и SW.
Индуктивность LM хранит энергию; идеальный TR сам по себе её не накапливает.
Возьми fastmean_example с kind="flyback". Создай схему, проверь preview, рассчитай 10 мс с шагом 100 нс и eps=1e-5. Построй U(out), U(drain), I(LM), I(DOUT), U(gate). Через fastmean_plot покажи запуск и последние три периода, измерь среднее U(out) на 9–10 мс.
Проверенный результат FASTMEAN 6.1: 15,584 В среднего выходного напряжения на 9–10 мс. Это разомкнутая учебная модель без насыщения, индуктивности рассеяния и паразитных параметров транзистора; земли обмоток служат общей численной точкой отсчёта. Нативные состояния с одинаковым временем при переключении сохраняются и обрабатываются штатными графиками MCP.
Пример, SCM и графики · Формат TR/SW, полярности и ограничения
Подсхемы и изменение проекта
fastmean_create_project принимает полный JSON проекта. models содержит определения с внешними выводами и собственной схемой; корневой circuit подключает их элементами X:
{
"models": {
"RES": {
"pins": {"Left": ["P"], "Right": ["N"]},
"circuit": {
"components": [{"kind": "R", "name": "R1", "nodes": ["p", "n"], "value": "1k"}],
"ports": {"P": "p", "N": "n"}
}
}
},
"circuit": {
"components": [
{"kind": "U", "name": "U1", "nodes": ["input", "0"], "value": 1},
{"kind": "X", "name": "BLOCK1", "model": "RES", "connections": {"P": "input", "N": "output"}},
{"kind": "R", "name": "RL", "nodes": ["output", "0"], "value": "1k"}
],
"ports": {"IN": "input", "OUT": "output"},
"analysis": {"input": "IN", "output": "OUT"}
}
}Нумерация выводов блока идёт по сторонам Left, Top, Right, Bottom, внутри стороны — по списку. Все выводы должны иметь уникальные публичные ASCII-имена, точно совпадать с ключами ports определения и полностью присутствовать в connections. Поддержано до 99 моделей и 32 выводов на модель; ссылки могут быть вложенными. Активная рекурсия отклоняется до запуска решателя. Циклическая файловая ссылка через тестовый элемент с именем _… допустима: FASTMEAN исключает такие элементы внутри подсхемы, сохраняя их при самостоятельном запуске файла. Копирование и переименование проекта сохраняет эти ссылки. Определения могут не иметь внутренней земли: их внешние узлы подключает родитель. Числовой расчёт выполняет FASTMEAN по родным элементам, включая раскрытие X.
Нативная программа восстанавливает интерфейс по физическому положению и повороту PORT в дочерней SCM. Поэтому компилятор размещает их на объявленных сторонах и проверяет порядок координат; названий в Pins недостаточно. Ручные layout.ports должны сохранять эту сторону и порядок: Left — поворот 2, Top — 3, Right — 0, Bottom — 1. Несогласованная схема отклоняется. Для новой геометрии X используются стандартные шрифты и масштаб 100; относительная подпись файла модели ограничена 20 ASCII-символами.
Проект сохраняет main.scm, относительные models/*.scm, project.spec.json, отдельные JSON схем и манифест хешей. Для изменения номиналов или структуры подсхемы прочитайте опубликованный project.spec.json, измените JSON и снова вызовите fastmean_create_project. Получится новый проект; предыдущие файлы сохранятся. Нативные .parameter, Scm/Actual и переопределения параметров экземпляров этим API не создаются. Произвольный импорт SPICE/BJT-моделей не реализован.
Создание и пересборка не запускают окно и не используют управление компьютером. Для проверки применяются чтение SCM, MCP preview поддержанной геометрии и нативные пакетные расчёты. fastmean_open остаётся отдельной явной командой открытия окна.
Для ключевых номиналов и пояснений есть fastmean_annotate_circuit: числовые/SI
parameters, bindings, поясняющие descriptions и сохранённые td_signals /
fd_signals. Например, parameters={"R0":"1k","Ratio":2} и
bindings={"R1":"R0","TR1":{"n":"Ratio"}} связывают сопротивление и коэффициент
трансформатора с общими параметрами. Для источника можно указать конкретное поле:
bindings={"VIN":{"PULSE.F":"Fswitch"}}. Доступны проверяемые скалярные поля;
файлы, интерфейс X, переключатели числа выводов и выражения логических элементов
не привязываются. Родные TEXT и формулы сохраняются в переносимой копии.
fastmean_edit_properties меняет объявленные родные поля, таблицы, сохранённые
настройки TD/FD/AOD/SOD/DCOP и определения .define, например
updates={"TR1":{"n":2},"SW1":{"Ron":0.01}}. Изменение N/HasRS меняет интерфейс:
такую схему нужно пересоздать с новыми соединениями. Исходные файлы сохраняются;
ни аннотация, ни редактирование не запускают расчёт или GUI.
Расчёты и результаты
FASTMEAN выполняет числовой расчёт через документированные скрипты. Matplotlib строит PNG по экспортированным нативным данным. Символьную формулу возвращает установленный cirsymw.exe; другим решателем она не подменяется. Preview схемы и график по данным имеют указанное происхождение и не являются снимками окна программы.
AC и TD принимают математические definitions и адресные overrides, например
definitions=[{"name":"gain","expression":"2"}], overrides={"R1.R":"2k"}.
TD поддерживает sample_after, начальные условия scheme / zero / dc либо
словарь IC и сохранение конечного состояния в отдельную SCM. fastmean_dc
получает нативную рабочую точку; для непостоянного источника смещение задаётся
явно через source_values. fastmean_sweep выполняет до 32 независимых расчётов
по значениям переменной или поля элемента, сохраняя данные каждого шага.
fastmean_evaluate возвращает штатные итоговые функции, например
last(RMS(U(OUT))), или нативную FFT FASTMEAN. Для FFT задаются окно,
число точек, гармоник и тип окна. fastmean_harmonics использует нативные
tre/tim/tmag/tph. Отдельный fastmean_spectrum рассчитывает NumPy rFFT
по временным данным FASTMEAN: интерполирует на равномерную сетку и возвращает
амплитуду, фазу и PSD с описанием нормировки. Эти два FFT-пути имеют разное
происхождение; исходный временной CSV сохраняется. Интерполяция не добавляет
частотной полосы — шаг нативного расчёта нужно выбирать по исследуемым частотам.
fastmean_plot читает зарегистрированный CSV завершённого AC/TD-расчёта,
проверяя его SHA256 по нативному манифесту. Формулы заново не вычисляются;
выбираются уже экспортированные столбцы. График возвращается как MCP
ImageContent и PNG/SVG-ресурсы; спецификация, измерения и манифест сохраняются
рядом. fastmean_get_result повторно возвращает изображение по run_id графика
после перезапуска. Аргументы и ограничения →
fastmean_export_netlist раскрывает схему штатной командой save_netlist, возвращая ограниченный текст, полный файл и манифест происхождения. Экспорт не запрашивает AC или переходный процесс. У экспорта и fastmean_transient есть timeout от 1 до 60 секунд, по умолчанию 60; он относится только к рабочему процессу данного запроса.
Исходные SCM сохраняются. Создание, редактирование, preview и расчёт получают отдельные папки. Нативная рабочая копия рекурсивно копирует зависимости подсхем, записывает хеши исходных и рабочих файлов, отключает окна графиков, развёртки и чтение сохранённого состояния; небезопасные файловые директивы отклоняются. fastmean_open явно открывает отдельную копию в GUI и также сохраняет зависимости и происхождение файлов. Существующие пользовательские окна сервером не управляются.
JSON-ответы ограничены по размеру; полный результат сохраняется отдельным файлом. PNG передаётся также как MCP ImageContent, файлы — как ResourceLink. Ресурсы:
fastmean://guide— справка возможностей и нативных команд;fastmean://runs/{run_id}— сохранённый результат и каталог файлов;fastmean://artifacts/{run_id}/{name}— опубликованный файл задания.
Читать можно только опубликованные файлы соответствующего задания. Отдельное чтение ограничено 8 МиБ; большие CSV читаются через fastmean_read_data страницами по 200 строк, максимум 500 за запрос. Активные operation_id доступны в status; отмена относится только к созданным сервером процессам.
Страницы CSV и изображения повторно открытых результатов проверяются по SHA256. Если сохранённый файл изменился, MCP сообщает об этом вместо выдачи его как исходного результата. У численных расчётов проверяется весь запрошенный интервал, а у АЧХ — также частотная сетка; незавершённый экспорт не считается успешным.
Перед переходным расчётом MCP ищет контуры из идеальных источников напряжения
и конденсаторов, включая соединения через вложенные подсхемы с проверенной
геометрией выводов. Тестовые элементы с префиксом _ в дочерних схемах
исключаются так же, как при нативном раскрытии. Обнаруженная проблема объясняется
до запуска расчёта. Неизвестный интерфейс или предел раскрытия отмечается как
частичная проверка в манифесте. Это не полный анализ корректности модели;
частотный расчёт остаётся отдельной операцией.
У намеренно свободного вывода генератор ставит короткий провод и один родной соединитель, как рекомендует FASTMEAN. Такой конец не удаляется при упрощении дорожек; лишней нагрузки или внешнего PORT не добавляется.
Переменная | Назначение |
| Папка отдельно установленной FASTMEAN с Fastmean.exe |
| Папка новых схем и результатов, вне установки приложения |
Приложение ищется в %LOCALAPPDATA%\FASTMEAN 6.1, затем 6.0. Установщик задаёт собственную папку results; при прямом запуске сервера используется Documents\Codex\FASTMEAN-runs текущего пользователя. MCP-клиент сам запускает stdio-сервер. Для разработки доступны python -m fastmean_mcp и console entry point fastmean-mcp.
Ограничения и русский интерфейс
Лишние CON на изгибах удаляются, когда штатный проводник FASTMEAN точно
воспроизводит маршрут. Точки разветвлений сохраняются. В сложных обходах остаются
необходимые опорные CON: SCM хранит концы проводника, а не произвольную полилинию.
Preview отображает оставшиеся точки, включая опорные, как в нативной схеме.
fastmean_annotate_circuit принимает td_signals=[] или fd_signals=[] для очистки
соответствующих сохранённых графиков; null сохраняет прежние настройки.
Автоматическая расстановка по умолчанию компактная: layout.density="compact".
Шаг вдоль сигнальной цепи уменьшен с 320 до 240, отступ ветвей — с 200 до 160
единиц. layout.density="standard" возвращает прежние интервалы. Параметр
density доступен и у fastmean_relayout; исходный файл сохраняется.
Ручные координаты остаются заданными пользователем и принимаются с шагом 4.
Размер символов сохраняется; длинные подписи нужно проверять на preview.
Символьный адаптер поддерживает линейные R/C/L/U/I, G/E/F/H, OPAMP, TR/TR3,
GYR, SUM и UNISTOR, включая раскрываемые подсхемы X. Доступны U/I/H/Z/Y при
нулевых начальных условиях. Для нормированной функции нужен один независимый
источник; выбор input_source и знаки выходной величины задаются явно.
Это не универсальный решатель произвольных или нелинейных уравнений.
fastmean_relayout работает с геометрией каталога и проверенными интерфейсами X;
сложный граф по-прежнему может требовать ручных координат.
Служебные DIGITAL_IN/410 и DIGITAL_OUT/420 — контакты внешних DLL-модулей, а не обычные порты подсхем. Их имя связывается с выводом загруженной DLL. Исполнение таких модулей через MCP не реализовано; обычные схемы используют PORT/400. Непривязанные цифровые контакты приводят к сбою FASTMEAN, поэтому неподдержанный контекст отклоняется до расчёта. Внутренние вспомогательные источники и старые TypeID не предлагаются как самостоятельные новые элементы. Старые бинарные SCM, произвольный SPICE-импорт и управление всеми окнами GUI не поддержаны. Ограничения DEMO задаёт установленная FASTMEAN.
Русский интерфейс старой ANSI-программы исправляет отдельный проект FASTMEAN Russian UI, распространяемый своим установщиком. Его код, библиотеки и установщик отделены от MCP. MCP создаёт схемы и выполняет расчёты независимо от этого помощника; установка MCP не меняет интерфейс FASTMEAN или системную локаль.
Разработка и проверки
Проверки 1.6.0 · Предыдущие проверки. Покрытие каталога, отдельные количественные проверки и границы моделей описаны раздельно. Наличие элемента в каталоге не подтверждает точность каждого его режима или пригодность физического устройства.
python -m pip install -r requirements-dev.txt
python -m pip install -e .
python -m pytest -qCI настроен для Python 3.12 на Ubuntu и Windows без FASTMEAN. Нативные тесты там пропускаются: это проверка адаптера, а не сертификация движка. На Windows при наличии FASTMEAN тесты test_engine обнаруживают её автоматически. Для дополнительных настоящих stdio/relayout расчётов включите FASTMEAN_MCP_NATIVE_TEST=1 и FASTMEAN_RELAYOUT_NATIVE=1. Они запускают установленную программу в отдельных рабочих процессах и сохраняют входные SCM.
Основные модули: server.py — MCP; schematic.py / layout.py — SCM и провода; preview.py — рисунок; engine.py — числовой CLI; symbolic.py — CIRSYM; plotting.py — графики и измерения сохранённых данных; artifacts.py — результаты и ресурсы. Заметка о других инженерных MCP объясняет принятые решения. Прохождение ещё не запущенного CI и совместимость со всеми установками не предполагаются: смотрите фактический журнал своего запуска.
Оригинальный код адаптера — MIT. Зависимости и внешние материалы перечислены в THIRD_PARTY_NOTICES.md. Отдельный русификатор имеет собственную лицензию LGPL-3.0-only. FASTMEAN остаётся отдельным приложением со своей лицензией. Основные источники: информация и руководство, ссылки авторов, символьный анализ FASTMEAN.
Проверки на внешних схемах
Набор из девяти схем Masala-CHAI проверяет компоновку по образцу и автоматическое размещение: 18 вариантов созданы и рассчитаны через настоящий MCP. Все 18 АЧХ совпали с независимыми уравнениями; прошли 14 поддержанных переходных расчётов. У ёмкостного делителя переходный расчёт в FASTMEAN завершался по тайм-ауту — это ограничение явно сохранено в отчёте. Номиналы, назначенные для проверки, отделены от напечатанных в первоисточнике значений.
Галерея содержит наши MCP-рисунки; исходные сканы не распространяются. Численные проверки и сравнение с рисунком учитываются отдельно.
Available Tools
29 toolsfastmean_acB
Run native AC analysis. Return CSV, native text, manifest and a PNG chart.
Example signals: db(U(out)/U(in)), phs(U(out)/U(in)), mag(U(out)), I(R1). Use exact circuit port/component names. PNG is rendered from native data. A working copy disables graph windows and sweeps; original SCM is untouched.
Inputs: path (required), fmax, fmin, scale, +4 more.
fastmean_annotate_circuitA
Add numeric constants, text explanations and saved native formulas to a copy.
parameters maps ASCII identifiers to finite numbers/SI literals. bindings maps root component names to an expression for convenience value fields, or to native scalar fields, e.g. {"TR1":{"n":"Ratio"},"VIN":{"PULSE.F":"Freq"}}. Native child-instance parameter declarations are unsupported. descriptions adds plain explanatory native TEXT objects. [] clears saved traces; None preserves them. td_signals/fd_signals replace saved active expressions, for example U(OUT), I(RL), db(U(OUT)/U(IN)), phs(U(OUT)/U(IN)). Root TD/FD settings are retained, requested expressions are preloaded, and SCM model dependencies are privately packaged. Sources remain unchanged. Does not launch calculations, a window or desktop automation.
Inputs: path (required), bindings, fd_signals, parameters, +2 more. Returns: object
fastmean_cancelB
Cancel one active native operation listed by status; never other processes.
Inputs: operation_id (required). Returns: object
fastmean_catalogBRead-onlyIdempotent
Discover native FASTMEAN element kinds, aliases, pins and parameter schemas.
Start here before creating an unfamiliar component. detail=true includes native defaults, bounds and validation schemas. Numerical test evidence is reported separately from the observed native factory and pin geometry.
Inputs: query, detail, include_service. Returns: object
fastmean_create_circuitA
Create a native .scm in a fresh folder from a node-based JSON circuit spec.
Start from fastmean_example. R/C/L values must be positive. Ground is 0. Components connect through physical wires and junctions; ports are external I/O only. Optional spec.layout.placements maps names to {x,y,rotation}; x/y are multiples of 4 and rotation is 0=left/right,1=up/down,2/3=reversed. spec.layout.density is compact (default) or standard. Explicit coordinates stay unchanged; density controls automatic spacing only. ground_style is rail (default) or local. U nodes are [+,-]; I nodes are [from,to]. A single-terminal node gets one short wire and native CON endpoint, without an added electrical load or external PORT. All names used in analysis must be ASCII. Does not open a window. Fixed native primitives: D nodes=[anode,cathode], parameters={Ron,Roff,Uon}; G/VCCS, E/VCVS and F/CCCS use four native-ordered nodes and a numeric value. TR/TRANSFORMER nodes=[p1,p2,s1,s2], dotted pins1/3, n=Np/Ns>0; value=n or parameters={n}. SW/VCSWITCH nodes=[control+,control-,switch1,switch2], parameters={Ron,Roff,Uon,Uoff}, 0<Ron<=Roff, Uoff<=Uon; native hysteresis. See example(kind='flyback') and the guide for polarity and magnetic storage. spec.analysis.transient accepts stop, step and eps (0<eps<=0.1), saved in SCM. Use fastmean_create_project for X subcircuits and portable model files. All44 insertable classes are supported: call fastmean_catalog(detail=true) for nonlinear R/C/L, H, GYR, TR3, TUBE, NMOS_SMALL, NPN, OPAMP_SAT, PWM, PAM1/PAM2, BALMOD, THYRISTOR, MOSFET, LINE, BRIDGE, RS/DFF/JK/RSCLK, NOT/AND/OR/XOR/LATCH/COMP and SUM. Supply parameters by native key; omitted values use explicit adapter templates. Sources also support triangle/PWL.
Inputs: spec (required), name. Returns: object
fastmean_create_projectA
Create a portable native root circuit and fixed numeric subcircuit files.
spec={name?,models:{MODEL:{pins:{Left:[B],Top:[C],Right:[],Bottom:[E]}, circuit:{components:[...],ports:{B:b,C:c,E:e}}}},circuit:rootCircuit}. X components use {kind:X,name:Q1,model:MODEL,connections:{B:base,C:col,E:0}}. Side lists determine native terminal numbering Left,Top,Right,Bottom. A definition may float; ports must match declared pins exactly. All models must exist and be acyclic; instance parameters and .parameter headers are unsupported. Other components use the create_circuit schema. Each circuit supports compact/standard density and explicit coordinates independently. Return main.scm, models/*.scm, original JSON specs, hashes and a manifest. To edit definitions, modify the saved project.spec.json and call this tool again: every call creates a new project and preserves the previous files. Does not launch FASTMEAN, calculations, GUI or desktop automation.
Inputs: spec (required), name. Returns: object
fastmean_dcB
Calculate the native DC operating point in a private copy.
Uses native DC initialization and a zero-duration native export. DC source ramps/delays are removed only in the private DC copy and recorded. Supply source_values to replace non-DC source waveforms for this calculation.
Inputs: path (required), signals, timeout, overrides, +2 more.
fastmean_edit_parametersA
Update existing numeric root .parameter/.param constants in a new copy.
updates maps exact case-sensitive parameter names to finite numbers/SI values. Only literal spans change; descriptions, component bindings, graph formulas and portable model files are preserved. Expressions, ambiguous declarations and overriding define/global/set names are rejected. Use inspect's root_parameters before editing. This does not run a calculation or a GUI. Pass the inspection's source_sha256 as expected_source_sha256 to reject source changes made between inspection and this request.
Inputs: path (required), updates (required), expected_source_sha256. Returns: object
fastmean_edit_propertiesA
Edit native component parameters, tables and saved settings in a new project.
updates={"TR1":{"n":2},"SW1":{"Ron":0.01}}; nested parameter patches retain omitted fields. analysis selects saved TD/FD/AOD/SOD/DCOP fields, including graph expressions and sweep settings. definitions saves native .define variables/functions as TEXT. No source files are overwritten or run here. File/model interfaces use create_project, not arbitrary parameter paths.
Inputs: path (required), updates, analysis, definitions. Returns: object
fastmean_edit_valuesA
Create an edited copy, retaining topology and unknown native objects.
updates maps component names to SI values, or to {value:...,waveform:...}. This supports R/C/L/U/I value edits and never overwrites the selected source. A literal edit replaces any parameter binding on that component. To keep shared .parameter bindings, use fastmean_edit_parameters instead. Explicit waveform fields update the selected mode, retaining omitted fields and other modes; waveform amplitude/high overrides value when supplied.
Inputs: path (required), updates (required). Returns: object
fastmean_evaluateB
Evaluate native post-analysis functions or the native FASTMEAN FFT.
signals may use last/AVG/RMS or native harmonic functions. FFT mode uses explicit fft settings and FFT expressions; a separate native time writer proves the simulated interval. Returns the actual native summary/FFT table, not a fabricated transient time axis. No arbitrary script is accepted.
Inputs: path (required), signals (required), eps, fft, +5 more.
fastmean_exampleARead-onlyIdempotent
Get an editable JSON spec: rc_lowpass, rlc_lowpass, voltage_divider, flyback.
components have kind, name, nodes [positive,negative] for U/V, and SI value. Voltage waveform: {kind:dc|sine|pulse, frequency, amplitude, phase, delay, high, low, duty_percent, rise_time}; only fields applicable to its kind. flyback uses a native TR transformer, separate magnetizing L, native SW voltage-controlled switch, pulse drive and diode rectifier. Use transient.
Inputs: kind. Returns: object
fastmean_export_netlistA
Export the installed FASTMEAN engine's native expanded circuit netlist.
Opens a sanitized recursive working copy in a private batch process, runs save_netlist and exits. Returns bounded text, full netlist and provenance artifacts. Does not launch a GUI or request AC/transient simulation. timeout limits only this owned worker to 1–60 seconds; cancellation uses the same owned-process mechanism as other native operations.
Inputs: path (required), timeout.
fastmean_get_resultCRead-onlyIdempotent
Reopen a persisted result with images and registered artifact resources.
Inputs: run_id (required).
fastmean_harmonicsB
Extract up to seven harmonics using native tre/tim/tmag/tph expressions.
Frequencies are Hz; window=[start,end] seconds. FASTMEAN itself evaluates the harmonic expressions. This differs from the NumPy spectrum tool.
Inputs: path (required), signal (required), window (required), frequencies (required), +6 more.
fastmean_inspectARead-onlyIdempotent
Read SCM metadata, root parameters, ports and formulas without losing fields.
Default summary has compact components and independently budgeted pages; include_objects adds a raw-object page. section selects complete native data with offset/limit pagination. data is a list, mapping or text, as page.kind reports. Use detail_path for nested large fields, e.g. objects [5,"Params"] or analysis ["TD","Expressions"]. Text selections paginate characters. Reuse source_sha256 as expected_source_sha256 on later pages to reject edits between reads. Reads create no jobs and start no calculations or windows.
Inputs: path (required), limit, offset, section, +3 more. Returns: object
fastmean_list_examplesARead-onlyIdempotent
Find installed example SCM files by substring; use returned paths in analysis.
Inputs: query. Returns: object
fastmean_list_runsCRead-onlyIdempotent
Find persisted calculations, created diagrams and preview runs after restart.
Inputs: limit. Returns: object
fastmean_openA
Open a working copy through the installed FASTMEAN executable's documented CLI.
Recursively packages SCM model dependencies and records source/copy hashes. Starts a separate application process; leaves existing windows alone. The circuit window stays open for the user, and is not controlled automatically. This command does not apply locale emulation; old Russian UI text may appear garbled on Windows configured for another legacy code page.
Inputs: path (required). Returns: object
fastmean_plotA
Plot registered AC, transient, native FFT or NumPy spectrum data through MCP.
panels selects 1–12 exact exported columns. A panel is {signal, label?, unit?, scale?:1, metrics?:[rms], guides?:[], color?:'#2563eb'}. Metrics are rms/mean/peak/min/max/peak_to_peak; guides are mean/rms and include that measurement. Frequency panels have metrics=[]; time-weighted metrics require TD. unit is a caller-supplied display label; display_value=native_value*scale with finite positive scale. No new formulas are evaluated. For native power, export e.g. U(OUT)*I(RL) during transient and select that exact column here. Windows are [start,stop] in original seconds/Hz, independently of x_unit. Interpolate exact endpoints, retain adaptive timestamps and both states of equal-time switching events in native order, and reject extrapolation. RMS uses trapezoids of squared samples. Metrics use the full measurement window before graphical decimation. Original run stays intact; a new run returns ImageContent, PNG/SVG/spec/measurements/manifest resources.
Inputs: run_id (required), title, panels, x_unit, +3 more.
fastmean_previewA
Render a wire-connected SCM to readable PNG and SVG for visual review.
This is an MCP rendering of native objects, not a FASTMEAN screenshot. Proven native L/midpoint bends are reconstructed exactly. Unsupported symbols/detours are rejected. No application window is opened. include_text=False omits TEXT notes from this image and its bounds only; all source annotations and parameter bindings remain unchanged.
Inputs: path (required), include_text.
fastmean_read_dataCRead-onlyIdempotent
Read a page of registered calculation samples with their recorded provenance.
Inputs: run_id (required), limit, offset. Returns: object
fastmean_relayoutA
Rebuild a supported circuit as adjacent components with physical wires.
Converts old per-pin PORT layouts into a connected orthogonal drawing. Preserves values, waveforms and native analysis in a new SCM. Supports catalog primitives and portable subcircuits. Optional placements: {R1:{x:960,y:1000,rotation:0}}. Numeric node-voltage references require stable named ports before changing geometry. density selects compact (default) or the previous standard spacing.
Inputs: path (required), density, placements. Returns: object
fastmean_search_manualCRead-onlyIdempotent
Search the verified native automation reference; query is literal text.
Inputs: query (required). Returns: object
fastmean_spectrumC
Return spectrum amplitude/phase/PSD of real FASTMEAN transient samples.
FASTMEAN calculates time samples. NumPy interpolates onto a uniform grid and performs rFFT; the PNG is Matplotlib, not a native FFT-window screenshot. Native source CSV, selected window and transform normalization are retained.
Inputs: path (required), signal (required), eps, step, +7 more.
fastmean_statusARead-onlyIdempotent
Check installation, native engines, output location and supported operations.
Inputs: no named parameters. Returns: object
fastmean_sweepA
Sweep one native variable or component.parameter over 1–32 values.
Each point is a separate owned native calculation. settings carries the corresponding AC/transient/DC options; native samples and provenance are retained for every point. The original schematic is preserved.
Inputs: path (required), target (required), values (required), signals, +5 more.
fastmean_symbolicA
Get native CIRSYM U/I/H/Z/Y formulas for supported linear zero-state circuits.
Native FASTMEAN exports connectivity before conversion to CIRSYM. Optional input must be driven by a unique grounded independent voltage source; the transfer function is derived by dividing the native output by its amplitude. Set input=null for an output equation only. Not an arbitrary equation solver.
Inputs: path (required), input, output, analysis, +3 more.
fastmean_transientB
Run native time-domain analysis; return native samples, CSV and PNG.
Examples: U(out), U(in), I(R1). Seconds and SI values are numeric. Starts at time zero with the schematic's component IC values; no saved-state files. timeout limits this owned worker to 1–60 seconds (default 60).
Inputs: path (required), eps, step, stop, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Most tools target distinct actions, but there are two large clusters with fuzzy boundaries: the editing tools (edit_parameters, edit_values, edit_properties, annotate_circuit, relayout) all create modified copies, and the analysis tools (ac, transient, dc, sweep, spectrum, evaluate, harmonics) overlap enough that an agent must read long descriptions to pick correctly. The descriptions do explicitly disambiguate (e.g. NumPy spectrum vs native harmonics vs native FFT evaluate), which prevents a lower score, but the create_circuit vs create_project split is also easy to confuse.
All names share a consistent fastmean_ snake_case prefix and split cleanly into action tools (create_*, edit_*, list_*, get_*, search_*, export_*, read_*) and analysis tools named by the analysis type (ac, transient, dc, sweep, spectrum, harmonics, symbolic). The mix of bare nouns for analyses and verb_noun elsewhere is a minor deviation but is coherent and readable.
At 29 tools this is well above what an agent can hold comfortably, and several tools could be merged (the four separate edit tools, the seven-plus analysis entry points). The domain is genuinely broad, but the surface is heavier than necessary for the workflows it supports.
The lifecycle is well covered: authoring (create_circuit, create_project, catalog, examples, manual), inspection, multiple edit paths, all major native analyses, plotting/spectrum post-processing, persistence (list_runs, get_result), export and cancel. Gaps are minor — no tool to delete/clean up persisted runs or projects, and no explicit close/reset for opened windows.
Maintenance
Related MCP Connectors
Check, simulate and design electronic circuits, with a link to run each one live in the browser.
61Design, route, check, review and export manufacturable PCBs from plain language; KiCad import.
Electronics prototyping: real parts and pinouts, wiring checks, and shareable circuit designs.
Search real parts with datasheet-provenance specs, check compatibility and compose priced BOMs.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables building and simulating electronic circuits by converting netlist descriptions or drawings into live CircuitJS1 simulation URLs.2MIT
- AlicenseBqualityDmaintenanceProvides schematic/PCB analysis, authoring, and SPICE simulation through MCP, enabling direct KiCad file manipulation and verification without requiring KiCad for reading.18MIT
- AlicenseNot gradedqualityCmaintenanceEnables inspection of existing KiCad boards and schematics — layer/component/net reading, native DRC and ERC, XML netlist generation, Gerber/Excellon export, and GND continuity auditing — plus running LTspice or ngspice simulations with RAW waveform summaries and CSV export. It checks existing designs and preserves artifacts and evidence rather than performing GUI editing, auto-placement, or auto-routing.Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables agents to create, read, update, and validate editable analog/RF circuit schematic projects (including a five-transistor OTA template), wiring and moving components by pin name, running topology checks, exporting SVG or SPICE/Spectre netlists and normalized JSON, and opening the browser editor with a project loaded. It also exposes the component library's exact pins and defaults so drawings stay netlist-correct.MIT