yusong652/yade-mcp

Overview

An MCP server that connects AI agents to YADE, enabling discrete element method (DEM) simulations through natural language commands. It translates conversational requests into YADE script operations, allowing users to set up, run, and modify simulations without writing code directly.

Best for

Best for
Researchers or engineers who want to interact with YADE simulations through natural language rather than writing scripts.

Use cases

• Run DEM simulations by describing the setup in plain English
• Modify simulation parameters like particle size or material properties through chat
• Query simulation results or status without opening the YADE interface

How to use

Tools exposed

• yade_browse_api
• yade_query_api
• yade_execute_code
• yade_execute_task
• yade_check_task_status
• yade_interrupt_task
• yade_list_tasks

Tested with

Claude Code, Codex CLI, Gemini CLI, GitHub Copilot CLI, OpenCode, toyoura-nagisa

Example client config

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

Notes

An MCP server that connects AI agents to YADE, enabling discrete element method (DEM) simulations through natural language commands. It translates conversational requests into YADE script operations, allowing users to set up, run, and modify simulations without writing code directly.

9 stars on GitHub. Last updated 2026-06-01. Licensed MIT.

Use cases

• Run DEM simulations by describing the setup in plain English
• Modify simulation parameters like particle size or material properties through chat
• Query simulation results or status without opening the YADE interface

Pros

• Lowers the barrier to using YADE for non-programmers
• Enables rapid prototyping of simulation scenarios via conversation
• Leverages MCP standard for agent integration

Cons

• Limited to YADE’s existing capabilities and script interface
• Small user base (9 stars) suggests early-stage reliability risks
• Requires running both the MCP server and YADE environment

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.