conductor-mcp 0.1.5

MCP server for exposing conductor endpoints.

oss-conductor-mcp

Model Context Protocol server for Conductor.

Running the server

This project relies on uv https://docs.astral.sh/uv/getting-started/

Create venv (not entirely necessary, since uv automatically creates and uses the virtual environment on its own when running other commands)

uv sync
source .venv/bin/activate

Run Server

uv run server.py

---

For local development, a local_development.py file is provided for convenience for setting environment variables explicitly.

This is particularly useful where you don't have control over the environment, i.e. running in Claude.

    os.environ[CONDUCTOR_SERVER_URL] = 'https://developer.orkescloud.com/api'
    os.environ[CONDUCTOR_AUTH_KEY] = '<YOUR_APPLICATION_AUTH_KEY>'
    os.environ[CONDUCTOR_AUTH_SECRET] = '<YOUR_APPLICATION_SECRET_KEY>'

To run with local development add '--local_dev' to the server arguments:

uv run server.py --local_dev

Note: the /api path is required as part of the CONDUCTOR_SERVER_URL for most applications

Adding to Claude

Follow this tutorial for adding the mcp server to claude, and use the following configuration, with or without the --local_dev argument:

{
  "mcpServers": {
    "conductor": {
      "command": "uv",
      "args": [
        "--directory",
        "/<YOUR ABSOLUTE PATH TO THE DIRECTORY CONTAINING server.py>",
        "run",
        "server.py",
        "--local_dev"
      ]
    }
  }
}

After adding this configuration, Claude must be restarted to pick up the new MCP server.

Note: alternatively you can use the absolute path to the project root and use 'conductor-mcp' instead of 'server.py'

Global install

If you installed the package globally, i.e. from pypi:

pip install conductor-mcp

then you can point to the system install in your Claude config, but first you must create a json config file for your conductor values:

{
  "CONDUCTOR_SERVER_URL": "https://developer.orkescloud.com/api",
  "CONDUCTOR_AUTH_KEY": "<YOUR_APPLICATION_AUTH_KEY>",
  "CONDUCTOR_AUTH_SECRET": "<YOUR_APPLICATION_SECRET_KEY>"
}

Claude config:

{
  "mcpServers": {
    "conductor": {
      "command": "conductor-mcp",
      "args": [
        "--config",
        "<ABSOLUTE PATH TO A JSON CONFIG FILE>"
      ]
    }
  }
}

You can also start the server from the command line on its own after installing through pip:

conductor-mcp --config YOUR_CONFIG_FILE

Adding to Cursor

The main Cursor instructions are here. Go to Cursor -> Settings -> Cursor Settings -> MCP and select "+ Add new global MCP server".

Here you can add the exact same configuration file shown in the example for Claude (above). You can then access the AI chat feature and explore the MCP server in the sidebar with ⌘+L (Mac) or Ctrl+L (Windows/Linux).