MCP Server Govbox

🚀 MCP 服务器 Govbox

MCP 服务器 Govbox 是一个用于简化大型语言模型 (LLMs) 和 Rakefile 任务集成的工具。它作为两者之间的桥梁，让模型能够轻松执行自动化任务，降低了使用 Rake 命令的知识门槛。

🚀 快速开始

MCP 服务器 Govbox 作为 LLMs 和 Rake 命令之间的桥梁，可使模型执行自动化任务。以下是快速搭建该服务器的步骤。

第一步：获取代码

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

第二步：构建 Docker 镜像（可选）

# 使用一个基础的 Go 容器来构建 MCP 服务器
FROM golang:1.20 AS builder

WORKDIR /app

COPY go.mod .
RUN go mod tidy

COPY . .

CMD ["go", "run", "./main.go"]

# 创建一个轻量的基础镜像运行 MCP 服务器
FROM alpine:3.18

WORKDIR /app

COPY --from=builder /app/main .

EXPOSE 8080

CMD ["/app/main"]

第三步：启动服务器

# 在本地构建并运行
go run main.go

# 使用 Docker 运行（如果已构建镜像）
docker build -t mcp-server .
docker run -p 8080:8080 mcp-server

环境变量配置

在 main.go 同级目录创建 .env 文件：

echo "MCP_GOVBOX_PROJECT_PATH=/path/to/govbox-project" > .env
echo "MCP_SHELL_PATH=/bin/bash" >> .env

✨ 主要特性

• 安全受控的任务执行：保障任务执行过程的安全性和可控性。
• 支持多个项目：可同时为多个项目提供服务。
• 标准结果返回：统一返回结果的格式，便于处理。
• 强健的错误处理：能够有效处理各种初始化和运行时错误。

📦 安装指南

第一步：获取代码

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

第二步：构建 Docker 镜像（可选）

# 使用一个基础的 Go 容器来构建 MCP 服务器
FROM golang:1.20 AS builder

WORKDIR /app

COPY go.mod .
RUN go mod tidy

COPY . .

CMD ["go", "run", "./main.go"]

# 创建一个轻量的基础镜像运行 MCP 服务器
FROM alpine:3.18

WORKDIR /app

COPY --from=builder /app/main .

EXPOSE 8080

CMD ["/app/main"]

第三步：启动服务器

# 在本地构建并运行
go run main.go

# 使用 Docker 运行（如果已构建镜像）
docker build -t mcp-server .
docker run -p 8080:8080 mcp-server

环境变量配置

在 main.go 同级目录创建 .env 文件：

echo "MCP_GOVBOX_PROJECT_PATH=/path/to/govbox-project" > .env
echo "MCP_SHELL_PATH=/bin/bash" >> .env

📚 详细文档

项目概述

该服务器作为 LLMs 和 Rake 命令之间的桥梁，使模型能够执行自动化任务。该项目旨在降低使用 Rake 命令的知识门槛。

目标

主要目标是让 LLMs 能够：

• 执行 Rakefile 任务
• 自动化常见流程
• 减少对具体命令的了解需求
• 提供统一的任务执行接口

技术使用

🔧 技术细节

错误处理

初始化错误

• 无效shell配置：检查 .env 中的 MCP_SHELL_PATH 和 MCP_GOVBOX_PROJECT_PATH 是否正确。

运行时错误

• 任务执行失败：确保 Rake 命令有足够权限，并且 Govbox 项目路径存在。

📄 许可证

本项目使用 MIT License。