Director
MCP Playbooks for AI agents
What is Director?
Director is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp playbooks for ai agents
MCP Playbooks for AI agents
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Playbooks for AI agents
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx directorConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Director
Director is an MCP middleware and CLI that organizes tools, prompts, and MCP server connections into reusable 'playbooks' that can be switched on or off per agent session. Rather than hardcoding a fixed set of MCP servers into your client config, you create named playbooks with specific tool and prompt combinations, then connect or disconnect them to Claude, Cursor, or VS Code with a single command — enabling task-specific agent skill sets without editing JSON configs manually.
Prerequisites
- Node.js 18 or later installed
- npm or a compatible package manager
- Claude Desktop, Cursor, or VS Code with MCP support
- An MCP client capable of connecting to the Director gateway
Install the Director CLI globally
Install via the official install script or npm.
curl -LsSf https://director.run/install.sh | sh
# or via npm:
npm install -g @director.run/cliRun the quickstart wizard
The quickstart command walks you through initial setup and creates your first playbook.
director quickstartCreate a new playbook
Playbooks are named collections of MCP tools, prompts, and server connections. Create one for a specific workflow.
director create my-playbookAdd an MCP server or tool to the playbook
Add tools from any registered MCP server to the playbook using the --entry flag.
director add my-playbook --entry fetchConnect the playbook to your agent client
Wire the playbook into Claude Desktop, Cursor, or VS Code so those clients see the combined tool set.
director connect my-playbook --target claudeList and manage tools in the playbook
Inspect what tools are active in a playbook, call them directly from the CLI, or update the playbook as needed.
director env
director list-tools my-playbookDirector Examples
Client configuration
Claude Desktop entry that connects through the Director gateway server on its default port.
{
"mcpServers": {
"director": {
"command": "npx",
"args": ["director"]
}
}
}Prompts to try
Workflow commands once Director is connected and playbooks are configured.
- "List all available playbooks in Director."
- "Switch my agent to the 'research' playbook."
- "Show me the tools available in my current playbook."
- "Connect the 'coding' playbook to Cursor and disconnect the 'writing' one."
- "What prompts are defined in my active Director playbook?"Troubleshooting Director
director command not found after installation
Ensure the npm global bin directory is in your PATH. Run 'npm root -g' to find it, then add the parent bin/ folder to your shell's PATH variable.
Playbook connection to Claude Desktop does not appear
After running 'director connect my-playbook --target claude', restart Claude Desktop. Director modifies the client config file, so the app needs to reload it.
Port 3673 is already in use
Director's gateway defaults to port 3673. Change it by setting the port in the GatewayConfig, or kill the process occupying that port with 'lsof -ti:3673 | xargs kill'.
Frequently Asked Questions about Director
What is Director?
Director is a Model Context Protocol (MCP) server that mcp playbooks for ai agents It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Director?
Follow the installation instructions on the Director GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Director?
Director works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Director free to use?
Yes, Director is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
Director Alternatives — Similar Coding Agents Servers
Looking for alternatives to Director? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Director in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Director?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.