Perfboard Designer — MCP-сервер для Claude Code
MCP-сервер, который заставляет ИИ-агента разводить перфорированные и полосовые платы: подбирает детали, проверяет соединения и отдаёт ссылку на редактор.
claude mcp add --transport http mcp https://mcp.perfboarddesigner.com/mcpЧто делает Perfboard Designer
Сервер работает на вашей машине через stdio или подключается по HTTP. Агент получает набор инструментов: ищет детали в каталоге, создаёт проект платы нужного размера, добавляет компоненты и провода, а потом проверяет схему на ошибки. Отчёт о проверке показывает неподключённые выводы, детали, налезшие друг на друга, замкнутые шины питания и на полосовой плате — выводы, соединённые полосой или попавшие в прорезь.
Проект живёт в памяти под projectId, поэтому агенту не нужно присылать файл заново после каждой правки. Исходный файл при этом остаётся главным: get_project вернёт его целиком, и любой инструмент примет полный файл вместо идентификатора. Готовую плату можно попросить нарисовать текстом или картинкой в PNG, а make_share_link выдаст ссылку, которая открывает её в редакторе на https://perfboarddesigner.com/app/.
Нужен Node.js 22 или новее: пакет perfboard-designer-mcp ставится через npx при первом запуске. Аккаунт не требуется. Ссылки указывают на публичный редактор — вы можете поменять его через переменную окружения PERFBOARD_EDITOR_URL. Если проект не проходит проверку, make_share_link откажется его публиковать, пока не выставлен allowErrors. Заодно это повод прогнать validate_project до конца, а не надеяться на удачу.
Какие задачи решает
- развести макет на перфорированной плате по словесному описанию схемы
- найти деталь по названию или по корпусу и посмотреть её выводы
- проверить плату на замкнутые шины и неподключённые выводы
- получить ссылку на плату, чтобы открыть её в редакторе и поправить руками
- сверить схему с задуманным списком соединений
Примеры запросов агенту
- Разведи мигающий светодиод на 555 в маленькой макетке и пришли ссылку
- Проверь плату в
projectIdи покажи, где провода висят без соединения - Добавь конденсатор рядом с микросхемой и заново проверь соединения
Как установить Perfboard Designer
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://mcp.perfboarddesigner.com/mcp2Командой платформы
claude mcp add --env PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> --env PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> --env PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> --transport stdio mcp -- npx -y perfboard-designer-mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add mcp --url https://mcp.perfboarddesigner.com/mcp2Командой платформы
codex mcp add mcp --env PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> --env PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> --env PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> -- npx -y perfboard-designer-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"url": "https://mcp.perfboarddesigner.com/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"perfboard-designer-mcp"
],
"env": {
"PERFBOARD_EDITOR_URL": "<PERFBOARD_EDITOR_URL>",
"PERFBOARD_PROJECTS_URL": "<PERFBOARD_PROJECTS_URL>",
"PERFBOARD_IMAGE_URL": "<PERFBOARD_IMAGE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.perfboarddesigner.com/mcp"
}
}
}{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"perfboard-designer-mcp"
],
"env": {
"PERFBOARD_EDITOR_URL": "<PERFBOARD_EDITOR_URL>",
"PERFBOARD_PROJECTS_URL": "<PERFBOARD_PROJECTS_URL>",
"PERFBOARD_IMAGE_URL": "<PERFBOARD_IMAGE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http mcp https://mcp.perfboarddesigner.com/mcp2Командой платформы
gemini mcp add -e PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> -e PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> -e PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> mcp npx -y perfboard-designer-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Perfboard Designer
Как установить Perfboard Designer в Claude Code?
Через stdio: `claude mcp add --env PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> --env PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> --env PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> --transport stdio mcp -- npx -y perfboard-designer-mcp. Либо подключите удалённую версию: claude mcp add --transport http mcp https://mcp.perfboarddesigner.com/mcp`.
Что делает Perfboard Designer?
Даёт агенту инструменты для работы с макетными платами: каталог деталей, создание и правка проекта, проверка соединений, отрисовка платы и ссылка на редактор, где её можно открыть и изменить.
Какие переменные окружения он понимает?
PERFBOARD_EDITOR_URL задаёт адрес редактора для ссылок. PERFBOARD_IMAGE_URL и PERFBOARD_PROJECTS_URL включают картинку платы и хранение проекта в make_share_link; значение off отключает их.
