yade-mcp

English | 简体中文

O.engines += [LLM()] # yet another engine.

yade-mcp подключает ИИ-агентов к YADE — движку для метода дискретных элементов с открытым исходным кодом — через Model Context Protocol. Просматривайте документацию API, запускайте симуляции и выполняйте код — всё это в ходе естественного общения.

Ваш агент не просто вызывает инструменты — он работает прямо в вашей консоли YADE, самостоятельно запускает длительные симуляции и остается в курсе того, что вы делаете.

Возможности

Агент печатает, YADE работает

Работает на базе yade_execute_code

Опишите, что вы хотите, простым языком. Агент вводит команды в вашу консоль YADE: проверяет частицы, настраивает параметры, выполняет шаги движка, анализирует результаты. Он считывает каждый вывод, отлаживает и повторяет действия точно так же, как вы делали бы это в консоли самостоятельно.

Запустите и занимайтесь своими делами

Работает на базе yade_execute_task + yade_check_task_status + yade_interrupt_task

Запускайте полноценный скрипт YADE как фоновую задачу — точно так же, как при выполнении yade script.py, только вам не нужно следить за процессом. Агент наблюдает самостоятельно: отслеживает вывод в реальном времени, перехватывает ошибки по мере их появления, корректно останавливает выполнение, если что-то идет не так, исправляет скрипт и перезапускает его — до тех пор, пока симуляция не завершится.

Новая сессия, без «холодного старта»

Работает на базе yade_list_tasks + yade_check_task_status

Каждая запущенная вами задача — скрипт, вывод в реальном времени, конечное состояние — сохраняется в истории. Когда контекстное окно заполняется или вы возвращаетесь на следующий день, новый агент приступает к проекту, который «помнит» себя: он перечисляет, что было запущено, считывает результаты каждой задачи и продолжает работу без необходимости объяснять всё заново.

Интерактивная оболочка для работающей симуляции

Работает на базе yade_execute_code

Пока задача выполняется, у агента есть интерактивная оболочка для доступа к симуляции — попросите его проверить любую переменную, выгрузить состояние любого объекта или построить график по запросу, не редактируя скрипт и не останавливая выполнение.

Вы печатаете, агент синхронизирован

Помимо отправленных задач, каждая строка, которую вы вводите в консоли YADE — переменные, которые вы просматривали, параметры, которые тестировали, тупиковые пути, от которых отказались — также попадает в контекст агента. Когда вы переходите к чату, у него уже есть история того, что вы пытались сделать. Изучаете YADE и хотите получить обратную связь по тому, что только что ввели? Застряли на неожиданной ошибке? Просто спросите — агент видел, что вы ввели и как ответил YADE.

Related MCP server: itasca-mcp

Инструменты (7)

Два инструмента для документации (без моста) и пять инструментов для выполнения (требуется мост):

Быстрый старт

Предварительные требования

• Установленный YADE

• Установленный uv (для uvx)

Настройка агента (рекомендуется)

Скопируйте это своему ИИ-агенту и позвольте ему настроиться самостоятельно:

Fetch and follow this bootstrap guide end-to-end:
https://raw.githubusercontent.com/yusong652/yade-mcp/master/docs/agentic/yade-mcp-bootstrap.md

Ручная настройка

1. Зарегистрируйте MCP-сервер в конфигурации вашего клиента:

{
  "mcpServers": {
    "yade-mcp": {
      "command": "uvx",
      "args": ["yade-mcp"]
    }
  }
}

2. Запустите мост внутри YADE:

pip install yade-mcp-bridge

Затем в консоли Python YADE:

import yade_mcp_bridge
yade_mcp_bridge.start()

Проверка

Перезапустите своего ИИ-агента (Claude Code, Codex CLI, Gemini CLI и т.д.) и попросите его вызвать yade_execute_code для проверки соединения.

Участие в разработке

См. CONTRIBUTING.md для настройки среды разработки и руководств.

Лицензия

MIT — см. LICENSE.