itasca-mcp
MCP-сервер для геомеханики ITASCA: агент ищет в документации PFC, FLAC, 3DEC, MPoint и MassFlow и запускает модели
- 228 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет произвольный код внутри программы моделирования и пишет файлы проекта
- Мост открывает работающую программу ITASCA внешнему клиенту на время сеанса
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/itasca-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольный код внутри программы моделирования и пишет файлы проекта
- Мост открывает работающую программу ITASCA внешнему клиенту на время сеанса
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
itasca-mcp подключает агентов к программам геомеханического моделирования ITASCA: PFC (дискретные элементы), FLAC, 3DEC, MPoint и MassFlow. Агент листает документацию, запускает расчеты и выполняет код в разговоре. Семь инструментов делятся на две группы. Два инструмента документации листают дерево команд и ищут по ключевым словам в командах, Python API, FISH и справке выбранного движка (параметры `software` и `version`), мост для них не нужен. Пять инструментов выполнения дают интерактивный REPL, отправку задач, наблюдение за ходом, прерывание и историю, для них нужен запущенный мост. Мост `itasca_mcp_bridge` стартует внутри консоли IPython самой программы командой `itasca_mcp_bridge.start()` и перед запуском проверяет PyPI на новую версию. REPL работает рядом с идущим расчетом, поэтому, например, можно посмотреть неуравновешенную силу, не останавливая задачу. Агент видит и то, что вы делаете в графическом интерфейсе: запущенные ячейки, введенные команды, открытые графики и файлы данных.
Для кого. Инженерам-геотехникам и исследователям, которые моделируют грунты и породы в PFC, FLAC и 3DEC и хотят вести расчет в диалоге с агентом.
Подходит, если
- Нужно провести испытание плотного образца на двухосное сжатие и построить кривую напряжение–деформация
- В FLAC3D строят откос и находят коэффициент устойчивости
- Проходку тоннеля в трещиноватой породе моделируют в 3DEC и смотрят смещения блоков
- Агенту нужно сверить синтаксис команд `plot` с документацией перед построением силовых цепочек
Не подходит, если
- Движка ITASCA нет: сервер подключается к установленной лицензионной программе
- Нужна обычная Python-библиотека без GUI программы: мост запускают внутри консоли самой программы
- Расчет идет на кластере без графической среды: нужен запущенный мост в консоли
Пример запроса к агенту
Построй в FLAC3D модель откоса высотой 10 метров, найди коэффициент устойчивости и покажи схему смещений в проектеMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Ограничения
Нужны установленный движок ITASCA (рекомендуется версия 9.0 и новее, поддержаны также PFC 6.0 и 7.0, FLAC 7.0, 3DEC 7.0) и `uv`. Документация охватывает PFC 6.0, 7.0 и 9.0, FLAC 7.0 и 9.0, 3DEC 7.0 и 9.0. После каждого запуска движка мост запускают заново, конфигурация клиента сохраняется. Агент выполняет произвольный код внутри программы и пишет файлы проекта, поэтому такие расчеты стоит ограничить рабочим каталогом. Лицензия MIT, версия в реестре MCP 0.2.5.
Как отключить. Удалите блок itasca-mcp из конфигурации клиента (`claude mcp remove itasca-mcp`) и закройте мост, выйдя из консоли движка. Пакет подтягивается через `uvx` и отдельных файлов не оставляет.
Частые вопросы
Как подключить itasca-mcp к Claude Code?
Выполните `claude mcp add itasca-mcp -- uvx itasca-mcp`. Для Codex есть `codex mcp add itasca-mcp -- uvx itasca-mcp`, для Gemini CLI `gemini mcp add itasca-mcp uvx itasca-mcp`.
Что такое мост и зачем он нужен?
Файл `addon.py` запускают внутри консоли движка: он открывает программу для инструментов выполнения. Документация работает без моста, а REPL, отправка задач и мониторинг нет.
Можно ли выполнять код, пока идет расчет?
Да, REPL работает рядом с запущенной задачей: можно посмотреть состояние модели и промежуточные результаты, не останавливая ее. Для длинных расчетов отдельно есть отправка задач, слежение и прерывание.
Какие версии движков поддержаны?
Документация охватывает PFC 6.0, 7.0 и 9.0, FLAC 7.0 и 9.0, а также 3DEC 7.0 и 9.0. Рекомендуется версия 9.0 и новее.
Нужен ли агентный запуск моста?
Необязательно: агент может запустить мост сам через `console.exe` движка, либо вы запускаете его вручную каждый сеанс командой `itasca_mcp_bridge.start()`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыFreeCAD MCP — ИИ-агент в параметрическом CAD
FreeCAD MCP (blwfish)
MCP-мост между агентом и FreeCAD: 41 инструмент для параметрических деталей, CAM-траекторий, сеток и диагностики модели
MCP-сервер для IFC: агент считает элементы здания, проверяет модель по IDS, ищет коллизии и правит свойства
MCP-сервер с 98 инструментами ведет CATIA V5 через COM: эскизы, твердотельные модели, сборки, измерения и экспорт в STEP.
MCP-сервер индексирует код через tree-sitter: агент читает отдельные символы вместо файлов, находит пути, оценивает влияние правок
Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации
MCP-сервер строит граф зависимостей репозитория и документацию, а инструмент codebase-qna отвечает агенту на вопросы о коде
Коротко о README
Текст представляет сервер как подключение агентов к программам ITASCA: документация, запуск моделей и выполнение кода в диалоге, затем перечисляет семь инструментов и примеры запросов. Дальше идут требования, агентная и ручная настройка, запуск моста, ежедневный старт, возможности и ссылки на руководство по неполадкам.