ENBUILD MCP Server

A Model Context Protocol (MCP) server for the ENBUILD Platform. Provides tools for managing ENBUILD catalogs and integrates with Amazon Q, VS Code, and other MCP-compatible clients.

Features

• List all ENBUILD catalogs for a given VCS (GITHUB or GITLAB)
• Fetch details for a specific catalog by ID
• Search catalogs by name, type, and VCS
• Supports stdio and SSE transports
• Easy integration with Amazon Q, VS Code, and other tools

Quickstart

Prerequisites

• Download the mcp-server-enbuild binary from the releases page.

Usage

Register with Amazon Q

# Stdio
q config add-mcp-server enbuild stdio

# SSE
q config add-mcp-server enbuild http://localhost:8080

VS Code Example

Add to your User Settings (JSON):

{
  "servers": {
    "enbuild": {
      "type": "stdio",
      "command": "/usr/local/bin/mcp-server-enbuild",
      "args": ["--base-url", "https://enbuild-dev.vivplatform.io"],
      "env": {
        "ENBUILD_BASE_URL": "https://enbuild-dev.vivplatform.io",
        "ENBUILD_USERNAME": "username",
        "ENBUILD_PASSWORD": "password"
      }
    }
  }
}

Claude Desktop Example

{
  "mcpServers": {
    "enbuild": {
      "type": "stdio",
      "command": "/usr/local/bin/mcp-server-enbuild",
      "args": ["--base-url", "https://enbuild-dev.vivplatform.io"],
      "env": {
        "ENBUILD_BASE_URL": "https://enbuild.vivplatform.io",
        "ENBUILD_USERNAME": "username",
        "ENBUILD_PASSWORD": "password"
      }
    }
  }
}

Tools

The following tools are provided:

• search_catalogs: List all catalogs for a specific VCS
• get_catalog_details: Get catalog details by ID

Example Usage

# List all catalogs for a specific VCS
enbuild search_catalogs --vcs "GITHUB"

# Get catalog details
enbuild get_catalog_details --id "catalog-id"

# Search for catalogs by name, type, and VCS
enbuild search_catalogs --name "terraform" --type "terraform" --vcs "GITHUB"

All tools return a consistent JSON response:

{
  "success": true,
  "message": "Successfully retrieved catalogs",
  "count": 5,
  "data": [
    {
      "id": "catalog-id",
      "name": "catalog-name",
      "type": "terraform",
      "vcs": "GITHUB",
      "slug": "catalog-slug"
    }
  ]
}

Development

To add new tools, update the registerTools function in mcpenbuild.go and implement the corresponding handler.

Build from Source

To build the project from source, ensure you have Go installed and run the following commands:

git clone https://github.com/vivsoftorg/mcp-server-enbuild.git
cd mcp-server-enbuild
go build -o mcp-server-enbuild

Run

Stdio (default)

./mcp-server-enbuild


#### SSE (HTTP)

```bash
./mcp-server-enbuild --transport sse --sse-address :8080

Configuration

You can configure the server using command-line flags or environment variables:

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open issues or pull requests on GitHub.