Build MCP Server

A Model Context Protocol (MCP) server that provides build and development tools for AI assistants. This server enables AI agents to run build commands, tests, linting, and manage dependencies in development projects.

Features

• Build Management: Run build commands with customizable parameters

• Test Execution: Execute test suites and report results

• Package Analysis: Read and analyze package.json files

• Dependency Management: Install dependencies using npm, yarn, or pnpm

• Code Linting: Run linting tools and report code quality issues

Related MCP server: Project Explorer MCP Server

Installation

From GitHub (Recommended)

Local Development

Configuration

Add this server to your MCP configuration file:

Or for local development:

Available Tools

run_build

Execute build commands in a project directory.

Parameters:

• command (string, optional): Build command to run (default: "npm run build")

• directory (string, optional): Directory to run the build in (default: current directory)

Example:

run_test

Execute test suites in a project directory.

Parameters:

• command (string, optional): Test command to run (default: "npm test")

• directory (string, optional): Directory to run tests in (default: current directory)

Example:

check_package_json

Analyze package.json files and extract key information.

Parameters:

• directory (string, optional): Directory containing package.json (default: current directory)

Example:

install_dependencies

Install project dependencies using various package managers.

Parameters:

• manager (string, optional): Package manager to use - npm, yarn, or pnpm (default: "npm")

• directory (string, optional): Directory to install dependencies in (default: current directory)

Example:

lint_code

Run code linting and quality checks.

Parameters:

• command (string, optional): Lint command to run (default: "npm run lint")

• directory (string, optional): Directory to run linting in (default: current directory)

Example:

Usage Examples

Once configured, you can use natural language to interact with the build server:

• "Build the project"

• "Run tests in the frontend directory"

• "Install dependencies using yarn"

• "Check what scripts are available in package.json"

• "Lint the code and show me any issues"

Error Handling

The server provides detailed error messages and output for all operations. Build failures, test errors, and linting issues are clearly reported with full context.

Security

This server executes shell commands in the specified directories. Ensure you trust the environment and commands being executed. The server includes timeout protections to prevent long-running processes.

Development

To contribute or modify the server:

License

MIT