enbuild-mcp-server

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:

Flag	Env Var	Description	Default
-base-url	ENBUILD_BASE_URL	Base URL for ENBUILD	https://enbuild.vivplatform.io
-username	ENBUILD_USERNAME	Username for ENBUILD
-password	ENBUILD_PASSWORD	Password for ENBUILD
-transport		Transport type: stdio or sse	stdio
-sse-address		Host:port for SSE server	:8080
-log-level		Log level: debug, info, warn, error	info
-debug		Enable debug mode	false

---

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.