local-build-mcp

MCP stdio server for configured local build and test profiles.

This package does not run arbitrary shell text. It only runs profiles declared in a local YAML configuration file, validates parameters with regular expressions, blocks shell executables, captures output, truncates large output, and redacts common secret-like values.

Install

npm install -g @erivelto_muller/local-build-mcp

Run

local-build-mcp

The legacy binary alias agent-build is also included.

Configuration

Set LOCAL_AGENT_MCP_CONFIG to a YAML file:

security:
  allowed_roots:
    - /path/to/repository
repository:
  default_root: /path/to/repository
build:
  subprocess_timeout_seconds: 120
  system_executable_allowlist:
    - npm
  profiles:
    - name: test
      description: Run the project test suite.
      working_directory: .
      command: ["npm", "test"]
      project_markers: ["package.json"]

The safety boundary is intentionally hardcoded around configured profiles. There is no personal confirmation password because an agent that can edit config files could also weaken that password gate.

For remote or shared environments, prefer read-only repository tools and keep build profiles limited to disposable local workspaces.

Tools

• build_health
• list_build_profiles
• run_build_profile