Black Orchid FAQs

Question 1

What is Black Orchid?

Accepted Answer

Black Orchid is a hot-reloadable Python scripting engine accessible via an MCP (MUD Client Protocol) proxy server. It allows you to create and manage custom Python tools that can be dynamically loaded and executed without restarting the server.

Question 2

Can Black Orchid be used with systems other than Claude Code?

Accepted Answer

While primarily built for Claude Code, Black Orchid is designed to function with any other setup or client that supports an MCP server connection, offering flexibility for integrating your custom Python tools across various platforms.

Question 3

How do I create custom tools with Black Orchid?

Accepted Answer

To create custom tools, simply place Python files with your functions into the `modules/` or `private/modules/` folders. Black Orchid automatically discovers these, exposing each function as an MCP tool, and allows hot-reloading for immediate updates.

Question 4

Is Black Orchid secure for loading custom scripts?

Accepted Answer

Yes, Black Orchid prioritizes security by using `importlib` (not `exec`) for safe module loading, validating paths to prevent directory traversal, and performing syntax checks. Users are advised to only load modules they trust.

Question 5

What is MCP and how does Black Orchid utilize it?

Accepted Answer

MCP (MUD Client Protocol) is a standard for client-server communication. Black Orchid leverages an MCP proxy server to provide a standardized, hot-reloadable interface, making your custom Python tools easily accessible and integratable into MCP-compatible environments like Claude Code.

Black Orchid

About

Key Features

Use Cases