Add yade.mcpbridge: connect AI agents to a YADE simulation via the Model Context Protocol (MCP)

Yusong Hanrequested to merge
mcpbridge into master

Follow-up to !1171 (merged). In the !1171 (merged) discussion, adding the bridge to YADE trunk was suggested, so that users do not need to install the bridge separately. This MR adds the bridge as yade.mcpbridge, a pure Python package using only the standard library.

The bridge is opt-in. It starts only when the user asks for it. When it is not started, YADE behaves exactly as before.

The bridge code is vendored directly into py/, so it ships in precompiled packages with no extra build step.

Eight commits:

  • f9699835 — bridge code, brought in unchanged, exactly as tagged and tested in its own repository
  • 87435f75 — yapf3 formatting
  • b7c0a6f9 — CMake install rule
  • 3e8458ff — smoke test in py/tests
  • 95422015 — import-path adjustments
  • 3967efee — user documentation
  • 64e62e60 — ChangeLog entry
  • c065f390 — user documentation expanded: design and setup, with figures
Edited by Yusong Han

Merge request reports