Zabob: The AI Bridge to Houdini Magic

June 9, 2025 ยท View on GitHub

Features

  • ๐Ÿ”— Connects Claude, Copilot, and other MCP-aware chat interfaces to Houdini knowledge
  • ๐Ÿณ Multi-architecture Docker support (Intel x86_64 and ARM64)
  • ๐ŸŽฏ Easy setup with pre-built Docker images
  • ๐Ÿ“š Access to Houdini documentation and node information
  • ๐Ÿ› ๏ธ Extensible MCP server architecture
  • ๐Ÿง  Detailed knowledge of Houdini SFX environment

Zabob in front of a future city

This is a bridge from Copilot in VS Code, or any MCP-capable client, to knowledge about Houdini and Houdini networks.

Quick Start ๐Ÿš€

Want to use Zabob with Claude or another AI assistant right now?

๐Ÿ‘‰ Follow our Docker setup guide

Just add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "zabob": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "bobkerns/mcp-server:latest"]
    }
  }
}

Then configure your AI assistant to connect to the MCP server. Full instructions in the user documentation.

Features

  • ๐Ÿ”— Connects Claude, Copilot, and other MCP-aware chat interfaces to Houdini knowledge
  • ๐Ÿณ Multi-architecture Docker support (Intel x86_64 and ARM64)
  • ๐ŸŽฏ Easy setup with pre-built Docker images
  • ๐Ÿ“š Access to Houdini documentation and node information
  • ๐Ÿ› ๏ธ Extensible MCP server architecture

Requirements

If you have any requirements or dependencies, add a section describing those and how to install and configure them.

Extension Settings

TODO: Include if your extension adds any VS Code settings through the contributes.configuration extension point.

For example:

This extension contributes the following settings:

[TBD]

  • myExtension.enable: Enable/disable this extension.
  • myExtension.thing: Set to blah to do something.

Known Issues

Need to return real data...

Release Notes

See CHANGELOG.md for release notes


Following extension guidelines

Ensure that you've read through the extensions guidelines and follow the best practices for creating your extension.

Working with Markdown

You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:

  • Split the editor (Cmd+\ on macOS or Ctrl+\ on Windows and Linux).
  • Toggle preview (Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux).
  • Press Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets.

For more information

Enjoy!

Development

This is still in early-stage development, but you can read the development plan and details about how the development environment works.

Contributions are encouraged! You can read the contribution policy and the Code of Conduct

Subprojects

This project is divided into subprojects. As a result, the VSCode explorer view does not exactly match the structure of the file system. For example, the houdini/ folder holds multiple Houdini connection projects; these are presented in the explorer as being at top level, siblings to the root of the project.

In addition, I have enabled collapsing multiple related files into a single collapsed entry. The top-level README.md can be expanded to reveal the various top-level .md files, and packages.json displays the .lock file as a child. This helps minimize clutter in the explorer view.

Release Process

This will have the Release process when it's ready.

Security Policy

Here is the Security policy.

License

MIT License