agent-bridges

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 9 GitHub stars
Code Fail
  • exec() — Shell command execution in blender/blender_addon/blender_bridge.py
  • exec() — Shell command execution in blender/test_bg.py
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

MCP bridges that let AI agents drive Blender, Rhino/Grasshopper, SketchUp and Power Automate Desktop on your own PC

README.md

agent-bridges

English ・ 繁體中文

📖 Step-by-step tutorial (Traditional Chinese): https://shao-en.com/blog/agent-bridges-guide.html — not sure how to set it up? Hand the article to Claude or ChatGPT and let it walk you through.

Local MCP bridges that let an AI agent (Claude Code or any MCP client) operate desktop software
running on your own Windows machine: take screenshots, inspect the document, run code inside the
application, model geometry, and verify the result visually.

Bridge Software Local port MCP server name Notes
blender/ Blender 3.4 127.0.0.1:9877 blender startup script inside Blender; runs bpy on the main thread
rhino/ Rhino 7 + Grasshopper 127.0.0.1:9878 rhino C# .rhp plug-in + IronPython scripts; 46 tools (rhino_*, gh_*)
sketchup/ SketchUp 2024 127.0.0.1:9876 sketchup Ruby extension; server is off by default, you start it from the menu
revit/ Revit 2024 127.0.0.1:9879 revit C# IExternalApplication add-in; runs C# snippets via the Revit API; 18 tools (revit_*), lengths in mm
power-automate/ Power Automate Desktop (PAD) none (UI Automation + local run logs) pad run desktop flows, read / write Robin scripts

Architecture

 AI agent (MCP client)                       other tools / scripts
        │  stdio (MCP)                               │  CLI
        ▼                                            ▼
 ┌──────────────────────────────────────────────────────────┐
 │  Python package  <name>_bridge   (venv in %USERPROFILE%) │
 │   mcp_server.py   cli.py   ──►   client.py (protocol)    │
 └───────────────────────────────┬──────────────────────────┘
                                 │ TCP, newline-delimited JSON, 127.0.0.1 only
                                 ▼
 ┌──────────────────────────────────────────────────────────┐
 │  Server running inside the application (plug-in/script)  │
 │  requests are queued and executed on the UI/main thread  │
 └──────────────────────────────────────────────────────────┘

Power Automate Desktop has no scripting socket, so pad-bridge drives PAD through Windows UI
Automation and reads PAD's local run logs instead.

Each bridge ships three things: a Python MCP server + CLI, the in-application server, and a
Claude skill (skill/<name>-control/) with workflow rules and code snippets.

Quick start

Requirements: Windows 10/11, Python 3.10+, the target application (see table).

# Rhino / Revit / SketchUp / Power Automate (PowerShell)
cd rhino            # or revit, sketchup, power-automate
powershell -ExecutionPolicy Bypass -File .\install.ps1
# slow PyPI? add:  -PipIndex https://your-mirror.example/simple

# Blender
cd blender
python install.py

The installers register the MCP server with Claude Code (claude mcp add --scope user ...) and
copy the skill to ~\.claude\skills\. For other MCP clients, see each bridge's mcp-examples\
folder (mcp-config.json is a generic mcpServers example). Restart the application and your MCP
client afterwards. Details, tool lists and troubleshooting are in each bridge's README.

Security design

  • Servers bind to 127.0.0.1 only; nothing is exposed to the LAN or internet. There is no
    authentication, so anyone who can run code on your machine can connect. Do not change the
    bind address or port-forward these ports.
  • Tools that run arbitrary code (*_eval_python, sketchup_eval_ruby, gh_eval_python, revit_eval_csharp) give the
    agent full control of the application (and, through the language runtime, of your user account).
    Enable the bridge only for agents you trust.
  • SketchUp's server is off by default and must be started by you from the menu.
  • The Revit server closes any connection whose first bytes are not JSON (e.g. an HTTP request a web
    page sends to 127.0.0.1), so a browser cannot smuggle a command in a request body.
  • Destructive file actions (overwrite, open/new with unsaved changes) require explicit
    confirm / overwrite flags. No bridge can close or kill the host application.
  • Model edits are wrapped in undo records where the host application supports it.

Repository layout

blender/  rhino/  revit/  sketchup/  power-automate/
  README.md, README.zh-TW.md     per-bridge docs
  install.(ps1|py), uninstall.ps1
  skill/                         Claude skill (SKILL.md + references)
  mcp-examples/                  config examples for MCP clients
  agent_client/ or <name>_bridge/   Python package (MCP server, CLI, client)
  tests/                         unit tests (fake TCP server)

Verify your download

Download agent-bridges-v1.0.0.zip and SHA256SUMS.txt from Releases (use the version you actually downloaded).

  1. Compare the checksum in PowerShell:

    Get-FileHash .\agent-bridges-v1.0.0.zip -Algorithm SHA256
    

    The Hash must match the string in SHA256SUMS.txt (letter case does not matter).

  2. Verify where it was built (needs GitHub CLI):

    gh attestation verify .\agent-bridges-v1.0.0.zip --repo shaoen901109/agent-bridges
    

    A successful result means GitHub Actions built this zip from this repository's source and it was not swapped along the way.

Commits marked Verified on GitHub are signed by the author.

Credits

Purpose Component License
MCP server framework Model Context Protocol Python SDK (mcp) MIT
Screenshot handling (optional) Pillow HPND
Windows UI automation (power-automate bridge) uiautomation Apache-2.0
Tests pytest MIT
Controlled applications (not included) Blender, Rhino / Grasshopper (McNeel), Revit (Autodesk), SketchUp (Trimble), Power Automate Desktop (Microsoft) see each vendor

Developed with the help of Claude Code (Anthropic).

Author

License

MIT

Reviews (0)

No results found