MCP Server Govbox

Name: MCP Server Govbox
Author: giovanoh

@giovanoh

Repository

About MCP Server Govbox

Protótipo de servidor MCP em Go para utilização com LLMs na automatização de processos internos em Ruby/rake

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-govbox": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "mcp-server-govbox",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server Govbox?

MCP Server Govbox is a Model Context Protocol server that bridges large language models (LLMs) with Rake tasks from the Govbox project. It lets LLMs execute Rakefile commands safely and programmatically, without requiring knowledge of specific Rake commands.

How to use MCP Server Govbox?

Clone the repository, build using Docker (docker build -t mcp-server-govbox .) or Go (go build cmd/app/main.go), then configure the required environment variables (MCP_GOVBOX_PROJECT_PATH, MCP_SHELL_PATH, MCP_SHELL_OPTIONS) in a .env file placed in the client’s root folder. Finally, set up the MCP client (e.g., Claude Desktop) by adding the server configuration to its claude_desktop_config.json.

Key features of MCP Server Govbox

Safe and controlled execution of Rake tasks
Support for multiple projects
Standardized return of results
Robust error handling
Docker containerization for easy deployment

Use cases of MCP Server Govbox

Execute Rakefile tasks from LLMs without manual command knowledge
Automate repetitive Govbox project workflows
Provide a consistent interface for running Rake commands
Integrate Govbox automation into AI-assisted development tools

FAQ from MCP Server Govbox

What environment variables are required?

Three variables are mandatory: MCP_GOVBOX_PROJECT_PATH (path to the Govbox project), MCP_SHELL_PATH (e.g., /bin/zsh), and MCP_SHELL_OPTIONS (additional shell arguments, e.g., -c).

Where should the `.env` file be placed?

The .env file must be located in the root folder of the client that calls the server. For Claude Desktop on Windows, the path is C:\Users\<User>\AppData\Local\AnthropicClaude\app-<Version>\.env.

What causes the “Error loading .env file” message?

The .env file is missing, has permission issues, or is malformed. Ensure it exists in the correct location and is properly formatted.

What does “Invalid shell configuration” mean?

One or more required environment variables are missing, empty, or point to a nonexistent shell. Check that MCP_GOVBOX_PROJECT_PATH, MCP_SHELL_PATH, and MCP_SHELL_OPTIONS are correctly set.

How can I resolve command execution errors?

Verify that all environment variables are correct, the .env file is in place, the user has read/execute permissions for the shell and project directory, and the shell path points to an existing executable. Check server logs for details.