Repolode
Submit
fdmtl

fdmtl/director

A local-first gateway that bundles MCP tools, prompts and config into portable playbooks that AI agents can connect to through one endpoint.

View on GitHubWebsite
Stars
482
Forks
78
Open issues
5
Last commit
2 months ago

What is it?

Director is a service that sits between AI agents and MCP servers. It groups MCP tools, prompts and configuration into named playbooks, each of which can give an agent a specific set of capabilities for a task or environment. Clients such as Claude Desktop, Claude Code, Cursor and VSCode can be connected to a playbook in one click, or manually through a single MCP endpoint.

The project covers common MCP management needs: tool filtering so only the tools needed for a task are exposed, centralized JSON logging of agent activity, and unified OAuth so an OAuth-protected MCP server can be authenticated once and used across several agents. Playbooks can be authored in a web UI (`director studio`) or through the CLI, and the gateway runs on the user's own machine or infrastructure.

The repository is a TypeScript monorepo that includes the CLI, a TypeScript SDK for programmatic control, a Docker image, and a web studio. It is licensed under AGPL-3.0.

Key features

  • 01Group MCP tools, prompts and config into reusable playbooks.
  • 02One-click connection to Claude Desktop, Claude Code, Cursor and VSCode.
  • 03Expose all playbooks through a single MCP endpoint.
  • 04Filter tools per playbook to keep agent context small.
  • 05Centralized JSON logging of agent tool activity.
  • 06Unified OAuth for OAuth-protected MCP servers.

Use cases

  • Switching between different tool sets for coding, research or ops tasks.
  • Sharing one configured set of MCP servers across several AI clients.
  • Running MCP servers in a local or containerized environment with centralized authentication.

Quick start

  1. 1

    Install the director CLI via npm

    npm install -g @director.run/cli
  2. 2

    Start the gateway and onboarding flow

    director quickstart

Things to know

  • Licensed under AGPL-3.0, a copyleft license that requires derivative network services to share their source code.
  • One-click client integration currently supports only Claude Code, Claude Desktop, Cursor and VSCode.

Topics

#mcp#ai-agents#llm-tools#gateway#oauth#typescript#claude#cursor#mcp-client#mcp-gateway

FAQ

What is director?
A local-first gateway that bundles MCP tools, prompts and config into portable playbooks that AI agents can connect to through one endpoint. Director is a service that sits between AI agents and MCP servers. It groups MCP tools, prompts and configuration into named playbooks, each of which can give an agent a specific set of capabilities for a task or environment. Clients such as Claude Desktop, Claude Code, Cursor and VSCode can be connected to a playbook in one click, or manually through a single MCP endpoint.
Is director free to use? What license does it have?
director is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is director still maintained?
Updated within 6 months. The last commit to director was on Sep 3, 2026.
What can I use director for?
Switching between different tool sets for coding, research or ops tasks. Sharing one configured set of MCP servers across several AI clients. Running MCP servers in a local or containerized environment with centralized authentication.
How do I install director?
Install the director CLI via npm: npm install -g @director.run/cli Start the gateway and onboarding flow: director quickstart
Where can I get director?
The source code and installation instructions are on GitHub: https://github.com/fdmtl/director

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects