MCP Server Govbox

MCP服务器管理箱

模型上下文协议 （MCP） 服务器，旨在促进大语言模型 （LLM） 和 Govbox 项目 Rakefile 任务之间的集成。

📋 关于项目

该服务器充当LLM和Rake命令之间的桥梁，允许语言模型以安全和可控的方式执行自动化任务。该项目旨在简化Rake命令的执行，使其无需事先了解特定命令即可访问。

🎯 目标

主要目标是使LLM能够：

• 以可编程方式执行 Rakefile 任务
• 自动化常见进程
• 减少对 Rake 命令的特定知识需求
• 提供执行任务的标准化接口

🚀 功能

• 安全可控的任务执行
• 支持多个项目
• 结果同步返回
• 强大的错误处理

🛠️ 使用的技术

• Go （Golang） 到 MCP 服务器
• Ruby/Rake 任务执行
• Docker 容器

⚙️ 安装和配置

📦 步骤 1: 获取代码

• #### 克隆仓库

git clone https://github.com/giovanoh/mcp-server-govbox.git
cd mcp-server-govbox

🔨 Passo 2：构建

• #### 使用Docker

docker build -t mcp-server-govbox .

• #### 在本地运行

go build cmd/app/main.go

🔧 步骤 3：设置服务器

服务器使用环境变量进行配置。所有的环境变量都必须配置为服务器正常工作。首先：

cp .env.example .env
# Edite o arquivo .env com suas configurações

需要以下环境变量：

• MCP_GOVBOX_PROJECT_PATHGovbox 项目目录路径
• MCP_SHELL_PATH: 用于执行命令的 shell （例如 /bin/zsh）
• MCP_SHELL_OPTIONS: 额外的 shell 参数 （例如： -c）

重要说明： .env 文件必须位于调用服务器的客户端项目的根文件夹中。例如：

• 如果您在 Windows 上使用 Claude Desktop，则该文件应保存在： C:\Users\\AppData\Local\AnthropicClaude\app-\.env
• 如果您正在使用自己的客户端，请将.env 放在客户端的根文件夹中

在启动服务器之前，请确保在 .env 文件中正确配置了所有变量。

🔧 步骤 4: 客户端设置

要将此服务器与 Claude Desktop 应用程序作为客户端使用，请调整您的文件配置 claude_desktop_config.json 根据例子：

与 Docker 一起使用

{
    "mcpServers": {
        "mcp-server-govbox": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "mcp-server-govbox:latest"
            ]
        }
    }
}

直接使用可执行文件

{
    "mcpServers": {
        "mcp-server-govbox": {
            "command": "/path/to/executable"
        }
    }
}

对于其他客户端，请复制所需的配置，并根据您的 LLM 客户端使用的模板进行配置。

# Usando Docker
cp config_docker_example.json config.json
# OU para executável
cp config_executable_example.json config.json

❌ 可能的错误

在服务器运行期间，可能会发生一些错误，并将返回给客户端。以下是可能的错误及其原因：

初始化错误

• "Error loading .env file":

- 当 .env 文件未找到时发生 - 或者当有权限读取文件的问题 - 或者当文件格式错误

• "Invalid shell configuration":

- 当 shell 环境变量不正确或不存在时发生 - 可能的原因： - MCP_GOVBOX_PROJECT_PATH 未定义或为空 - MCP_SHELL_PATH 未定义或为空 - 指定的 shell 在系统中不存在

校验错误

• "Param 'projects' must be a string":

- 当请求中未提供“ projects” 参数时发生 - 或者当给定的值不是一个有效的字符串

执行错误

• "Error during command execution (start)":

- 启动命令时出现问题 - 可能的原因： 权限不足、 找不到 shell、 设置错误的环境变量

• "Error during command execution (wait)":

- 当执行命令时出现问题时发生 - 可能的原因：命令突然中断，系统资源问题

• "Error creating stdout/stderr pipe":

- 当服务器无法创建管道以捕获命令输出时发生 - 可能的原因：权限问题，操作系统限制受到影响

如何解决

1. 检查 .env 文件中的所有环境变量是否正确配置
2. 确保 .env 文件位于正确的位置
3. 检查用户是否拥有适当的权限：

- 读取 .env 文件 - 运行配置的 shell - 访问 Govbox 项目目录

1. 确认配置的 shell 是否存在并且可以访问
2. 检查 Govbox 工程路径是否正确
3. 请检查服务器日志以了解有关错误的详细信息

📝 许可证

这个项目是根据许可证 MIT 学士.