Daedalus MCP

Daedalus MCP is a local Model Context Protocol (MCP) server for creating and running specialized engineering agents per project or workspace.

It is designed for workspaces that may contain:

• a single backend service;

• several related microservices;

• a frontend + BFF + backend setup;

• a monorepo or folder with multiple related projects.

Daedalus scans the current workspace, detects the projects and their technologies, creates reusable agent templates, generates project-specific rules/knowledge, and lets you run sequential agent pipelines such as planning, rules validation, performance review, and architecture review.

Main idea

Given a workspace like:

workspace/
  catalog/
  data-mirror/
  vendors-bff/
  admin-ui/

Daedalus can detect stacks such as Java/Spring Boot or Angular and create:

workspace/
  .engineering-agents/
    workspace.agents.yaml

  catalog/
    agents.config.yaml
    agents/
      plan/
      rules/
      performance/
      architecture/

  admin-ui/
    agents.config.yaml
    agents/
      plan/
      rules/
      performance/
      architecture/

Reusable templates live inside this MCP project:

templates/
  java21-spring-boot-plan/
  typescript-angular-plan/
  project-rules-validator/
  performance-jvm/
  performance-web-node/
  architecture-microservice/
  architecture-frontend/

Daedalus does not overwrite existing files by default.

Related MCP server: Code-Oracle

Available MCP tools

daedalus_init

Scans the current workspace and initializes agents.

Equivalent slash-style command:

/daedalus init

What it does:

1. Detects the current workspace from MCP roots or cwd.

2. Finds projects inside the workspace.

3. Detects language, framework, build tool, package manager and architecture.

4. Creates missing reusable templates.

5. Creates agents.config.yaml and agents/ inside each detected project.

6. Creates workspace groups like all, java-all, angular-all, etc.

Options:

{
  workspacePath?: string,
  force?: boolean,
  refreshProjectKnowledge?: boolean,
  refreshTemplates?: boolean,
  maxDepth?: number
}

daedalus_listProjects

Lists projects detected by the last init.

Slash-style command:

/daedalus listProjects

daedalus_listGroups

Lists generated project groups.

Slash-style command:

/daedalus listGroups

Examples of groups:

all
java-all
java21-spring-boot-all
spring-boot-all
angular-all
typescript-all

daedalus_run

Runs an agent pipeline over a group or selected projects.

Slash-style examples:

/daedalus plan --group:java-all "agregar healthcheck estándar"

/daedalus plan --group:angular-all "agregar healthcheck estándar"

/daedalus plan --group:all "agregar healthcheck estándar"

/daedalus plan --project [catalog,data-mirror,vendors-bff] "agregar healthcheck estándar"

The report includes the response from every agent for every selected project.

Default plan pipeline:

plan -> rules -> performance -> architecture

daedalus

Convenience parser for slash-style commands.

Input example:

{
  "command": "/daedalus plan --group:java-all \"agregar healthcheck estándar\""
}

Legacy aliases agent and agent_init are also available, but /daedalus is preferred.

Installation from local checkout

1. Clone the repository

git clone https://github.com/daedalus/daedalus-mcp.git
cd daedalus-mcp

Replace the URL with the real repository URL if different.

2. Install dependencies

npm install

3. Build

npm run build

4. Link the local binary

npm link

This exposes:

daedalus-mcp

Verify:

which daedalus-mcp

If your MCP client does not inherit your shell PATH, use the absolute path returned by which daedalus-mcp.

Add to Codex

Edit:

~/.codex/config.toml

Add:

[mcp_servers.daedalus]
command = "daedalus-mcp"
startup_timeout_sec = 60

If Codex cannot find daedalus-mcp, use the absolute path:

[mcp_servers.daedalus]
command = "/absolute/path/to/daedalus-mcp"
startup_timeout_sec = 60

Restart Codex.

Add to Claude Desktop

Edit:

~/Library/Application Support/Claude/claude_desktop_config.json

Add the server inside mcpServers:

{
  "mcpServers": {
    "daedalus": {
      "command": "daedalus-mcp"
    }
  }
}

If Claude cannot find daedalus-mcp, use the absolute path:

{
  "mcpServers": {
    "daedalus": {
      "command": "/absolute/path/to/daedalus-mcp"
    }
  }
}

Restart Claude Desktop.

Prompt to install from another Codex/Claude chat

Once this project is published, you can open a new Codex or Claude chat and say something like:

Install the Daedalus MCP from https://github.com/daedalus/daedalus-mcp.
Clone it, run npm install, npm run build, npm link, and add it as an MCP server named daedalus using the daedalus-mcp command. Then restart or tell me to restart the client.

For Codex specifically:

Install the MCP server from https://github.com/daedalus/daedalus-mcp and add this to ~/.codex/config.toml:

[mcp_servers.daedalus]
command = "daedalus-mcp"
startup_timeout_sec = 60

For Claude Desktop specifically:

Install the MCP server from https://github.com/daedalus/daedalus-mcp and add it to ~/Library/Application Support/Claude/claude_desktop_config.json under mcpServers as:

"daedalus": {
  "command": "daedalus-mcp"
}

Typical usage

After adding the MCP server and restarting the client, open a chat in the target workspace and run:

Use Daedalus and run /daedalus init

Then inspect what was detected:

Use Daedalus and run /daedalus listProjects

Use Daedalus and run /daedalus listGroups

Run a plan for all Java projects:

Use Daedalus and run /daedalus plan --group:java-all "agregar healthcheck estándar"

Run a plan for specific projects:

Use Daedalus and run /daedalus plan --project [catalog,data-mirror,vendors-bff] "agregar healthcheck estándar"

Generated files

Workspace config

.engineering-agents/workspace.agents.yaml

Contains detected projects and groups.

Per-project config

agents.config.yaml

Contains project metadata, agents and pipelines.

Per-project agents

agents/
  plan/
    prompt.md
    agent.yaml
    knowledge/
      general/
      project/
  rules/
  performance/
  architecture/

Reusable templates

templates/

Templates are shared by technology/version/architecture and reused across projects.

Development

npm install
npm run build

Run directly:

npm start

Type-check:

npx tsc --noEmit

Notes

• Daedalus uses MCP roots/list when available to identify the workspace opened in the client.

• If roots are unavailable, it falls back to the process cwd.

• workspacePath can be provided manually as an override.

• Existing generated files are preserved by default.

• Pipeline execution uses MCP sampling when the host supports it; otherwise Daedalus returns a deterministic report with the prepared context.